1. 前言
1.1 什么是 OpenClaw
近期，AI 圈出现了一匹'野生黑马'——OpenClaw。这个开源个人 AI 助手项目在 GitHub 上迅速获得大量关注。
简单说，它就像给你配了一个 24 小时不下班的数字打工人：把它部署在自己的电脑或服务器上，它就能接入 WhatsApp、Telegram、飞书、钉钉 等十多种聊天平台，帮你自动回复、处理消息、执行任务。
而且最妙的是—— 这个'员工'不领工资、不摸鱼、也不用年终奖，只要你给它一点算力和 API。
但是这也是最坑的地方——他烧 Token 的速度简直太快了，由于上下文积累，以及多轮推理，模型选择，系统提示词等等，很多地方都会消耗 Token，这可能会导致费用爆炸。
1.2 环境介绍
据说 OpenClaw 最适配的硬件是 Mac Mini，但是其实 Linux 系统都比较适配。本教程基于 Ubuntu 系统进行演示。
由于 OpenClaw 对硬件的权限很高，所以尽量不要用自己的主力开发机来安装，防止出现隐私泄露问题。
系统：Ubuntu 前置要求：
- 必须能科学上网
- Node.js >= 22.0
2. 前期准备
由于 OpenClaw 需要对接聊天软件，同时它自身没有模型，所以我们需要两个东西：
- 大模型 API。
- 聊天渠道。
2.1 飞书准备
首先，您需要使用您的飞书账号登录飞书开放平台，点击开发者后台 > 扫码登录 > 点击创建企业自建应用。
输入应用名称和描述之后，直接点击创建即可。之后我们需要为这个应用添加一个机器人。
同时我们需要记住我们这个应用的 AppID 和 AppSecret。
接下来我们用这个 AppID 和 AppSecret 来准备激活长连接。我们回到自己的 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
成功启动后，你将看到类似以下输出：
🚀 正在启动飞书长连接客户端...
📱 App ID: cli_xxxxx...
[info]: ['client ready']
[debug]: ['[ws]', 'ws connect success']
[info]: ['[ws]', 'ws client ready']
✅ 长连接客户端已启动，等待事件...
因为这个需要一直在后台运行，所以我们 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":["contact:contact.base:readonly","contact:user.base:readonly","contact:user.employee_id:readonly","contact:user.id:readonly","im:chat","im:chat.access_event.bot_p2p_chat:read","im:chat.members:read","im:chat.moderation:read","im:chat.tabs:read","im:chat.tabs:write_only","im:chat.top_notice:write_only","im:chat:moderation:write_only","im:chat:operate_as_owner","im:chat:read","im:chat:readonly","im:chat:update","im:message","im:message.group_at_msg:readonly","im:message.group_msg","im:message.p2p_msg:readonly","im:message.pins:read","im:message.pins:write_only","im:message.reactions:read","im:message.reactions:write_only","im:message.urgent","im:message.urgent.status:write","im:message:readonly","im:message:send_as_bot","im:message:send_multi_depts","im:message:send_multi_users","im:message:send_sys_msg","im:message:update","im:resource","im:url_preview.update","im:user_agent:read","passport:session_mask:readonly"]},"user":[]}}
然后下一步确认权限，申请开通。
最后点击确认。
最后我们创建版本并发布。
我们填入版本号和描述，拉到页面底部，点击保存即可。
一会之后我们的飞书会收到类似这样的通知。
到这里，和飞书的交互基本完成。按照流程走完之后我们只需要记住两个东西，AppID 和 AppSecret，一会要用。
2.2 申请大模型 API Key
下面我们去智谱平台，注册账号，然后点击 API Key，最后我们添加一个新的 API key 即可。注意要记住这个 API key 哦，一会初始化的时候会用到。
3. 安装并初始化
安装其实很简单，我们可以去看官方文档，当然这里我还是给大家粘贴出来。
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
查看网关状态
openclaw gateway status
然后初始化的时候配置 OpenApi 的时候选择 Z.AI，然后粘贴上面申请的 Key。
然后接入渠道选择飞书。
最后安装完成可以在飞书中测试一手。
总结
安装起来不难，主要是飞书接入要浪费点时间，还有就是保证电脑能科学上网。
