Moltbot[Clawdbot] 小白部署指南（附带接入飞书机器人教程）

最新消息，由于某些原因，Clawdbot已经更名为Moltbot，官方仓库为：https://github.com/moltbot/moltbot

0x01 前言

这两天 Clawdbot 突然在技术圈刷屏了。作者 Peter 把它定义为“生活助理”，本质上就是把 WhatsApp 这样的聊天软件、Claude Code 强大的编程能力，以及你自己的本地运行环境打通了。

它之所以能引爆社区，不光是因为“代码 100% 由 AI 生成”的噱头，更在于它展现了一种理想的 “人机协作” 范式：Clawdbot 直接运行在你掌控的环境（本地服务器/电脑）中，拥有完整的操作权限和超长记忆。这意味着它是一个真正私有、数据不外流的 Personal Agent，交互却像跟同事聊微信一样简单。

不过，权限太高是一把双刃剑。 目前社区的一致共识是：千万别在主力生产力电脑上“裸奔”。为了数据安全，强烈建议把它部署在强隔离的环境下，比如闲置的 Mac 或者 Linux 云服务器。

0x02 安装 Clawdbot

PS：目前 Windows 支持还很弱，且依某些依赖海外社交软件接口，国内折腾门槛不低，大家量力而行。推荐使用海外节点进行部署。

使用 NPM 安装 Clawdbot

这是最快的上手方式，适合在个人快速上手体验。
安装之前需要有大模型供应商，我这边选的是智谱GLM，你也可以点此注册智谱开放平台账号，点此链接注册的新用户赠送 2000 万 Token 额度。注册完成后，获取 API Key：在个人中心页面，点击 API Keys，创建一个新的 API Key，然后在后续安装Clawdbot的时候填入这个key就行了。

# 0前置条件，确保你已经安装了 Node.js (https://nodejs.org/en/download/ "Node.js") >= 22 ，通过`node --version`查看版本。
myluzh@myluzhMacBookPro ~ % node --version
v22.22.0

# 1安装
myluzh@myluzhMacBookPro ~ % npm install -g clawdbot@latest
added 674 packages in 1m

# 2初始化与配置 运行引导程序，它会帮助你配置 API Key 和所需的适配器（Adapter）
myluzh@myluzhMacBookPro ~ % clawdbot onboard --install-daemon
◇  I understand this is powerful and inherently risky. Continue?
│  Yes # 选择yes
◇  Onboarding mode
│  QuickStart #选择QuickStart
◇  Model/auth provider
│  Z.AI (GLM 4.7) # 我这里配置的模型提供商是智谱GLM
│
◇  Z.AI (GLM 4.7) auth method 
│  Z.AI (GLM 4.7) API key # 选择API key认证
│
◇  Enter Z.AI API key
│  8406c22xxxxxxxxxxxxxhXXBXRNQ  # 填写你的API key
│
◇  Model configured ─────────────────╮
│                                    │
│  Default model set to zai/glm-4.7  │
│                                    │
├────────────────────────────────────╯
│
◇  Configure skills now? (recommended)
│  # 选择你要的skll技能包，我这边选的是1password：密码管理 | nano-pdf：PDF 处理 | summarize：文本摘要 | model-usage：模型使用统计
│  # 你也可以直接跳过（选 No），后续可以到图形界面设置。
│
◇  Enable hooks? 
│  # Hooks（钩子） 设置，简单来说，它就是一种“自动化触发器”。 它的作用是：当你给 AI 下达某个指令时，系统会自动帮你执行另一个预设好的动作。
│  # boot-md启动时显示欢迎/引导信息，command-logger 记录你执行的所有命令，session-memory保存会话记忆，支持断点续聊。
│  🚀 boot-md, 📝 command-logger, 💾 session-memory 
│
│  # 安装完成：)
◇  Control UI ───────────────────────────────────────────────────────────────────────────────╮
│                                                                                            │
│  Web UI: http://127.0.0.1:18789/                                                           │
│  Web UI (with token):                                                                      │
│  http://127.0.0.1:18789/?token=b6a81e234f41d91d1ee14be08b82dab9d2171b649ebd8d8e            │
│  Gateway WS: ws://127.0.0.1:18789                                                          │
│  Gateway: not detected (gateway closed (1006 abnormal closure (no close frame)): no close  │
│  reason)                                                                                   │
│  Docs: https://docs.clawd.bot/web/control-ui                                               │
│                                                                                            │
├────────────────────────────────────────────────────────────────────────────────────────────╯
◇  Dashboard ready ────────────────────────────────────────────────────────────────╮
│                                                                                  │
│  Dashboard link (with token):                                                    │
│  http://127.0.0.1:18789/?token=b6a81e234f41d91d1ee14be08b82dab9d2171b649ebd8d8e  │
│  Opened in your browser. Keep that tab to control Clawdbot.                      │
│                                                                                  │
├──────────────────────────────────────────────────────────────────────────────────╯

# 3启动服务 配置完成后，启动 Clawdbot：
clawdbot start

完成安装后，你就可以打开Web UI http://127.0.0.1:18789/?token=your_login_token 进行测试对话了。

