飞书连接问题解决方案

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

Security Scan

The skill is an instruction-only troubleshooting guide for configuring Feishu (Lark) app permissions and long-connection/event settings; its steps, required scopes, and lack of installs or env-vars are consistent with that purpose.

Purpose & Capability

The name/description match the SKILL.md: it tells an operator how to enable robot capabilities, import permission JSON, configure long‑connection event subscriptions, and publish the app. There are no unexpected binaries, environment variables, or configuration paths requested. (Minor metadata inconsistencies: the package manifest lists a homepage and version 1.0.0, while registry metadata shows no homepage and version 1.0.1.)

Instruction Scope

Instructions are limited to steps in the Feishu/Open Platform web console and a recommendation to configure events after the OpenClaw gateway starts. The skill does not instruct reading local files, exporting secrets, calling external endpoints, or executing shell commands—no scope creep or covert data collection is present in the provided content.

Install Mechanism

Instruction-only skill with no install spec and no code files. Nothing is downloaded or written to disk by the skill itself, which is the lowest-risk installation model.

Credentials

The SKILL.md recommends importing tenant-level scopes that include message reading/sending and calendar/task access. Those scopes are coherent with enabling a bot and calendar features, but they are broad: tenant-level permissions (especially send_as_bot and calendar scopes) grant the app wide access within a tenant. The skill itself requests no environment variables, but granting the recommended scopes has high privilege implications and should be reviewed.

Persistence & Privilege

Skill does not request permanent inclusion (always:false), does not modify other skills or system config, and does not declare access to agent config paths. Autonomous invocation defaults are unchanged and are normal for skills.

Assessment

This skill is a straightforward guide for configuring a Feishu/Lark app and its requested permissions match that purpose. Before applying it: - Test in a development or limited tenant first rather than a production tenant. - Grant the minimum scopes needed; be cautious with tenant-level permissions like send_as_bot and calendar access because they allow broad access to messages and calendars. - Verify the app owner/backend that will handle events and tokens (ensure the service receiving long‑connection events is trusted and properly secured). - Confirm the repository/homepage and who maintains the app (skill.json references a GitHub URL, but the registry metadata shows no homepage). The version mismatch between registry metadata (1.0.1) and skill.json (1.0.0) is a minor inconsistency worth verifying. - Only publish tenant-wide changes after you understand the security and privacy impact for your organization.

解决 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