Moltbot 助手在 Windows 10 上安装并连接飞书教程

📋 目录

• 前置要求
• 第一步：安装 Moltbot
• 第二步：配置模型
• 第三步：安装飞书插件
• 第四步：创建飞书应用
• 第五步：配置飞书应用权限
• 第六步：连接 Clawdbot 和飞书
• 第七步：开始使用
• 常见问题

---

前置要求

系统要求

• 操作系统： Windows 10 或更高版本
• 网络： 稳定的互联网连接
• Node.js： 版本 22 或更高（会自动安装）

所需资源

• 电脑管理员权限
• 飞书账号（企业或个人）
• 大模型 API Key（推荐使用智谱 GLM 4.7）

---

第一步：安装 Moltbot

方法一：使用 PowerShell（推荐）

1. 以管理员身份打开 PowerShell

   • 按 Win + X 键，选择"Windows PowerShell (管理员)"
   • 或在开始菜单搜索"PowerShell"，右键选择"以管理员身份运行"

2. 执行安装命令

   iwr -useb https://molt.bot/install.ps1 | iex
   

   💡 说明： 此命令会自动下载并安装 Node.js 22 及所有必需的依赖项

3. 等待安装完成

   安装过程大约需要 5-10 分钟，取决于网络速度。安装完成后会看到成功提示。

方法二：使用 CMD

1. 以管理员身份打开命令提示符

   • 按 Win + R，输入 cmd，按 Ctrl + Shift + Enter

2. 执行安装命令

   curl -fsSL https://molt.bot/install.cmd -o install.cmd && install.cmd && del install.cmd
   

3. 等待安装完成

验证安装

安装完成后，打开新的 PowerShell 窗口，执行以下命令验证：

clawdbot --version

如果显示版本号，说明安装成功。

---

第二步：配置模型

选择模型

推荐使用 智谱 GLM 4.7 模型，性价比高，支持中文。

获取 API Key

方案一：付费订阅（推荐）

1. 访问智谱 GLM Coding 订阅页面：

   https://www.bigmodel.cn/glm-coding?ic=JRGMDDGOH0
   

2. 选择合适的订阅计划：

   • GLM Coding Plan - 数小时内完成过去需要数周的开发工作

方案二：免费体验卡

如果还有免费体验卡，可以使用以下链接：

https://bigmodel.cn/activity/trial-card/DBJDPINWHS

⚠️ 注意： 免费体验卡数量有限，建议先试用再决定是否订阅

配置 Clawdbot

1. 初始化配置

   clawdbot onboard --install-daemon
   

2. 配置模型

   clawdbot config set model.default "zai/glm-4.7"
   clawdbot config set apikeys.zai "你的_API_KEY"
   

   将 你的_API_KEY 替换为实际获取到的 API Key。

3. 跳过其他配置

   • MCP：暂时跳过
   • 技能（Skills）：暂时跳过

4. 启动服务

   clawdbot gateway start
   

   确保服务正常运行。

---

第三步：安装飞书插件

安装插件

在 PowerShell 中执行以下命令：

clawdbot plugins install @m1heng-clawd/feishu

等待插件安装完成。

验证插件安装

clawdbot plugins list

确认 @m1heng-clawd/feishu 插件已安装。

---

第四步：创建飞书应用

1. 进入飞书开发者后台

访问飞书开放平台：

https://open.feishu.cn/app?lang=zh-CN

登录你的飞书账号。

2. 创建企业自建应用

1. 点击"创建应用"
2. 选择"企业自建应用"
3. 填写应用基本信息：
   • 应用名称： Clawdbot 助手（或其他你喜欢的名称）
   • 应用描述： 个人 AI 智能助理
   • 应用图标： 可以上传自定义图标或使用默认图标
4. 点击"创建"

3. 获取应用凭证

1. 进入应用详情页
2. 点击左侧菜单"凭证与基础信息"
3. 复制以下信息（后续会用到）：
   • App ID： 格式如 cli_xxxxx
   • App Secret： 一长串密钥

---

第五步：配置飞书应用权限

必需权限（基础功能）

进入"权限管理"页面，添加以下权限：

权限范围	权限类型	功能描述
contact:user.base:readonly	获取基础用户信息	User info
im:message	收发消息	Messaging
im:message.p2p_msg:readonly	读取机器人的私信消息	DM read
im:message.group_at_msg:readonly	接收群内@机器人的消息	Group @
im:message:send_as_bot	以机器人身份发送消息	Send as bot
im:resource	上传/下载图片/文件	Media upload/download

可选权限（全功能）

如果需要更多功能，可以添加以下权限：

权限范围	权限类型	功能描述	敏感度
im:message.group_msg	读取群内所有消息	Group read	🔴 高
im:message:readonly	获取消息历史记录	Read history	🟡 中
im:message:update	编辑/更新已发送的消息	Edit	🟡 中
im:message:recall	撤回已发送的消息	Recall	🟡 中
im:message.reactions:read	查看消息的互动反馈	Reactions	🟢 低

