乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > OpenClaw 接入飞书完整教程

OpenClaw 接入飞书完整教程

当前时间： 2026-05-24 08:07:04 更新时间： 2026-05-24 分类：软件教程 评论(0)

OpenClaw 接入飞书完整教程

从零开始，让你的 AI 助手在飞书上随时待命。
什么是 OpenClaw？
OpenClaw 是一个自托管的 AI 网关，可以把你的聊天应用（飞书、Telegram、Discord、微信等）连接到 AI 编程助手。你只需要运行一个 Gateway 进程，就能在手机上随时和 AI 助手对话。
核心特点：
• 🏠 自托管：数据在你自己的机器上，完全可控
• 🔌 多渠道：一个 Gateway 同时服务飞书、Telegram、Discord 等
• 🤖 Agent 原生：支持工具调用、会话管理、多 Agent 路由
• 📖 开源：MIT 协议，社区驱动
前置准备
  1. Node.js — 推荐 Node 24（Node 22.19+ 也可以）
2. 一个 AI 模型的 API Key — 支持 Anthropic、OpenAI、Google、DeepSeek 等
3. 飞书开放平台账号 — 用于创建自建应用
第一步：安装 OpenClaw
Windows (PowerShell)：

iwr -useb https://openclaw.ai/install.ps1 | iex

macOS / Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

安装完成后，运行初始化向导：

openclaw onboard --install-daemon

向导会引导你选择模型提供商、设置 API Key、配置 Gateway，大约 2 分钟搞定。
第二步：在飞书开放平台创建应用
  1. 打开飞书开放平台 (open.feishu.cn) 并登录
2. 点击「创建自建应用」
3. 填写应用名称（比如「我的 AI 助手」）和描述
4. 创建完成后，进入应用页面，记录下 App ID 和 App Secret
配置应用权限
在应用的「权限管理」页面，添加以下权限：
• im:message — 发送消息
• im:message.receive_v1 — 接收消息事件
• im:resource — 上传/下载资源
• contact:user.base:readonly — 读取用户基本信息
配置事件订阅
  1. 进入「事件订阅」页面
2. 选择长连接（WebSocket）模式（推荐，无需公网 IP）
3. 添加事件：im.message.receive_v1
发布应用
  1. 进入「版本管理」页面，创建版本并提交审核
2. 审核通过后，应用即可使用
第三步：在 OpenClaw 中配置飞书
方式一：使用向导（推荐）

openclaw channels login --channel feishu

选择「手动配置」，然后粘贴你的 App ID 和 App Secret。
方式二：手动编辑配置
在 OpenClaw 配置文件中添加飞书渠道配置。打开 ~/.openclaw/openclaw.json，在 channels 下添加 feishu 配置：

{  "channels": {    "feishu": {      "enabled": true,      "appId": "cli_xxxxxxxxxx",      "appSecret": "你的App Secret",      "domain": "feishu",      "connectionMode": "websocket",      "dmPolicy": "pairing",      "groupPolicy": "allowlist"    }  }}

domain 设置为 feishu（国内飞书）或 lark（海外 Lark）。connectionMode 推荐 websocket（长连接，无需公网 IP）。
第四步：重启 Gateway

openclaw gateway restart

检查状态：

openclaw gateway status

你应该能看到 Gateway 在端口 18789 上运行。
第五步：开始聊天！
  1. 在飞书中搜索你创建的应用名称
2. 给机器人发送第一条消息
3. 机器人会回复一个配对码（pairing 模式下）
在终端中批准配对：

openclaw pairing list feishuopenclaw pairing approve feishu <配对码>

配对完成后，就可以正常聊天了！
进阶配置
群聊设置
允许所有群聊，无需 @：

{  "channels": {    "feishu": {      "groupPolicy": "open",      "requireMention": false    }  }}

只允许特定群聊：

{  "channels": {    "feishu": {      "groupPolicy": "allowlist",      "groupAllowFrom": ["oc_xxx", "oc_yyy"]    }  }}

流式输出
飞书支持流式卡片输出，机器人会实时更新回复。设置 streaming 为 true 即可开启（默认已开启）。

{  "channels": {    "feishu": {      "streaming": true    }  }}

多 Agent 路由
可以将不同的飞书用户/群聊路由到不同的 Agent：

{  "agents": {    "list": [      { "id": "main" },      { "id": "coder", "workspace": "/home/user/coder" }    ]  },  "bindings": [    {      "agentId": "coder",      "match": {        "channel": "feishu",        "peer": { "kind": "direct", "id": "ou_xxx" }      }    }  ]}

每用户独立 Agent（适合公开机器人）
开启 dynamicAgentCreation，每个用户自动获得独立的 Agent 实例：

{  "channels": {    "feishu": {      "dmPolicy": "open",      "allowFrom": ["*"],      "dynamicAgentCreation": {        "enabled": true,        "workspaceTemplate": "~/.openclaw/workspace-{agentId}"      }    }  }}

常用命令
• /status — 查看机器人状态
• /reset — 重置当前会话
• /model — 查看或切换 AI 模型
• openclaw gateway restart — 重启网关
• openclaw logs –follow — 查看实时日志
• openclaw pairing list feishu — 查看待配对请求
常见问题
机器人不回复消息
  1. 确认应用已发布并审核通过
2. 确认事件订阅包含 im.message.receive_v1
3. 确认选择了长连接（WebSocket）模式
4. 确认已授予所有必要权限
5. 查看日志：openclaw logs –follow
群聊中机器人不响应
  1. 确认机器人已加入群聊
2. 确认 @ 了机器人（默认需要 @）
3. 确认 groupPolicy 不是 disabled
App Secret 泄露了怎么办
  1. 在飞书开放平台重置 App Secret
2. 更新 OpenClaw 配置中的值
3. 重启网关：openclaw gateway restart
总结
OpenClaw 接入飞书的核心流程：
  1. 安装 OpenClaw → openclaw onboard
2. 飞书开放平台创建应用 → 获取 App ID / App Secret
3. 配置事件订阅 → WebSocket 长连接
4. openclaw channels login –channel feishu → 填入凭据
5. openclaw gateway restart → 开始聊天
整个过程大约 10-15 分钟。配置完成后，你就可以在飞书中随时随地和 AI 助手对话了。
更多详情请参考 OpenClaw 官方文档：
https://docs.openclaw.ai/channels/feishu
好文推荐