Ubuntu 部署 OpenClaw 并接入飞书机器人

近期开源 AI 助手领域涌现了不少新工具，OpenClaw 作为其中一款个人 AI Agent 项目，因其支持多平台接入和自动化任务处理而受到关注。本文将介绍如何在 Ubuntu 环境下安装 OpenClaw，并通过长连接方式将其接入飞书机器人，实现自动回复与任务执行。

1. 环境准备

OpenClaw 对系统权限有一定要求，建议不要在主力开发机上直接操作，以免产生隐私风险。本项目主要依赖 Node.js 运行，因此需确保环境满足以下要求：

操作系统：Ubuntu Linux
运行时：Node.js >= 22.0
网络：需保持稳定的网络连接以访问外部 API

2. 飞书应用配置

由于 OpenClaw 自身不包含模型，需要对接大模型 API 及聊天渠道。首先需要在飞书开放平台创建应用并配置事件订阅。

2.1 创建自建应用

登录飞书开放平台，进入开发者后台扫码登录，点击创建企业自建应用。输入应用名称和描述后完成创建。

随后在应用中添加一个机器人，并记录应用的 AppID 和 AppSecret，后续初始化时需要用到。

2.2 配置长连接客户端

回到 Ubuntu 系统，在合适目录（如 /usr/local）克隆飞书长连接客户端仓库：

git clone https://github.com/Futaoj/enable_openclaw_feishu_lark.git
cd enable_openclaw_feishu_lark

安装依赖：

npm install

配置环境变量，将飞书应用的 ID 和密钥填入：

export FEISHU_APP_ID="your_app_id"
export FEISHU_APP_SECRET="your_app_secret"

启动长连接客户端：

npm run ws

成功启动后会看到 WebSocket 连接成功的日志。由于该服务需长期运行，建议后台启动：

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

2.3 配置事件与回调

回到飞书开放平台，在应用管理中找到【事件与回调】，选择使用长连接接收事件并保存。同时将回调配置也设置为长连接模式。

在下方的【添加事件】中，勾选以下必要事件：

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

接着进入【权限管理】，导入所需的权限范围。将以下 JSON 内容填入 scopes 区域：

{"scopes":{