🔄 从旧版迁移到官方插件（保姆级）

适用于：之前使用本项目（独立桥接或 npm 插件）的老用户。
两种方式任选其一，效果一样。

迁移前须知

• ✅ 你之前创建的飞书应用（机器人）可以继续用，不需要重新创建
• ✅ App ID 和 App Secret 不变
• ✅ 迁移后聊天记录不受影响（记录在飞书端）
• ⚠️ 迁移过程中机器人会短暂离线（几分钟）

方式一：通过 OpenClaw 升级（推荐，最省事）

如果你的 OpenClaw 版本 ≥ 2026.2，升级后官方飞书插件已经内置，只需要：

1. 升级 OpenClaw

openclaw update

升级完成后会自动重启网关。

2. 添加飞书渠道

openclaw channels add

选择 Feishu → 粘贴你的 App ID → 粘贴你的 App Secret。

App ID 和 App Secret 在哪？之前可能保存在 ~/.clawdbot/secrets/feishu_app_secret，可以 cat 查看。
如果找不到，去 飞书开放平台 → 你的应用 → 凭证与基础信息 重新复制。

3. 补全飞书应用权限

官方插件支持图片、文件、流式输出等更多功能，需要在飞书开放平台补几个权限：

1. 打开 飞书开放平台 → 进入你的应用
2. 进入 权限管理 → 点击 批量导入
3. 粘贴以下内容一键导入：

{
  "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. 导入后 → 创建新版本 → 发布（让新权限生效）

4. 清理旧插件/桥接

...