OpenClaw 飞书接入：先跑通团队协作场景的消息闭环

适合谁

这条路径适合：

• 想把 OpenClaw 放进团队日常协作入口
• 更偏中文工作环境
• 想优先验证“收消息、处理、回消息”这条基本链路

如果你想最低门槛开始，先看这两条飞书路线

对中文用户来说，飞书现在最现实的通常是两条起步路线：

飞书妙搭一键部署

更适合：

• 你不想先碰命令行和服务器
• 你希望部署、飞书集成和热门技能一步到位
• 你更看重“先上线一个能用的 AI 助手”

ArkClaw 托管路线

更适合：

• 你希望实例长期在线
• 你想要云端 Terminal、技能市场和更完整的托管能力
• 你更关心平台侧安全、隔离和运维兜底

如果你是第一次做飞书接入，这两条路线都比“自己从零配服务器 + 手工配机器人”更容易先跑通。

接入前先想清楚三件事

1. 它会出现在谁面前

是你自己的私聊、测试群，还是正式团队群？第一次接入时，建议先放在可控范围内。

2. 它会读到什么

只给必要消息范围，不要一开始就让它接触不需要的群和频道。

3. 它会发出什么

先从低风险输出开始，例如测试消息、摘要结果、固定格式的回执。

安装飞书插件

如果你已经安装好 OpenClaw，先安装官方飞书插件：

openclaw plugins install @openclaw/feishu

安装完成后，用向导添加飞书渠道：

openclaw channels add

选择「飞书」，输入 App ID 和 App Secret 即可完成基础配置。

如果你更习惯手动配置，也可以直接编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "你的 App Secret"
        }
      }
    }
  }
}

关键步骤

1. 先进入飞书开放平台创建应用

入口：

• 飞书开放平台

第一次不要急着配很多机器人。先创建一个最小测试应用，把基本信息、凭证和回调链路准备好。

2. 按官方当前文档准备接入信息

飞书侧的应用配置、凭证字段和回调细节可能随版本变化。具体字段名与步骤仍请以官方当前文档为准。

3. 先把权限开到“够测试”而不是“一步到位”

如果你已经准备批量开权限，可以先参考下面这组常见权限定义，再按你的实际需求裁剪。字段、权限范围和最新命名以飞书开放平台与 OpenClaw 当前版本文档为准：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

4. 配置事件订阅

在飞书应用的「事件订阅」设置中：

1. 添加事件 im.message.receive_v1（接收消息）
2. 接收方式选择「使用长连接接收事件」（WebSocket）
3. 确保 OpenClaw gateway 正在运行：openclaw gateway status

5. 发布版本，再回 OpenClaw 联调

飞书里只把应用建好还不够。很多人卡住就是因为忘了发布版本，导致看起来配置都填了，实际上机器人侧还没真正生效。

6. 在 OpenClaw 里只填一套最小配置

第一次接入时，不要同时把多个机器人、多个群组和多个技能都接进来。先只让一个最小闭环跑通。

7. 做一轮低风险测试

建议先测试：

• 发送一条简单文本
• 让 OpenClaw 返回一段固定结果
• 再观察日志、权限和错误处理是否清晰

8. 再叠加技能和自动化

只有当基础消息链路稳定之后，才开始把技能、工作流和通知动作放进去。

直接复制这套“飞书最小联调 SOP”

第一次接飞书时，你可以只按这一套最小 SOP 走，不要同时做复杂配置：

飞书最小联调 SOP

1. 在飞书开放平台创建一个测试应用
2. 先只开最小消息相关权限
3. 发布版本
4. 回到 OpenClaw 填最小配置
5. 先在私聊或测试群发一条简单消息
6. 只验证：能收、能处理、能回
7. 通过后再补初始化、技能和自动化

第一次联调时，建议直接发这三条测试消息：

帮我回复一句“收到测试消息”。

帮我把这条消息总结成一句话，再原路发回。

告诉我你现在是否已经具备文件读写能力，以及下一步最该做什么。

飞书里最值得先做的 30 秒验证

当机器人创建完成、你已经能在飞书里找到它之后，先不要急着做复杂任务。先跑这组最小验证：

1. 在聊天列表里找到机器人
2. 发一条简单消息，例如“帮我总结今天的会议”
3. 等几秒，看它能不能稳定回消息

