跳到主要内容OpenClaw 安装与飞书机器人接入教程 | 极客日志JavaScriptNode.jsAI
OpenClaw 安装与飞书机器人接入教程
介绍 OpenClaw 开源 AI 智能体框架的安装与飞书机器人接入流程。涵盖阿里云服务器及本地 Windows 环境部署、阿里云百炼模型配置、飞书开放平台应用创建与事件订阅,以及最终验证步骤。支持 7x24 小时运行及多智能体协作。
深海蔚蓝17 浏览 第一部分:准备工作与核心认知
在开始动手前,我们需要先了解 OpenClaw 是什么,并准备好必要的账号和工具。
1.1 什么是 OpenClaw?
OpenClaw(昵称'小龙虾',曾用名 ClawdBot / Moltbot)是一个开源的个人 AI 智能体框架。它本身不具备推理能力,需要对接大语言模型(如阿里云百炼、七牛云、OpenAI 等)的 API。它的核心价值在于:
- 真正的执行能力:能通过'技能'(Skills)直接操作电脑、调用插件。
- 多平台接入:支持接入飞书、Telegram、WhatsApp 等聊天软件。
部署灵活:可以部署在云端(7×24 小时运行)或个人电脑本地。1.2 环境与物料清单
- 服务器/电脑:
- 方案 A(推荐):阿里云轻量应用服务器(2 核 4GB 内存以上,系统推荐 Ubuntu 22.04 或 OpenClaw 官方镜像)。
- 方案 B:本地 Windows 11 电脑(内存建议 8GB 以上,需安装 Node.js 和 Git)。
- 必备账号与凭证:
- 阿里云账号:用于开通百炼大模型服务(或其他模型提供商,如七牛云)并获取 API Key。
- 飞书企业账号:用于登录飞书开放平台创建机器人。
- 基础工具:
- 终端工具:Windows 需管理员权限的 PowerShell;Mac/Linux 用自带终端。
- 远程连接工具:如使用云服务器,需准备 Finalshell、Xshell 或使用阿里云 WebShell。
第二部分:OpenClaw 基础环境部署
OpenClaw 依赖 Node.js 运行。你可以根据自己的情况选择在云服务器或本地 Windows 上部署。
2.1 方案 A:阿里云服务器部署(7x24 小时运行,推荐)
2.1.1 获取阿里云百炼 API Key(用于 AI 大脑)
OpenClaw 需要一个大模型来'思考',我们以阿里云百炼平台的模型为例。
- 访问 阿里云百炼大模型控制台,完成实名认证。
- 在'API-KEY 管理'中,点击创建 API-Key。
- 复制生成的密钥(格式如
sk-...),保存好备用。
2.1.2 一键购买与部署(新手最快方式)
阿里云提供了包含 OpenClaw 的轻量应用服务器镜像,可以实现一键部署。
- 进入专题页:访问阿里云 OpenClaw 一键部署专题页面,点击【一键购买并部署】。
- 选购服务器:
- 镜像:选择 OpenClaw(Moltbot) 镜像。如果已有服务器,可以重置系统选择此镜像。
- 实例规格:内存必须 2GiB 及以上(建议 4GiB)。
- 地域:如需联网搜索功能,建议选择非中国大陆地域(如美国(弗吉尼亚)),或使用香港地域。
- 配置百炼 API:
- 购买完成后,进入轻量应用服务器控制台,找到你的实例。
- 点击进入应用详情页。
- 在'OpenClaw 使用步骤'区域,单击配置百炼 API-Key的'执行命令',输入刚才保存的 API-Key。
- 放行端口:在应用详情页,点击端口放通的'执行命令',一键放行 18789(OpenClaw 控制台)等必要端口。
- 获取访问地址:点击访问 Web UI 面板的'执行命令',获取访问地址。在本地浏览器打开该地址(格式为
http://服务器公网 IP:18789),即可看到 OpenClaw 控制台。
2.1.3 Docker 手动部署(进阶稳定)
如果你更喜欢用 Docker 进行环境隔离,可以通过 SSH 连接到服务器后执行以下命令:
docker pull openclaw/openclaw:latest
mkdir -p /opt/openclaw/{config,skills,agents,logs,feishu-config}
docker run -d \
--name openclaw \
--restart always \
-p 18789:18789 \
-v /opt/openclaw/config:/app/config \
-v /opt/openclaw/skills:/app/skills \
-v /opt/openclaw/feishu-config:/app/feishu-config \
-e TZ=Asia/Shanghai \
openclaw/openclaw:latest
docker exec -it openclaw bash
openclaw init --feishu
2.2 方案 B:本地 Windows 11 部署(测试、隐私优先)
2.2.1 安装系统依赖
- 安装 Node.js:
- 下载 Node.js 官网的 LTS 版(22.x 或 24.x)。
- 安装时务必勾选 'Add to PATH'。
- 安装后打开 PowerShell,输入
node -v 和 npm -v 验证版本。
- 安装 Git:从 Git 官网下载安装包,保持默认选项,确保 'Git Bash Here' 和 'Add Git to PATH' 被勾选。
- 安装 Visual C++ Redistributable:Win10/Win11 通常需要此运行库,从微软官网下载安装 x64 版本。
2.2.2 配置 PowerShell 与 npm 镜像
npm config set registry https://registry.npmmirror.com/
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
2.2.3 一键安装 OpenClaw
在 PowerShell 中执行官方 Windows 安装脚本:
iwr -useb https://openclaw.ai/install.ps1 | iex
2.2.4 初始化与启动
浏览器会自动打开 http://127.0.0.1:18789,进入 OpenClaw 图形化管理界面。
openclaw onboard --install-daemon
此向导会引导你设置模型提供商(可先跳过或临时选择,后续会修改)。
第三部分:配置 AI 模型(以阿里云百炼为例)
无论你采用哪种部署方式,安装完成后,都需要告诉 OpenClaw 使用哪个大模型。你可以通过修改配置文件或在 Web UI 中完成。
3.1 配置文件方式
OpenClaw 的配置文件通常位于 ~/.openclaw/openclaw.json(Linux/Mac)或 C:\Users\你的用户名\.openclaw\openclaw.json(Windows)。
在配置文件的 models.providers 中添加阿里云百炼(或七牛云等兼容 OpenAI 格式的)配置:
{
"models": {
"providers": {
"bailian": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "你的阿里云百炼 API-KEY",
"api": "openai-completions",
"models": [
{"id": "qwen-plus", "name": "通义千问-Plus", "contextWindow": 128000, "maxTokens": 8192},
{"id": "qwen-max", "name": "通义千问-Max", "contextWindow": 128000, "maxTokens": 8192}
]
}
}
}
}
注意:apiKey 也可以通过环境变量 ${BAILIAN_API_KEY} 引用,更安全。
3.2 使用 Onboarding 向导
如果你不想手动编辑文件,也可以在终端重新运行 openclaw onboard 命令,在交互式菜单中选择'Model/auth provider',然后选择'阿里云百炼'并粘贴你的 API Key。
第四部分:接入飞书机器人(核心步骤)
这是让 OpenClaw 进入飞书群聊的关键环节。
4.1 在飞书开放平台创建应用
- 访问 飞书开放平台,登录你的企业账号。
- 点击**'创建应用'** -> '企业自建应用',填写应用名称(如'我的小龙虾助手')和描述。
- 创建完成后,进入应用详情页,点击左侧**'凭证与基础信息'**,获取 App ID 和 App Secret(保存好,后面要用)。
4.2 配置 OpenClaw 飞书通道
- 获取事件订阅地址:
添加通道后,OpenClaw 会生成一个用于接收飞书事件的 HTTP 地址(通常是
https://你的公网 IP 或域名:18789/api/v1/channels/feishu/webhook 或类似格式)。
- 如果是本地部署,需要使用内网穿透工具(如 ngrok)将本地地址暴露到公网。
- 如果是云服务器,请确保使用的是公网 IP,并且防火墙(以及阿里云安全组)已放行 18789 端口。
在 OpenClaw 中添加飞书通道:
在你的 OpenClaw 服务器终端(或本地 PowerShell)中执行:
openclaw channels add --channel feishu --token "cli_xxxxxxxx:你的 AppSecret"
4.3 配置飞书应用的事件订阅
- 回到飞书开放平台的应用管理后台。
- 点击左侧**'事件订阅'**。
- 在'请求地址配置'中,粘贴上一步获取的 OpenClaw 事件订阅地址。
- 点击**'加密策略'**后面的'编辑',添加事件。
- 搜索并添加
message 相关的权限和事件(如 接收消息),这是机器人能收到并回复消息的基础。
- 添加完成后,点击'保存'。
4.4 配置权限与发布
- 权限管理:在左侧'权限管理'中,添加机器人需要的权限。通常至少需要:
im:message
im:message:send_as_bot (以机器人的身份发送消息)
im:chat (获取群聊信息)
- 发布版本:点击左侧'版本管理与发布',创建一个版本并提交审核(需企业管理员审核)。或者,如果你是企业管理员,可以直接点击'申请发布',然后在审核中通过。
4.5 将机器人添加到飞书群
- 在飞书客户端,打开你想让机器人工作的群聊。
- 点击群设置 -> '群机器人' -> '添加机器人'。
- 搜索你刚才创建的应用名称(如'我的小龙虾助手'),点击添加。
第五部分:验证与使用
- 检查 OpenClaw 状态:
在服务器终端执行
openclaw status 或 openclaw doctor,确保 Gateway 正在运行,且飞书通道状态正常。
- 在飞书群中互动:
- 在飞书群里直接 @ 你的机器人,发送一条消息,比如'你好'。
- 如果配置正确,机器人会调用配置好的大模型进行思考,并回复消息。
- 进阶技巧:OpenClaw 支持多智能体,你可以配置多个飞书机器人账号加入同一个群,分别响应不同领域的问题(如一个负责编程,一个负责文案),实现'一群多助手'。
常见问题排查
- 提示
openclaw: command not found:
npm 全局安装目录未添加到 PATH。执行 npm prefix -g 找到路径(如 /usr/local),然后将 /usr/local/bin 添加到系统的 PATH 环境变量中。
- 飞书机器人无回复:
- 检查飞书开放平台的事件订阅地址是否验证通过。
- 检查服务器防火墙和安全组是否放行了 18789 端口。
- 查看 OpenClaw 日志:
openclaw gateway status 或查看 /var/log/openclaw/ 下的日志文件。
- 确认 API Key 是否有效,余额是否充足。
- 服务启动失败/内存不足:
OpenClaw 需要至少 2GB 可用内存(建议 4GB)。如果是低配服务器,建议增加 Swap(交换分区)或升级配置。
通过以上步骤,你应该已经成功将 OpenClaw 接入飞书,拥有一个 24 小时在线的 AI 协作了。
微信扫一扫,关注极客日志
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
相关免费在线工具
- RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
- Keycode 信息
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
- Escape 与 Native 编解码
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
- JavaScript / HTML 格式化
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
- JavaScript 压缩与混淆
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online