> 面向零基础用户，手把手演示如何从干净的 Linux 环境开始，安装 OpenClaw、配置 AI 模型并对接飞书机器人，最终实现在飞书中与 AI 直接对话。文中附带常见问题的排查与解决方案。 一、OpenClaw 是什么？ OpenClaw 是一个开源的 AI Agent 框架。简单来说，它允许你部署一个私有 AI 助手，并接入飞书、Telegram、WhatsApp、Discord 等多…
本文面向零基础用户，手把手演示如何从干净的 Linux 环境开始，安装 OpenClaw、配置 AI 模型并对接飞书机器人，最终实现在飞书中与 AI 直接对话。文中附带常见问题的排查与解决方案。
OpenClaw 是一个开源的 AI Agent 框架。简单来说，它允许你部署一个私有 AI 助手，并接入飞书、Telegram、WhatsApp、Discord 等多种聊天平台。
核心架构如下：
你的消息 → 飞书/Telegram/... → OpenClaw Gateway → AI 模型 → 回复
主要特性：
| 项目 | 要求 |
|---|---|
| 操作系统 | Linux / macOS / Windows (WSL2) |
| Node.js | v22 或更高 |
| 网络 | 可访问飞书开放平台及对应 AI API |
若未安装或版本低于 v22，推荐使用 nvm 进行版本管理：
# 检查当前版本
node --version
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
# 安装并使用 Node.js 22
nvm install 22
nvm use 22
💡 提示：执行
node --version显示v22.x.x即表示安装成功。
macOS / Linux：
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)：
iwr -useb https://openclaw.ai/install.ps1 | iex
安装完成后验证：
openclaw --version
显示版本号（如 2026.3.2）即表示成功。
若一键脚本执行失败，可使用 npm 安装：
npm install -g openclaw
⚠️ 注意：若遇到
EACCES: permission denied错误，请勿直接使用sudo npm install -g。建议优先使用nvm管理 Node.js 环境以规避权限冲突。
安装完成后，运行初始化向导：
openclaw onboard --install-daemon
向导将引导你完成以下配置：
18789，通常无需修改。💡
--install-daemon参数会将 Gateway 注册为系统服务，实现开机自启。
配置完成后检查服务状态：
openclaw gateway status
若显示 running，则基础环境已就绪。此时可通过以下命令打开 Web 控制面板：
openclaw dashboard
浏览器将自动跳转至 http://127.0.0.1:18789。
飞书对接分为三步：飞书侧创建应用 → OpenClaw 侧配置插件 → 联调测试。
OpenClaw 通过插件支持飞书，需先行安装：
openclaw plugins install @openclaw/feishu
安装完成后重启 Gateway：
openclaw gateway restart
https://open.larksuite.com/app）App ID（格式：cli_xxxxxxxxx）与 App Secret。请妥善保管 App Secret，切勿泄露或提交至代码仓库。{
"scopes": {
"tenant": [
"im:message",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"contact:user.employee_id:readonly"
],
"user": [
"im:chat.access_event.bot_p2p_chat:read"
]
}
}
💡 此为最小权限集。若需操作文档或多维表格，可后续追加
docx:document、bitable:app等权限。
im.message.receive_v1（接收消息 v1）。🚨 关键提示：务必选择「长连接」。该模式无需公网 IP 或域名，对个人开发者更友好。配置前请确保 OpenClaw Gateway 已处于运行状态，否则飞书无法建立连接导致保存失败。
⚠️ 注意：应用必须发布后配置才会生效。
方式一：交互式向导（推荐）
openclaw channels add
选择 Feishu，按提示输入 App ID 和 App Secret。
方式二：手动编辑配置文件
编辑 ~/.openclaw/openclaw.json，追加飞书配置：
{
"channels": {
"feishu": {
"enabled": true,
"dmPolicy": "pairing",
"accounts": {
"main": {
"appId": "cli_xxxxxxxxx",
"appSecret": "你的AppSecret"
}
}
}
}
}
保存后重启服务：
openclaw gateway restart
openclaw pairing approve feishu <配对码>
openclaw gateway start
openclaw gateway status # 确认状态为 running
服务启动后再返回飞书平台保存配置。
im.message.receive_v1？openclaw logs --follow
发送消息后观察终端输出，定位具体报错。
{
"channels": {
"feishu": {
"groups": {
"oc_你的群ID": {
"requireMention": false
}
}
}
}
}
💡 获取群 ID：启动 Gateway 后在群内 @机器人，通过
openclaw logs --follow查看日志中的chat_id。
im:message, im:message:send_as_bot |
| 读取群消息 | im:message.group_at_msg:readonly |
| 操作文档 | docx:document, docx:document:readonly |
| 操作多维表格 | bitable:app |
| 云盘操作 | drive:drive, drive:file |openclaw logs --follow 检查连接日志。若出现 error，通常为 App ID 或 App Secret 填写错误。nvm 升级：nvm install 22
nvm use 22
openclaw gateway restart
完成配置后，建议按以下顺序验证：
# 1. 检查版本
openclaw --version
# 2. 检查 Gateway 状态
openclaw gateway status
# 3. 确认插件已安装
openclaw plugins list
# 4. 检查飞书连接状态
openclaw status # 应显示 feishu: connected
# 5. 飞书端发送测试消息，确认收到 AI 回复
| 命令 | 用途 |
|---|---|
openclaw gateway status | 查看 Gateway 运行状态 |
openclaw gateway restart | 重启 Gateway 服务 |
openclaw logs --follow | 实时跟踪运行日志 |
openclaw channels add | 交互式添加聊天渠道 |
openclaw pairing list feishu | 查看待处理的飞书配对请求 |
openclaw pairing approve feishu <CODE> | 批准飞书配对 |
openclaw dashboard | 打开 Web 管理面板 |
openclaw skills list | 查看已安装的扩展技能 |
openclaw doctor | 执行环境健康检查与自动修复 |
飞书端内置指令
| 指令 | 用途 |
|---|---|
/status | 查看机器人运行状态 |
/reset | 清空当前对话上下文 |
/model | 查看或切换底层 AI 模型 |
@openclaw/feishu 插件已正确安装。openclaw logs --follow 是最高效的排查手段。本文基于 OpenClaw
2026.3.2版本编写，飞书开放平台配置流程截至 2026 年 3 月。实际界面或参数可能随版本更新略有差异，请以 官方文档 为准。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online