Clawdbot 在智星云 Windows 环境中部署及飞书对接应用教程

Clawdbot 已更名 Moltbot。

前言

本教程包含以下内容：

注意事项
本地部署教程
对接飞书文档实现应用

经过 48 小时的摸索，基本上能遇到的问题我都遇到了。这里不仅教大家怎么安装，还有常见问题解答。

关于 Moltbot

Moltbot 原名 Clawdbot，是一款可运行在个人环境中的高权限 AI 智能体，支持通过 WhatsApp、飞书、Telegram 等常用聊天软件交互，能实现邮件发送、日程管理、数据查询等自动化任务，且数据隐私自主可控，搭配云服务器可实现 7×24 小时无间断运行。

⚠️ 重要声明

这玩意权限很高，一定要悠着点。 这里提醒大家一定注意数据风险问题：

如无必要，不要在自己的主力机安装
一定一定要用：备用机 / 虚拟机 / 云服务器

如果你直接在你的主力机上跑，万一 AI 抽风执行个 rm -rf /，你电脑里的那点隐私和学习资料可全完了。

因市面上教程大都是使用 Mac 笔记本做的，相信很多人不会为了这玩意还专门去买个 Mac，成本太高。推荐大家用虚拟机或者云服务器上部署。

类型	推荐
虚拟机	Vmware 虚拟机
云服务器	智星云

本教程以 Windows 系统本地部署 Chawdbot 为例讲解，点击查看视频教程。

一、租好服务器后的准备工作

Node.js 22 以上版本
- 官网下载：https://nodejs.org/zh-cn/download
安装 Git
- 下载地址：https://git-scm.com/install/windows（服务器一般已包含）
国产大模型 API KEY 申请入口
- 智谱 AI
  - 邀请链接：https://www.bigmodel.cn/invite?icode=U5bp%2BRAcq8Tp3a%2Fz%2F4ILJUjPr3uHog9F4g5tjuOUqno%3D
  - Api Key 入口：https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys
- 千问：https://www.aliyun.com/product/bailian
- MiniMax：https://minimaxi.com/

二、部署教程

情况说明

Github 官方：https://github.com/moltbot/moltbot
官方给出的运行命令 npm install -g moltbot@latest 和 moltbot onboard --install-daemon 目前无法使用，因为包名 moltbot 安装后只有一个 index.js 文件，里面是 "hello moltbot"。
因此我们继续用老的指令：npm install -g clawdbot@latest
也可以使用源码部署：git clone https://github.com/moltbot/moltbot.git

说明截至 2026 年 1 月 30 日，后续请自行测试。

部署步骤

cd C:\Users\vipuser

以 CMD 管理员模式执行：
```
npm install -g clawdbot@latest
```
安装完成后运行配置向导：
```
clawdbot onboard
```
按提示完成配置。
飞书开放平台：https://open.feishu.cn/app — 在此添加机器人。

三、飞书对接（Windows 下常见出错环节）

国内用飞书对接时，可参考文档中的权限说明进行勾选：

文档地址：https://github.com/m1heng/Clawdbot-feishu

1. 安装飞书插件

clawdbot plugins install @m1heng-clawd/feishu

若出现 spawn npm ENOENT 报错，请查看下方「常见问题」第二点。

同时需要提前在飞书开放平台申请 App ID 和 API 密钥。

2. 配置飞书对接

执行：

clawdbot config

在配置向导中按以下顺序操作：

local → channels → confid and link
在列表中选择 飞书（中国）
user local plugin path → 输入 App ID 和 API 密钥
选择 飞书中国
open → finished → yes → Pairing → continue

3. 飞书后台创建应用与权限

参考：https://github.com/m1heng/clawdbot-feishu 中的权限项说明。

创建企业自建应用 — 名称可填「添加机器人」等。
权限管理 — 开通所需权限（按文档勾选）。
事件与回调
- 事件配置：订阅方式选择 长连接 → 保存
- 添加事件：勾选「接收消息」
- 回调配置：开启 长连接 → 保存
创建版本 — 填写版本号、说明 → 保存 → 确认发布。

到这一步飞书对接全部完成。

4. 在飞书中使用机器人

打开 飞书客户端 → 搜索 → 输入应用名称
找到对应应用后即可与机器人对话。

四、常见问题

一、`clawdbot` 不是内部或外部命令

现象：

C:\Users\Administrator>clawdbot onboard
'clawdbot' 不是内部或外部命令，也不是可运行的程序或批处理文件。

解决： 检查 npm 全局安装路径，将该路径添加到 系统变量 / 用户变量 的 Path 中。

二、安装飞书插件报错：`spawn npm ENOENT`

现象：

[clawdbot] Failed to start CLI: Error: spawn npm ENOENT

解决： 改为从本地安装插件包。

下载插件包：

curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.1.tgz

从本地安装：

clawdbot plugins install ./feishu-0.1.1.tgz

若出现 缺少模块 报错，例如：

feishu failed to load from ... Error: Cannot find module '@larksuiteoapi/node-sdk'

解决： 安装缺失依赖：

npm install @larksuiteoapi/node-sdk

三、飞书插件报错缺少 `@larksuiteoapi/node-sdk`

现象：

feishu failed to load from C:\Users\Administrator\.clawdbot\extensions\feishu\index.ts:
Error: Cannot find module '@larksuiteoapi/node-sdk'

解决： 飞书插件缺少依赖，需在插件目录安装：

cd "C:\Users\Administrator\.clawdbot\extensions\feishu"
npm install @larksuiteoapi/node-sdk

注意：安装飞书插件时不要使用 -g 参数，即不要用 clawdbot plugins install -g ...，否则可能报 error: unknown option '-g'。

四、安装 clawdbot 时报错与 `libsignal-node`、Git 相关

现象：

npm error command git --no-replace-objects ls-remote ssh://git@github.com/whiskeysockets/libsignal-node.git

原因： clawdbot 依赖的包（如 libsignal-node）通过 SSH 访问 GitHub，而当前环境未配置 SSH 或无法访问。

解决： 将 Git 改为使用 HTTPS 拉取：

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

然后再重新执行 npm install -g clawdbot@latest。