权限申请（如果是企业账号）

如果使用企业账号，部分敏感权限需要管理员审批：

• 进入"权限管理"
• 点击"申请权限"
• 填写申请理由
• 等待管理员审批

---

第六步：连接 Clawdbot 和飞书

配置 Clawdbot 连接飞书

在 PowerShell 中执行以下命令：

# 配置飞书 App ID
clawdbot config set channels.feishu.appId "你的_App_ID"

# 配置飞书 App Secret
clawdbot config set channels.feishu.appSecret "你的_App_Secret"

# 启用飞书频道
clawdbot config set channels.feishu.enabled true

替换以下内容：

• 你的_App_ID：第四步中获取的 App ID（如 cli_xxxxx）
• 你的_App_Secret：第四步中获取的 App Secret

重启服务

配置完成后，重启 Clawdbot 服务使配置生效：

clawdbot gateway restart

配置飞书事件回调（长连接模式）

1. 回到飞书开发者后台

   • 进入应用详情页
   • 点击左侧菜单"事件订阅"

2. 配置回调

   • 找到"回调配置"部分
   • 勾选"使用长连接接受回调"
   • 点击"保存并校验"

   ✅ 使用长连接模式无需配置公网域名，更简单方便

验证连接

在飞书中找到创建的机器人应用，发送一条消息：

你好

如果机器人回复，说明连接成功！

---

第七步：开始使用

基础对话

在飞书中直接 @ 机器人，开始对话：

@Clawdbot助手 今天天气怎么样？

功能示例

1. 文字创作

帮我写一封请假邮件

2. 代码生成

用Python写一个快速排序算法

3. 知识问答

解释一下什么是区块链

4. OCR 识别

• 发送一张图片
• 机器人会自动识别图片中的文字

5. 日程管理

帮我安排明天的工作计划

6. 信息查询

查询北京今天的新增病例数

7. 数据分析

帮我分析这个CSV文件的数据趋势

进阶功能

1. 语音对话

在飞书中按住说话按钮，直接与机器人语音对话。

2. 文件处理

• 发送 Word、PDF 等文件
• 机器人可以读取文件内容并回答问题

3. 网页抓取

帮我抓取这个网页的内容：https://example.com

4. 多轮对话

机器人支持上下文记忆，可以进行连续的多轮对话。

---

常见问题

Q1: 安装失败怎么办？

A:

1. 检查是否以管理员身份运行 PowerShell
2. 检查网络连接是否正常
3. 如果使用国内网络，可能需要配置代理
4. 尝试使用 CMD 方法安装

Q2: Clawdbot 启动失败？

A:

1. 检查端口 3000 是否被占用
2. 查看错误日志：

   clawdbot logs
   

3. 尝试重启：

   clawdbot gateway restart
   

Q3: 飞书机器人不回复？

A:

1. 检查 Clawdbot 服务是否正常运行：

   clawdbot gateway status
   

2. 检查飞书应用配置是否正确
3. 检查事件回调是否校验成功
4. 重启 Clawdbot 服务

Q4: 如何更换模型？

A:

1. 停止服务：

   clawdbot gateway stop
   

2. 修改配置：

   clawdbot config set model.default "新模型名称"
   

3. 重启服务：

   clawdbot gateway start
   

Q5: API Key 余额不足怎么办？

A:

1. 访问智谱控制台充值
2. 或使用其他模型（如 GPT-4、Claude 等）
3. 免费用户可以使用体验卡

Q6: 飞书权限申请被拒绝？

A:

1. 联系企业管理员说明使用场景
2. 只申请必需权限，避免申请敏感权限
3. 使用个人账号创建应用（部分权限无需审批）

Q7: 如何查看 Clawdbot 日志？

A:

# 查看实时日志
clawdbot logs

# 查看最近 100 行日志
clawdbot logs --tail 100

# 导出日志到文件
clawdbot logs > clawdbot.log

Q8: 如何卸载 Clawdbot？

A:

# 停止服务
clawdbot gateway stop

# 卸载
clawdbot uninstall

---

附录

相关链接

• Moltbot 官网： https://www.molt.bot/
• Clawdbot GitHub： https://github.com/clawdbot/clawdbot
• 飞书插件项目： https://github.com/m1heng/clawdbot-feishu
• 智谱 GLM Coding： https://www.bigmodel.cn/glm-coding?ic=JRGMDDGOH0
• 飞书开发者后台： https://open.feishu.cn/app?lang=zh-CN

支持的平台

• ✅ Windows 10/11
• ✅ macOS
• ✅ Linux (Ubuntu, CentOS, Debian)

支持的模型

• zai/glm-4.7（推荐）
• zai/gpt-4
• zai/claude-3-opus
• zai/claude-3-sonnet
• 其他模型（查看官方文档）

---

更新日志

• 2026-01-30： 初始版本发布

---

技术支持

如遇到问题，可以：

1. 查看本文档的"常见问题"部分
2. 访问项目 GitHub Issues
3. 联系智谱客服

---

祝使用愉快！🎉