这一步跑通，才说明“飞书接入”真的完成了。

飞书官方插件支持的能力

安装 @openclaw/feishu 插件后，OpenClaw 可以直接操作飞书内容：

• 消息：读取、发送、搜索消息，下载附件
• 云文档：创建和读写飞书文档
• 多维表格：创建和管理数据表
• 日历：查看日程、创建事件、检查忙闲
• 任务：创建、更新、完成任务

这意味着你不需要在飞书和 OpenClaw 之间反复复制粘贴——它可以直接以应用身份操作飞书数据。

飞书里正式使用前，先做一次初始化

如果你已经能在飞书里正常对话，下一步不要直接长聊，而是先做一次 workspace 初始化。

至少建议让 OpenClaw 真正写入并回读这 5 个文件：

• IDENTITY.md
• USER.md
• SOUL.md
• AGENTS.md
• TOOLS.md

这一步的目标不是“写几份漂亮文档”，而是让它沉淀：

• 身份
• 用户偏好
• 表达风格
• 工作流
• 工具使用规则

更完整的初始化提示词模板，我已经补到 资源精选 里了。

如果你想按完整 SOP 直接一条条复制执行，去看：

• OpenClaw 飞书初始化配置指南

ArkClaw 里很实用的三组指令

如果你用的是 ArkClaw 或类似云端控制台路线，这几组命令会很常用。它们都应在 ArkClaw 控制台会话或 Terminal 里执行。

1. 开关流式输出

openclaw config set channels.feishu.streaming true
openclaw config set channels.feishu.streaming false

2. 在消息卡片里显示更多状态

openclaw config set channels.feishu.footer.elapsed true
openclaw config set channels.feishu.footer.status true

3. 开关话题独立上下文 / 多任务并行

openclaw config set channels.feishu.threadSession true
openclaw config set channels.feishu.threadSession false

如果你想把 ArkClaw 里最常用的飞书命令先放到一个小抄里，可以直接复制：

openclaw config set channels.feishu.streaming true
openclaw config set channels.feishu.footer.elapsed true
openclaw config set channels.feishu.footer.status true
openclaw config set channels.feishu.threadSession true

如果你准备把机器人放进话题群，这组配置会非常有价值。

一个飞书账号绑定多个机器人时怎么想

如果你准备让不同机器人承担不同角色，例如：

• 一个负责内容生产
• 一个负责项目管理
• 一个负责信息整理

更稳的方式不是让一个机器人承担全部角色，而是：

1. 先创建新的机器人
2. 给不同机器人绑定不同 Agent
3. 让它们各自使用不同上下文和规则

如果你准备正式上这条路线，直接看：

• 多 Agent 飞书 Bot 配置指南

如果你准备走“飞书 + 火山引擎”组合

这条路线在中文团队里很常见，原因是飞书机器人和国内模型入口都比较顺。你通常还会同时用到：

• 火山引擎控制台
• 火山方舟 Coding Plan / 模型入口

实操顺序建议是：

1. 先在火山引擎准备服务器和模型入口
2. 再去飞书开放平台创建应用
3. 配权限、发布版本
4. 最后回 OpenClaw 做联调

如果你已经买了火山侧的模型套餐，通常会比完全手动拼模型入口更省事。

常见误区

• 一开始就把正式群作为测试入口
• 还没做权限审查就装消息发送类技能
• 同时改飞书配置和 OpenClaw 配置，导致排障困难
• 机器人能回消息了，就误以为已经完成初始化
• 把官方插件和社区插件当成完全一样的安全等级

跑通之后最值得做的两件事

1. 先用一个私聊或测试群验证最小闭环
2. 再决定要不要安装浏览器、文档处理或消息通知类技能

不要在“消息通路还没稳”时，就同时把技能市场、自动化和定时任务也一起叠上去。

遇到托管实例异常时，先这样排查

如果你用的是 ArkClaw 一类托管实例，遇到持续修复、反复重启或工具调用异常，先按这个顺序检查：

1. 确认实例状态是不是“运行中”
2. 确认浏览器能正常访问平台控制台
3. 在 Terminal 里执行 openclaw gateway restart
4. 再检查飞书授权和插件权限
5. 最后再看日志定位具体报错

如果平台本身提供了“自动修复”或“恢复出厂设置”，也要先确认有没有需要备份的工作区内容。