前言

最近 Clawdbot（现在叫 Moltbot）在技术圈挺火的，刷推特、逛 V2EX、看 Hacker News 到处都能看到有人在讨论。

为什么火？因为这玩意儿挺有意思的——据说代码 100% 是 AI 写的，人类只负责提需求和做决策。某种程度上，它代表了一种理想的人机协作模式：人类当产品经理，AI 当程序员。

不过在你兴冲冲准备装之前，有几件事得先说清楚：

安全方面

• • 这东西会在你机器上执行命令，虽然有确认机制，但还是有风险
• • 别在你的主力工作机上跑，万一出问题你会很难受
• • 建议用虚拟机、Docker 容器或者云服务器来部署
• • 如果要给它 sudo 权限，想清楚再给，后面会讲怎么配

网络方面

• • 项目依赖一些国外的服务（npm 包、AI API 等）
• • 国内网络环境可能会遇到各种连接问题
• • 有条件的话，用海外服务器部署会省心很多

心理准备

• • 这是个开源项目，不是商业产品，遇到 bug 很正常
• • 文档可能跟不上代码更新，有些地方得自己摸索
• • 社区还在发展中，遇到问题可能得自己想办法

适合谁看：没接触过 Linux 也没关系，照着做就行

环境：Ubuntu 24.04（主要）/ macOS（顺带提一下）

耗时：30-60 分钟

注意：Moltbot 原名 Clawdbot，装完之后敲的命令是 clawdbot

第一章：Moltbot 是什么

1.1 简单说

Moltbot 是个开源项目，能把 Claude、GPT 这些大模型接到各种聊天软件里。装好之后，你在飞书、Telegram、Discord 里发消息，它就能回复你。

1.2 能干什么

1.3 大概是这么个结构

你的手机/电脑
    │
    ▼
┌─────────────────────────────┐
│  聊天软件（飞书/Telegram等）  │
└─────────────┬───────────────┘
              │
              ▼
┌─────────────────────────────┐
│      Moltbot Gateway        │  ← 要装的就是这个
│     （跑在你的服务器上）       │
└─────────────┬───────────────┘
              │
              ▼
┌─────────────────────────────┐
│   AI 模型（Claude/GPT等）    │  ← 需要 API Key
└─────────────────────────────┘

1.4 开始之前

• • 不需要会编程
• • 不需要懂 Linux，跟着敲命令就行
• • 需要有个 AI 模型的 API Key（Claude、GPT 或者国内的都行）

第二章：装之前的准备

2.1 看看系统版本

Ubuntu

打开终端（快捷键 Ctrl + Alt + T），敲：

lsb_release -a

确认是 Ubuntu 24.04 或更高。

macOS

打开终端，敲：

sw_vers

macOS 12.0 以上就行。

2.2 装个 curl

Ubuntu

sudo apt update
sudo apt install -y curl

说明：

• • sudo 是用管理员权限跑，会让你输密码
• • -y 是自动确认，不用一直按回车

macOS

自带 curl，不用装。

2.3 就这些

对，准备工作就装个 curl。后面的一键脚本会自动把 Node.js 这些依赖都装好。

第三章：安装和配置

3.1 一键安装

curl -fsSL https://molt.bot/install.sh | bash -s
如果卡住10分钟左右，重新再来一次。

装完之后，一定要刷新一下环境变量：

source ~/.bashrc

然后验证一下装好没：

clawdbot --version

注意：命令是 clawdbot，不是 moltbot

3.2 跑配置向导

clawdbot onboard --install-daemon

接下来会进入一个交互界面，一步步选就行。

3.3 向导每一步怎么选

第 1 步：安全提示

I understand this is powerful and inherently risky. Continue?
○ Yes / ● No

用方向键选 Yes，回车。这是告诉你这东西能执行命令、读写文件，让你确认知道风险。

第 2 步：选模式

○ QuickStart
○ Manual

选 QuickStart，回车。

第 3 步：选 AI 模型

○ OpenAI
○ Anthropic
○ Google
○ Qwen（通义千问）
○ Moonshot AI（Kimi）
○ Z.AI (GLM 4.7)（智谱）
○ Skip for now

你有哪家的 API Key 就选哪个。国内用户选 Qwen、Moonshot、Z.AI 都行。

第 4 步：认证方式（以 Qwen 为例）

○ Qwen OAuth
○ Back

选 Qwen OAuth，回车。

会自动打开浏览器，跳转到 chat.qwen.ai 的授权页面。登录你的 Qwen 账号，点 Confirm 确认授权。

授权成功后，终端会自动继续下一步。

第 5 步：选模型

○ qwen-portal/coder-model (Qwen Coder · ctx 125k · alias: qwen)
○ qwen-portal/vision-model (Qwen Vision · ctx 125k)
○ ...

选 qwen-portal/coder-model 就行，这是 Qwen Coder，125k 上下文，够用了。

第 6 步：配置技能

Configure skills now? (recommended)
● Yes / ○ No

选 Yes。

第 7 步：Homebrew

Show Homebrew install commands?
○ Yes / ● No

Ubuntu 用户选 No。Homebrew 是 macOS 用的。

