关注公众号“曹工不加班”，后续更新 skills 搭配 Clawdbot/Moltbot/OpenClaw 玩法～

全网最详细的 Clawdbot (Moltbot) 部署 + 飞书接入教程，交流群内已有近百位没有编程技术经验的同学跟着文档操作成功。

⚠️ 该项目部署在本地电脑有一定风险，有顾虑的先关闭此文档，如果部署使用出现财产损失责任自负，本文仅为知识分享，严禁转卖

⚠️ 部署方面遇到的问题请先翻阅部署问题排查

🔗 更多开源免费内容可以前往《Moltbot 学习手册》地址：https://yunyinghui.feishu.cn/wiki/Ru7PwG82qiDGo1kGMFZcxqpGnnf?from=from_copylink

硬件要求

软件环境

通用要求（所有部署方案都需要）

Node. js >= 22.0.0

npm （Node. js 自带）

国内大模型 API Key （智谱 GLM / Minimax / 月之暗面 / 千问等）

Git： 安装需要用到，Windows：https://github.com/git-for-windows/git/releases/download/v2.52.0.windows.1/Git-2.52.0-64-bit.exe ，Mac 用户终端执行命令 xcode-select --install ，Linux 玩家自己解决

获取智谱 GLM API Key（推荐）

访问智谱 AI 开放平台 https://www.bigmodel.cn/glm-coding?ic=KR9X5A7MSD

注册/登录账号

进入「API 密钥」页面

创建新的 API Key（建议创建专用 Key）

复制保存 API Key（格式类似：xxxxx.xxxxxxxxxxxxxxxx）

充值（最低 ¥10，支持支付宝/微信）

建议使用 Coding Plan，站起来蹬！

🚀 速来拼好模，智谱 GLM Coding 超值订阅，邀你一起薅羊毛！Claude Code、Cline 等 20+ 大编程工具无缝支持，“码力”全开，越拼越爽！立即开拼，享限时惊喜价！

链接：https://www.bigmodel.cn/glm-coding?ic=FKYWVHYWDJ

智谱的 Coding Plan 还是很划算的，最近已经限购了，想入手的可以蹲一波抢购～

其他模型

Minimax ：访问 Minimax 开放平台 https://www.minimaxi.com ，注册后获取 API Key 和 Group ID

月之暗面（Kimi） ：访问月之暗面开放平台 https://platform.moonshot.cn ，注册后获取 API Key

🎯部署方案一：macOS 本地部署

Step 1: 安装 Node. js

访问 Node.js 官网 https://nodejs.org

下载 macOS 安装包（根据芯片类型选择 22. x LTS 版本）

安装步骤如下：

最后一步输入系统登录密码即可安装完成

1. 打开终端，可以在 mac 右上角找到放大镜，搜索“终端”

node --version
npm --version

Step 2: 安装 Clawdbot

# 打开终端
# 全局安装最新版(完整复制第三行)
npm install -g clawdbot@latest --registry=https://registry.npmmirror.com

# 验证安装
clawdbot --version

✅ 安装完成！接下来请跳转到统一配置与使用章节。

🎯部署方案二：Windows 本地部署

Step 1: 安装 Node. js

访问 Node.js 官网 https://nodejs.org

下载 Windows 安装包（选择 22. x LTS 版本）

安装步骤如下

1. 打开命令提示符（CMD）或 PowerShell 验证：

node --version
npm --version

Step 2: 安装 Clawdbot

# 以管理员身份打开命令提示符或 PowerShell
# 全局安装最新版(完整复制第三行)
npm install -g clawdbot@latest --registry=https://registry.npmmirror.com

# 验证安装
clawdbot --version

⚠️ 注意： 如果遇到权限错误，请确保以管理员身份运行命令提示符。

✅ 安装完成！接下来请跳转到统一配置与使用章节。

🎯部署方案三：云服务器部署

⚠️适合程序员朋友尝试，非程序员朋友看上面的本地部署部分，云服务器环境即可

优势分析

✅ 7×24 运行 ：无需保持本地设备开机 ✅ 远程访问 ：随时随地通过浏览器访问 ✅ 成本可控 ：轻量服务器 ¥20-50/月 ✅ 独立运行 ：不占用本地资源

Step 1: 购买并配置服务器

1.1 准备服务器

找一个你熟悉的云服务商购买服务器，推荐 linux 系统

1.2 配置防火墙规则

进入服务器控制台：

进入「服务器示例」→「防火墙/安全组」

添加规则：

协议：TCP

端口： 22 （SSH）

来源：0.0.0.0/0

添加 Clawdbot 核心端口：

协议：TCP

端口： 18789 （Clawdbot Web Dashboard）

来源：0.0.0.0/0

1.3 连接到服务器

# 本地终端连接（macOS/Linux）
ssh root@你的公网IP

