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

1. 前言

1.1 什么是 OpenClaw

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

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

需要注意的是，该工具消耗 Token 的速度较快，需合理规划模型选择与上下文管理以避免费用过高。

1.2 环境介绍

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

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

2. 前期准备

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

2.1 飞书准备

首先，使用飞书账号登录 飞书开放平台，点击开发者后台扫码登录并创建企业自建应用。

输入应用名称和描述后创建。接着为应用添加一个机器人，并记录应用的 AppID 和 AppSecret。

接下来在 Ubuntu 系统中配置长连接客户端（任意目录均可）：

克隆项目

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 &

回到飞书开放平台，在应用下点击【事件与回调】，选择订阅方式为长连接并保存。

同时设置回调配置为长连接。在下方找到【添加事件】，添加以下事件：

• im.message.receive_v1（必需）
• im.message.message_read_v1
• im.chat.member.bot.added_v1
• im.chat.member.bot.deleted_v1

进行权限配置，点击左侧菜单栏【权限管理】导入权限，填入如下 JSON：

{"scopes":{"tenant":