Ubuntu 部署 OpenClaw 并接入飞书机器人
近期 AI 圈更新迅速,从各类代码助手到智能体(Agent)层出不穷。OpenClaw 作为开源个人 AI 助手项目,支持接入 WhatsApp、Telegram、飞书等十多种平台,能自动回复消息、执行任务。不过需要注意的是,由于上下文积累和多轮推理消耗较大,Token 成本需提前评估。
1. 环境准备
虽然 Mac Mini 适配性较好,但 Linux 系统同样兼容。建议不要在主力开发机上直接安装,以免权限过高导致隐私风险。
系统要求:
- 操作系统:Ubuntu
- 网络环境:需具备访问外部服务的网络条件
- Node.js 版本:>= 22.0
2. 前期配置
OpenClaw 自身不带模型,需要对接大模型 API 和聊天渠道。这里以飞书为例。
2.1 飞书应用配置
登录 飞书开放平台,创建企业自建应用。
- 创建应用:输入应用名称和描述后点击创建。
- 添加机器人:在应用管理中添加机器人。
- 记录凭证:保存
AppID和AppSecret。
接下来需要在本地启动长连接客户端来激活应用。
cd /usr/local
git clone https://github.com/Futaoj/enable_openclaw_feishu_lark.git
cd enable_openclaw_feishu_lark
npm install
配置环境变量,将飞书应用的 AppID 和 Secret 填入:
export FEISHU_APP_ID="your_app_id"
export FEISHU_APP_SECRET="your_app_secret"
启动长连接客户端:
npm run ws
成功启动后会看到 WebSocket 连接成功的日志。为了保持后台运行,按 Ctrl+C 停止后使用以下命令:
nohup npm run ws > ws.log 2>&1 &
回到飞书开放平台,配置事件与回调:
- 选择长连接接收事件。
- 回调配置也设置为长连接。
- 添加订阅事件,包括:
im.message.receive_v1(必需)im.message.message_read_v1im.chat.member.bot.added_v1im.chat.member.bot.deleted_v1
2.2 权限管理
在【权限管理】中导入权限,将以下 JSON 填入 scopes:
{


