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

前言

1.1 什么是 OpenClaw

OpenClaw 是一个开源个人 AI 助手项目。它支持部署在本地电脑或服务器上，接入 WhatsApp、Telegram、飞书、钉钉等聊天平台，实现自动回复、处理消息、执行任务。

需要注意的是，由于上下文积累、多轮推理及模型选择等因素，Token 消耗可能较快，需注意 API 费用。

1.2 环境介绍

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

• 系统：Ubuntu
• 前置要求：
  1. 网络环境通畅
  2. Node.js >= 22.0

前期准备

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
   

   配置环境变量

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

   启动长连接客户端

   npm run ws
   

   后台运行

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

4. 在飞书开放平台配置事件与回调：

   • 选择长连接接收事件。
   • 添加事件订阅：im.message.receive_v1、im.message.message_read_v1、im.chat.member.bot.added_v1、im.chat.member.bot.deleted_v1。

5. 权限配置：

   • 导入权限 JSON：

     {"scopes":{"tenant":[