SkillHub

feishu-troubleshoot

v1.0.1

解决飞书连接中权限配置、机器人能力、事件订阅及长连接问题,确保机器人正常接收和回复消息。

Sourced from ClawHub, Authored by NANA

Installation

Please help me install the skill `feishu-troubleshoot` from SkillHub official store. npx skills add TinaDu-AI/feishu-troubleshoot

飞书连接问题解决方案

解决 OpenClaw 连接飞书时的常见问题。

问题一:机器人不回复

导入以下权限:

{
  "scopes": {
    "tenant": [
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:message.reactions:read",
      "im:resource"
    ],
    "user": [
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

问题二:应用平台检查

1. 启用机器人能力

路径:飞书开放平台 → 你的应用 → 应用能力机器人 - 开启「机器人能力」 - 配置机器人名称

2. 配置事件订阅(长连接)

⚠️ 必须在 OpenClaw 网关启动后再配置

路径:飞书开放平台 → 你的应用 → 事件与回调 - 订阅方式:「使用长连接接收事件」 - 添加事件im.message.receive_v1

3. 配置权限

路径:飞书开放平台 → 你的应用 → 权限管理 - 点击「批量导入」 - 粘贴 JSON 权限 - 保存

4. 发布应用

路径:飞书开放平台 → 你的应用 → 版本管理与发布 - 创建版本 → 提交发布

问题三:日历权限开放

导入以下权限:

{
  "scopes": {
    "tenant": [
      "calendar:calendar",
      "calendar:calendar:readonly",
      "task:task:write",
      "task:task:read",
      "contact:user.employee_id:readonly"
    ],
    "user": [
      "calendar:calendar",
      "calendar:calendar:readonly",
      "task:task:write",
      "task:task:read"
    ]
  }
}

参考

  • 飞书开放平台:https://open.feishu.cn/app
  • OpenClaw 文档:https://docs.openclaw.ai