# Windows 使用 PowerShell 或 PuTTY 连接
# PowerShell:
ssh root@你的公网IP

# 首次连接需输入密码（在腾讯云控制台重置）

Step 2: 安装基础环境

# 更新系统
apt update && apt upgrade -y

# 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs

# 验证版本
node --version  # 应显示 v22.x.x
npm --version

Step 3: 安装 Clawdbot

# 全局安装(完整复制第二行)
npm install -g clawdbot@latest --registry=https://registry.npmmirror.com

# 验证安装
clawdbot --version

✅ 安装完成！接下来请跳转到统一配置与使用章节。

统一配置与使用

📌 说明： 无论你选择哪种部署方式（macOS、Windows 或腾讯云），配置和使用步骤都是相同的。

Step 1: 启动配置向导

macOS/Linux（腾讯云）：

# 启动向导并自动设置后台服务
clawdbot onboard --install-daemon

Windows:

# 以管理员身份运行
clawdbot onboard --install-daemon

这个命令会：

启动交互式配置向导

自动配置后台服务（macOS 使用 daemon，Windows 使用系统服务，Linux 配置 systemd）

设置开机自启动

Step 2: 跟随向导完成配置

下面是使用初始化命令来完成对 Moltbot 的配置，按照截图上的选项选择以后按回车键进行下一步配置

关键配置步骤：

忽略安全警告

配置模式

选择模型：

这边选择智谱作为示例

填写 API 配置：

• Provider Name: Z.AI

通信通道：

这块咱们先跳过，因为列表里都是国内不支持的聊天软件，如果你有对应的渠道，这个配置应该也难不倒你

⚠️ 重要： 暂时选择"暂不配置"，通过 Web Dashboard 使用即可。

配置 skills（技能）

云服务器可以选 Yes，在后续的列表中选择想用的技能，本地部署选择 No，后面有更方便的方法配置

Hooks 钩子（可选）：

网关自启动

这一步会自动完成，等待即可

选择对话方式

建议本地部署选择 Web UI，云服务器选择 TUI

完成向导后，Clawdbot 会自动在后台运行

Step 3: 访问 Web Dashboard

本地部署（macOS/Windows）：

输入下面的命令会自动使用系统默认浏览器打开 Web UI，如果没有打开，复制终端给出的完整 URL，粘贴到浏览器打开。

输入命令
clawdbot dashboard

云服务器部署：

云服务器也是运行下面的命令

clawdbot dashboard

⚠️ 注意细节：需要在安全组/防火墙放开 18789 端口，要访问 Web UI 的话，需要域名解析 + HTTPS 证书

另外服务器上还需要配置局域网可访问，否则无法成功访问

clawdbot config

选择 Gateway

端口默认 18789 不修改直接回车

选择 LAN 回车

后面三项都是默认值不要修改，回车即可

最后会提示更新到配置里了

再执行下面的命令重启网关：

clawdbot gateway restart

设置 AI 身份与初始偏好

为了让 Moltbot 更懂你，在 TUI/Web UI 的 Chat 页面中输入：

基础信息设置：「我的名字是曹铁柱，AI 自媒体博主，公众号是“曹工不加班”，偏好使用中文交流」。

初始技能开启：「启用文件管理、网页搜索技能」。

测试指令：「整理我的下载文件夹」。

若收到「已整理 247 个文件到 8 个分类」类似的内容，说明部署成功！

部署问题排查

🐛 npm error code 128

表现如图，如果有魔法上网，从上网工具复制环境变量粘贴到终端回车执行，再执行 Moltbot 安装命令

如果没有魔法上网可以尝试下面的步骤，每一行命令复制出来执行，不要全部复制一次执行：

git config --global url."https://".insteadOf ssh://git@

npm cache clean --force

git --version

npm config get proxy

npm config delete proxy

npm config delete https-proxy

上面这些命令执行完以后，再次执行安装 Moltbot 命令

🤖 Minimax 模型配置完不好使

Moltbot 默认是接入国外版的 BaseURL，需要手动配置成国内的 BaseURL，在终端输入以下命令

clawdbot config set models.providers.minimax.baseUrl "https://api.minimaxi.com/anthropic"

🐛 npm error code CERT_HAS_EXPIRED

可以暂时把 SSL 证书验证依赖关掉，在终端中执行下面的代码

npm config set strict-ssl false

📬接入飞书

1. 创建企业自建应用

访问飞书开放平台：https://open.feishu.cn/app?lang=zh-CN

点击「创建企业自建应用」

填写应用名称和描述

上传应用图标（可选）

2. 获取应用凭证

在「凭证与基础信息」页面复制以下信息：

3. 添加机器人能力

创建以后会自动跳转到应用的详情页

在应用详情页左侧菜单「添加应用能力」