第 8 步：包管理器

○ npm
○ pnpm
○ bun

选 npm，最稳。

第 9 步：技能依赖

○ apple-notes
○ apple-reminders
○ ...
○ Skip for now

移到 Skip for now，先按空格选中，再按回车。

这里容易踩坑：必须先按空格，再按回车。直接按回车会报错。

第 10 步：可选配置

都跳过，以后要用再配。

第 11 步：Hooks

○ boot-md
○ command-logger
○ session-memory
○ Skip for now

建议三个都选上：

方向键移动，空格选中，最后回车。

第 12 步：启动方式

○ Hatch in TUI (recommended)
○ Open the Web UI
○ Do this later

选 Hatch in TUI，直接在终端里开聊。

3.4 配置完成

看到这样的界面就说明成了：

Gateway: ws://127.0.0.1:18789
Status: idle
Model: anthropic/claude-haiku-4-5-20251001
Token: 0/200k (0%)

第四章：怎么用

4.1 启动方式

方式一：终端界面（推荐）

clawdbot tui

打开后直接打字就能聊。

方式二：后台服务

clawdbot gateway

启动后可以通过网页或者其他渠道访问。

4.2 常用命令

4.3 聊天时的命令

在对话界面里可以发这些：

第五章：接到飞书上

Clawdbot 默认没有飞书，要装个社区插件。

https://github.com/m1heng/clawdbot-feishu

5.1 整体流程

飞书后台                    服务器                     飞书后台
创建应用 ──────────────► 安装插件 ──────────────► 设置回调
获取密钥                    配置重启                    发布应用

5.2 创建飞书机器人

1. 打开飞书开放平台

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

2. 创建应用

点 创建应用 → 企业自建应用，填个名字和描述。

3. 加机器人能力

进 应用能力 → 添加应用能力，选 机器人，然后点上面的 创建版本。

5.3 配置权限

1. 导入权限

路径：权限管理 → 批量导入权限

把下面这段 JSON 复制进去：

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message:send_as_bot",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "im:resource",
      "im:message.group_msg",
      "im:message:readonly",
      "im:message:update",
      "im:message:recall",
      "im:message.reactions:read"
    ],
    "user": [
      "contact:user.base:readonly"
    ]
  }
}

2. 申请开通

导入后点 申请开通。

5.4 拿到密钥

路径：凭证与基础信息 → 应用凭证

记下这两个：

5.5 装飞书插件

回到服务器，跑：

clawdbot plugins install @m1heng-clawd/feishu

5.6 配置插件

把 cli_xxxxx 和 your_app_secret 换成你自己的：

clawdbot config set channels.feishu.appId "cli_a9f1a8b442e31bdc"
clawdbot config set channels.feishu.appSecret "r0xxK2wWmgbLfsrpKyCRyeSeegYvmooY"
clawdbot config set channels.feishu.enabled true
clawdbot config set channels.feishu.connectionMode "websocket"

5.7 重启服务

clawdbot gateway restart

5.8 设置飞书回调

重要：上面的步骤必须先做完，再来设置回调。

1. 配置回调方式

路径：事件与回调 → 回调配置 → 订阅方式

选 使用长连接接收回调，保存。

2. 配置事件订阅

路径：事件与回调 → 事件配置 → 订阅方式

选 使用长连接接收回调，保存。

3. 添加消息事件

路径：事件与回调 → 添加事件

选 消息与群组 → 接收消息 (im.message.receive_v1),消息已读->im.message.message_read_v1，用户修改是否接收机器人消息配置->im.message.bot_muted_v1

这步漏了的话，机器人收不到消息。

4. 发布

点上面的 创建版本 → 发布

5.9 试一下

现在可以：

1. 1. 在飞书里搜你的机器人名字，私聊它
2. 2. 把机器人拉到群里，@它 说话

5.10 其他配置（可选）

改完记得重启：

clawdbot gateway restart

第六章：遇到问题怎么办

问题 1：command not found

跑 clawdbot 说找不到命令。

解决：

source ~/.bashrc

问题 2：端口被占用

报错：

Gateway failed to start: gateway already running
Port 18789 is already in use

解决：

clawdbot gateway stop
clawdbot gateway

问题 3：发消息没反应

发了消息显示 (no output)。

可能原因：API Key 没存进去。

解决：

cat ~/.clawdbot/clawdbot.json

看看 models 里面有没有 apiKey。没有的话手动加上：

nano ~/.clawdbot/clawdbot.json

问题 4：网页打不开

浏览器访问显示 unauthorized: gateway token missing。

解决：

cat ~/.clawdbot/clawdbot.json | grep token

拿到 token 后，用这个地址访问：

http://127.0.0.1:18789?token=你的token

或者干脆用命令行：

clawdbot tui

问题 5：想换模型

clawdbot configure --section model

附录：文件位置

最后

装完了。回顾一下：

1. 1. 安装：curl -fsSL https://molt.bot/install.sh | bash -s
2. 2. 配置：clawdbot onboard --install-daemon
3. 3. 用：clawdbot tui

有问题先跑 clawdbot doctor 看看，或者 clawdbot logs 查日志。