最近，一个名为Clawdbot（后更名为Moltbot）的AI助手工具开始在技术圈流行起来。你可以把它看作一个部署在本地的“数字员工”，能够7x24小时响应你的指令，处理各种自动化任务。
目前，腾讯云和阿里云都已提供一键部署的云服务器方案。本文将聚焦于在Windows系统本地，从零开始搭建一个功能完整的Clawdbot，并最终接入飞书，实现随时随地与你的AI助理对话。
准备工作
在安装Clawdbot之前，需要确保你的本地环境满足以下几个条件。
1. 安装Node.js
Clawdbot基于Node.js运行，因此需要先安装Node.js环境，建议使用v18或更新版本。
前往Node.js官网下载安装包：https://nodejs.org/en/download/
如果你已安装，可以通过终端命令检查当前版本：
node -v
理想情况下，终端应返回类似 v24.11.1 的版本信息，表明Node.js已正确安装并可用。
2. 启用Windows的“启用sudo”选项
许多教程会提到需要“开启全局模式”，这在Windows上对应的是开启“启用sudo”功能。这实质上是一种以管理员权限运行命令的便捷方式。
操作步骤如下：
- 右键点击Windows开始菜单，选择【设置】。
- 在设置中，依次进入【系统】 -> 【高级】。
- 找到“启用sudo”选项，将其开关打开。系统会提示相关安全风险，确认即可。
3. 获取智谱AI（GLM）的API Key
Clawdbot支持连接多种大模型，如OpenAI、Claude等。为了在国内网络环境下稳定使用，我们选择智谱AI的GLM模型。
首先，访问智谱AI官网注册并登录：https://www.bigmodel.cn/glm-coding
登录后，进入API Key管理页面，点击“添加新的API Key”创建一个新的密钥。请妥善保管生成的 id 和 secret，后续配置会用到。
智谱AI提供了多种套餐，你可以根据自身使用频率和需求进行选择，其定价相比国际同类服务更具灵活性。
4. 创建飞书自建应用（可选）
这一步是为了让你能在手机飞书上与Clawdbot交互。如果仅限本地电脑使用，可跳过。
- 访问飞书开放平台应用后台：https://open.feishu.cn/app
- 点击“创建企业自建应用”。
- 填写应用名称（例如
clawdbot），点击创建。
- 应用创建成功后，在“凭证与基础信息”页面，可以找到
App ID 和 App Secret，同样记录下来备用。
至此，所有前置依赖和凭证已准备就绪。
安装与配置 Clawdbot
安装过程需要使用管理员权限，以确保Clawdbot的网关服务能正确安装。
1. 全局安装Clawdbot
以管理员身份打开命令提示符（CMD）或Windows Terminal。
执行以下命令进行全局安装：
sudo npm install -g clawdbot@latest
此过程可能需要一些时间，需等待npm下载并安装所有依赖。
安装完成后，通过以下命令验证是否成功：
clawdbot --version
如果终端显示出版本号（例如 2026.1.24-3），则说明安装成功。
2. 运行初始化配置向导
接下来，运行配置向导来设置Clawdbot的核心参数并安装后台网关服务。执行命令：
sudo clawdbot onboard --install-daemon
向导启动后，会首先显示安全提示，告知你Clawdbot拥有在系统上执行命令、读写文件的强大能力。使用键盘方向键选择 Yes 并回车，才能继续。
随后，配置向导会引导你完成一系列设置：
- 配置方式：首次安装选择默认的
QuickStart 即可。
- 模型提供商：在列表中选择
Z.AI (GLM 4.7) (API key)，然后粘贴你在智谱AI获取的 id 和 secret。
- 通信通道：向导列出的多为国外即时通讯软件。由于我们后续会单独配置飞书，这里直接选择
Skip for now 跳过。
- 技能(Skills)安装：Clawdbot拥有大量可扩展的技能。向导会提示安装缺失的技能依赖，对于新手，可以直接选择
Skip for now，后续可按需安装。
- 钩子(Hooks)配置：建议启用以下三个实用钩子：
boot-md: 在网关启动时加载一段Markdown文本作为系统提示，用于初始化AI的行为偏好。command-logger: 将所有命令事件记录到统一的审计文件中，便于排查问题。session-memory: 保存会话上下文，使AI在多轮对话中保持连贯性。
- 网关服务：向导最后会为Clawdbot安装并启动一个后台网关服务（基于Node.js）。首次安装会直接完成此步骤。
完成所有配置后，Clawdbot的核心服务就已经在本地运行起来了。
配置飞书通道
为了让Clawdbot能通过飞书与你对话，我们需要安装飞书插件并进行配置。
1. 安装飞书插件
在终端中执行以下命令来安装官方飞书插件：
clawdbot plugins install @m1heng-clawd/feishu
如果安装过程中遇到 Error: spawn npm ENOENT 这类错误，可以尝试手动下载插件包再安装：
# 1. 下载插件压缩包
curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.1.tgz
# 2. 从本地文件安装
clawdbot plugins install ./feishu-0.1.1.tgz
2. 配置飞书应用凭证
安装好插件后，需要将之前在飞书开放平台获取的 App ID 和 App Secret 配置到Clawdbot中。
请将以下命令中的 你的appid 和 你的appid秘钥 替换为实际值：
# 设置 App ID
clawdbot config set channels.feishu.appId 你的appid
# 设置 App Secret
clawdbot config set channels.feishu.appSecret 你的appid秘钥
# 启用飞书通道
clawdbot config set channels.feishu.enabled true
每执行一条设置命令，系统都会提示需要重启网关以应用变更。我们可以稍后统一处理。
3. 在飞书后台配置权限与事件
仅配置凭证还不够，还需要在飞书开放平台为应用开通相应的API权限和事件订阅。
- 批量导入权限：
- 进入你的飞书应用后台，在左侧找到【权限管理】。
- 点击
批量导入/导出权限 -> 导入。
- 将以下JSON代码粘贴到输入框中，然后点击
下一步，确认新增权限并开通。
{
"scopes": {
"tenant": [
"contact:contact.base:readonly",
"contact:user.base:readonly",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message.reactions:read",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:update",
"im:resource"
],
"user": [
"docx:document:readonly"
]
}
}
- 订阅接收消息事件：
- 在应用后台左侧，进入【事件与回调】->【事件配置】。
- 点击
添加事件，在搜索框输入 receive。
- 勾选出现的
接收消息 v2.0 (im.message.receive_v1) 事件，点击确认添加。
4. 发布应用并测试
- 创建版本：在飞书应用后台顶部，点击
创建版本。填写版本号（如1.0.0），更新说明，并确保“默认应用能力”选择了“机器人”，然后提交发布。自建应用通常秒级通过审核。
- 重启Clawdbot网关：返回本地终端，执行以下命令，使所有关于飞书的配置生效：
clawdbot gateway restart
- 测试对话：打开飞书，在工作台或搜索中找到你刚发布的应用。向它发送一条消息，如“Hi”。如果收到Clawdbot的回复（例如：“Hi there! 飞书已经连接上了！”），则代表整个链路已成功打通。
常用管理命令
部署完成后，你可能会用到以下命令来管理你的Clawdbot服务：
# 重启网关服务（修改配置后常用）
clawdbot gateway restart
# 检查网关服务运行状态
clawdbot gateway status
# 查看所有配置
clawdbot config list
# 安装新的技能(Skill)
clawdbot skills install [技能名]
通过以上步骤，你已经在Windows系统上成功搭建了一个私有的、可接入飞书的AI助理平台。它不仅能够理解自然语言指令，还能通过不断扩展的技能库，帮你处理更多自动化任务。探索 Clawdbot 的官方文档，你可以解锁更多关于人工智能 Agent和复杂工作流的玩法。
如果在实践过程中遇到任何技术问题，欢迎在技术文档板块或Node.js相关讨论区与云栈社区的其他开发者交流心得，共同解决部署难题。
发表于 前天 23:37
|
查看: 1|
回复: 0