选择「机器人」并添加

1. 等待添加完成

4. 配置权限

进入权限管理菜单页面，点击开通权限，在打开的面板中进行权限的添加

在「权限管理」中添加以下权限：

必需权限

可选权限（用于完整的功能）

添加方式：

点击「+ 添加权限」

搜索并勾选上述权限

点击「确定」

想要精细控制权限的按照这个步骤把上面 必须权限 都添加上

偷懒方法

想省事儿一点就是搜索 im: 开头的权限全勾选开通即可，再加一个 contact:user.base:readonly 权限单独开通

5. 配置事件订阅

⚠️ 重要： 必须先完成下方「Clawdbot 插件安装与配置」后再进行此步骤，否则会提示"应用未建立长连接"。

Clawdbot 插件安装与配置

步骤：

1. 进入「事件与回调」

1. 订阅方式选择「使用长连接」

点击「+ 添加事件」

在「消息与群组」分类中勾选：

1. 点击「确定」保存

消息接收说明

单聊场景 ：接收所有消息

群聊场景 ：默认仅接收 @ 机器人的消息

如需接收群聊所有消息：在「机器人」配置页勾选「接收群聊所有消息」

6. 回调配置

点击回调配置

点击订阅方式的小图标

选择长连接接受回调

7. 发布版本

⚠️ 重要： 所有配置修改必须通过「创建版本」并发布后才能生效。

1. 点击页面顶部「创建版本」

填写版本号（如：v1.0.0）和更新说明

点击「保存」

1. 保存以后会弹窗提示是否要发布，选择确认发布

1. 等待审核通过（小型企业通常立即通过），不勾选外部群使用是免审的，自己建的企业自己审核就行。

1. 安装飞书插件

尝试打开终端执行：

clawdbot plugins install @m1heng-clawd/feishu

网络环境好的可以直接安装成功

2. 配置连接参数

使用上方获取的 App ID 和 App Secret 执行以下命令：

# 配置 App ID
clawdbot config set channels.feishu.appId "cli_xxxxx"

# 配置 App Secret
clawdbot config set channels.feishu.appSecret "your_app_secret"

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

参数说明：

将 cli_xxxxx 替换为你的实际 App ID

将 your_app_secret 替换为你的实际 App Secret

确保使用双引号包裹凭证

3. 启动/重启服务

# 重启 Clawdbot 网关服务
clawdbot gateway restart

完成这几步以后回到飞书应用 第 4 步 完成后续配置

测试接入是否成功

单聊

在飞书中搜索刚才添加的应用名称，给机器人发个消息，能正常回复就是接入成功了，可以和它对话布置任务了。

群聊

可以把机器人添加到群聊中，@它，也可以响应你的需求，添加步骤如下

添加成功以后在群聊里@它，不@它的时候只会默默记录消息内容作为后续执行任务的上下文

这样整个飞书的接入就完成了，开始给它下达指令吧～

额外配置

在 Web UI 中可以对飞书机器人做进一步配置，比如只允许某个人使用机器人，只允许某个群使用机器人等等，建议对飞书生态不是很熟悉的同学在机器人可以正常回复消息的时候就不要改这边频道配置了
 

安装飞书插件失败看这里

如果遇到因为网络或者其他原因安装飞书插件失败的，按照下面的方法安装

Mac 打开终端输入下面的命令：

mkdir -p ~/. clawdbot/extensions && open ~/. clawdbot/extensions

Windows 根据打开的终端不同输入不同命令

CMD

mkdir "%USERPROFILE%\. clawdbot\extensions" & explorer "%USERPROFILE%\. clawdbot\extensions"

PowerShell

mkdir -Force ~\. clawdbot\extensions; ii ~\. clawdbot\extensions

上面的命令执行后会在 Moltbot 的配置文件夹内创建扩展（extensions）文件夹并且通过系统资源管理器打开这个文件夹，把下面的飞书插件源文件解压到扩展文件夹下。公众号回复“飞书插件”获取插件压缩包文件

然后执行插件的安装，新打开一个终端，定位到这个目录

Mac 这么操作可以进入到目录

Windows 在文件夹空白处按住 Shift +鼠标右键点击，从打开的菜单中选择一个和终端相关的选项

在指定的目录下打开终端后执行下面的命令安装依赖

npm install --registry=https://registry.npmmirror.com

安装完成以后再继续 2. 配置连接参数 的配置。

飞书接入疑难杂症

🐛 发送消息 Moltbot 没有回复

大概率是飞书应用配置漏了配置回调，查看 6.回调配置 完成配置再测试

结尾还是在提一句，不要太迷信 Moltbot，现在只能算一个新奇的玩具，可以让你了解 AI 现在发展到什么程度了，但是不要真的把你的工作和生活交给它，它捅了篓子收拾的是你～