最后我想说的是，你如果觉得GLM大模型好用，配合上你的Moltbot拥有了私人助手，那么可以考虑购买GLM订阅，因为实在是太便宜了，优惠就剩最后一周了，我已经购买了 GLM 订阅套餐，我也推荐你购买。性价比实在是太高了。而且套餐内就算最低的用量，基本上也用不完，量大管饱还便宜！GLM 订阅计划 优惠 20%，只剩最后一周！还没买的抓紧了！

0x03 聊天软件（channel）配置

Clawdbot官方支持的一些聊天软件可以参考官方手册：https://docs.clawd.bot/channels

配置飞书机器人（推荐）

Clawdbot 默认不内置飞书 Channel，需要额外安装插件，社区已经有小伙伴实现并开源 项目地址： https://github.com/m1heng/clawdbot-feishu 。
下面我就教大家怎么一步步配置，配置会有点繁琐，耐心点按照我写的一步步进行下去。

  flowchart LR                                                                                                          
      Start([开始]) --> Feishu1[飞书后台<br/>创建应用/配置/获取密钥]                                                    
      Feishu1 --> Server[服务器<br/>安装插件/配置/重启]                                                                 
      Server --> Feishu2[飞书后台<br/>设置 Callback]                                                                    
      Feishu2 --> End([完成])                                                                                           

      style Feishu1 fill:#00D6B9                                                                                        
      style Server fill:#6366F1                                                                                         
      style Feishu2 fill:#00D6B9    

创建飞书机器人

1、进入飞书应用中心
飞书开放平台：https://open.feishu.cn/app?lang=zh-CN
2、新建企业自建应用
路径： 创建应用 → 企业自建应用；基础信息按提示填写即可（名称、描述等），完成创建后进入应用详情页。
路径： 应用能力 → 添加应用能力；添加机器人，完成后点击上方的 创建版本。

配置飞书机器人应用权限

路径：权限管理 → 批量导入权限；直接把下面的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"
      ]
    }
  }

获取飞书机器人调用密钥

路径：凭证与基础信息 → 应用凭证 ，将机器人的 App ID / App Secret 保存下来等下有用。

Clawdbot 安装飞书插件

# 在 Clawdbot 运行的服务器中运行命令安装feishu插件
clawdbot plugins install @m1heng-clawd/feishu

Clawdbot 更新配置

# appId、appSecret 需要在 飞书应用后台获取，填入你自己的
clawdbot config set channels.feishu.appId "cli_xxxxx" 
clawdbot config set channels.feishu.appSecret "your_app_secret" 
clawdbot config set channels.feishu.enabled true 
clawdbot config set channels.feishu.connectionMode "websocket"

Clawdbot 重载

clawdbot gateway restart

设置飞书机器人Callback

一定要完成上面的步骤，最后完成这一步，要不然会提示“应用未建立长连接”。
路径：事件与回调 → 回调配置 → 定阅方式；使用长连接接受回调，然后点击保存。
路径：事件与回调 → 事件配置 → 定阅方式；使用长连接接受回调，然后点击保存。
路径：事件与回调 → 添加事件；然后选择 消息与群组 里面的 接收消息（im.message.receive_v1），缺了这一步，你给机器人发消息会没有回复。
完成后，点击上面的创建版本，发布。

现在，你就可以跟飞书机器人私聊，或者把他拉到某个群聊@它了。

插件其他参数（非必须）

示例：

# 1. 切换到 Webhook 模式
clawdbot config set channels.feishu.connectionMode "webhook"
# 2. 设置群组策略为开放
clawdbot config set channels.feishu.groupPolicy "open"
# 改完后记得重启网关
clawdbot gateway restart

0x04 ~/clawd 目录介绍

# 进入clawd目录
myluzh@myluzhMacBookPro ~ % cd ~/clawd/ 
myluzh@myluzhMacBookPro clawd % tree
.
  ├── AGENTS.md              # 主操作手册：会话启动流程、记忆管理、群聊规则
  ├── BOOTSTRAP.md           # 初始化脚本（首次对话后可删除）
  ├── canvas
  │   └── index.html         # 交互式测试页面（iOS/Android 桥接）
  ├── HEARTBEAT.md           # 周期性任务清单
  ├── IDENTITY.md            # 助手身份卡：这里你可以定义你助手的名称，风格之类的
  ├── memory                   # 会话日志
  ├── SOUL.md                # 核心行为准则：价值观、边界、个性指南
  ├── TOOLS.md               # 本地配置备忘录：相机、SSH、TTS等
  └── USER.md                # 用户档案

0x05 导入自定义skills

技能默认路径
 cd ~/.nvm/versions/node/${$(node --version)}/lib/node_modules/clawdbot/skills/ 

**是否可以修改：**

可以，但需要分情况：

1. **默认路径（全局安装）** - 这是 npm 全局安装时的默认路径，通常不建议直接修改

2. **添加额外技能目录** - 可以在配置中添加：

   skills.load.extraDirs: ["/自定义路径/skills"]

3. **使用 workspace 技能** - 可以在你的工作区(`.clawd/skills/`)创建技能，不需要修改全局路径