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_v1im.chat.member.bot.added_v1im.chat.member.bot.deleted_v1
接着进入【权限管理】，导入所需的权限范围。将以下 JSON 内容填入 scopes 区域：
{"scopes":{"tenant"
