Ubuntu 安装 OpenClaw 并接入飞书机器人

Ubuntu 安装 OpenClaw 并接入飞书机器人

1. 前言

1.1 什么是 OpenClaw

近期，AI 圈出现了一款开源个人 AI 助手项目——OpenClaw。该项目在 GitHub 上迅速获得关注。

简单来说，它像一个 24 小时下班的数字打工人：部署在自己的电脑或服务器上，可接入 WhatsApp、Telegram、飞书、钉钉等十多种聊天平台，自动回复消息、处理任务。

需要注意的是，该工具消耗 Token 的速度较快，需合理规划模型选择及系统提示词以避免费用过高。

1.2 环境介绍

OpenClaw 对 Linux 系统适配较好。本文以 Ubuntu 为例进行演示。

由于 OpenClaw 权限较高，建议不要在主力开发机上安装，以防隐私泄露。

• 系统：Ubuntu
• 前置要求：
  1. 网络环境可访问相关服务
  2. Node.js >= 22.0

2. 前期准备

OpenClaw 需要对接聊天软件且自身无模型，因此需要准备大模型 API 和聊天渠道。

2.1 飞书准备

1. 登录飞书开放平台，创建企业自建应用。
2. 为应用添加机器人，记录 AppID 和 AppSecret。
3. 在本地 Ubuntu 系统 /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

成功启动后输出类似信息，随后按 Ctrl+C 停止，使用后台运行命令：

nohup npm run ws > ws.log 2>&1 &

4. 回到飞书开放平台，在应用下点击【事件与回调】，选择长连接接收事件并保存。
5. 将回调配置设置为长连接。
6. 添加订阅事件：
   • im.message.receive_v1（必需）
   • im.message.message_read_v1
   • im.chat.member.bot.added_v1
   • im.chat.member.bot.deleted_v1
7. 权限管理：导入权限 JSON 并申请开通。

{