OpenClaw 已内置官方飞书插件 @openclaw/feishu,功能更完整、维护也更及时。本指南提供新用户从零配置、老用户迁移至官方插件的路线,以及常见问题排查清单。
一、老用户迁移到官方插件(两种方式任选)
适用人群:以前用过独立桥接或 npm 插件,现需迁到 OpenClaw 内置官方飞书插件。
迁移前须知
- 飞书应用可继续使用,无需重建
- App ID / App Secret 不变
- 聊天记录不受影响(记录在飞书端)
- 迁移时机器人会短暂离线(几分钟)
方式一:通过 OpenClaw 升级(推荐)
前提:OpenClaw 版本 ≥ 2026.2。
- 升级 OpenClaw:升级完成会自动重启网关。
- 添加飞书渠道:选择 Feishu → 填 App ID → 填 App Secret。
- App Secret 可能位于
~/.clawdbot/secrets/feishu_app_secret - 若找不到:去飞书开放平台应用 → 凭证与基础信息 复制
- App Secret 可能位于
- 补全飞书应用权限: 去飞书开放平台 → 权限管理 → 批量导入,粘贴 JSON:
{"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",

