← 返回 Skills 市场
tinadu-ai

飞书连接问题解决方案

作者 NANA · GitHub ↗ · v1.0.1
cross-platform ✓ 安全检测通过
708
总下载
1
收藏
16
当前安装
2
版本数
在 OpenClaw 中安装
/install feishu-troubleshoot
功能描述
解决飞书连接中权限配置、机器人能力、事件订阅及长连接问题,确保机器人正常接收和回复消息。
使用说明 (SKILL.md)

飞书连接问题解决方案

解决 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
安全使用建议
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.
功能分析
Type: OpenClaw Skill Name: feishu-troubleshoot Version: 1.0.1 The skill bundle is a documentation-only resource providing troubleshooting steps and permission configurations for Feishu (Lark) integration. It contains no executable code, and the requested permission scopes in SKILL.md and README.md are standard for bot operations (IM, calendar, tasks). No indicators of malicious intent, data exfiltration, or prompt injection were found.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install feishu-troubleshoot
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /feishu-troubleshoot 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
- Updated troubleshooting steps for connecting OpenClaw to Feishu. - Simplified and reorganized permission JSONs for calendar and messaging features. - Streamlined instructions for configuring bot capabilities, event subscription, and application publishing. - Reduced repetition and merged overlapping troubleshooting scenarios. - Improved reference section for easier access to official documentation.
v1.0.0
Initial release of Feishu connectivity troubleshooting guide. - Provides step-by-step solutions for common Feishu (Lark) connection issues with OpenClaw, including permission configuration, bot setup, and long-connection (WebSocket) subscription. - Offers ready-to-import JSON for both calendar and bot permissions. - Lists full platform-side configuration steps: enabling bot, event subscription, permissions import, app publishing. - Includes troubleshooting advice for issues like no reply, missing send box, and unstable connectivity. - Supplies a full setup checklist for OpenClaw’s Feishu plugin, from installation through pairing. - References official documentation links for further help.
元数据
Slug feishu-troubleshoot
版本 1.0.1
许可证
累计安装 17
当前安装数 16
历史版本数 2
常见问题

飞书连接问题解决方案 是什么?

解决飞书连接中权限配置、机器人能力、事件订阅及长连接问题,确保机器人正常接收和回复消息。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 708 次。

如何安装 飞书连接问题解决方案?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install feishu-troubleshoot」即可一键安装,无需额外配置。

飞书连接问题解决方案 是免费的吗?

是的,飞书连接问题解决方案 完全免费(开源免费),可自由下载、安装和使用。

飞书连接问题解决方案 支持哪些平台?

飞书连接问题解决方案 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 飞书连接问题解决方案?

由 NANA(@tinadu-ai)开发并维护,当前版本 v1.0.1。

💬 留言讨论