← Back to Skills Marketplace
708
Downloads
1
Stars
16
Active Installs
2
Versions
Install in OpenClaw
/install feishu-troubleshoot
Description
解决飞书连接中权限配置、机器人能力、事件订阅及长连接问题,确保机器人正常接收和回复消息。
README (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
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install feishu-troubleshoot - After installation, invoke the skill by name or use
/feishu-troubleshoot - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is 飞书连接问题解决方案?
解决飞书连接中权限配置、机器人能力、事件订阅及长连接问题,确保机器人正常接收和回复消息。 It is an AI Agent Skill for Claude Code / OpenClaw, with 708 downloads so far.
How do I install 飞书连接问题解决方案?
Run "/install feishu-troubleshoot" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 飞书连接问题解决方案 free?
Yes, 飞书连接问题解决方案 is completely free (open-source). You can download, install and use it at no cost.
Which platforms does 飞书连接问题解决方案 support?
飞书连接问题解决方案 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 飞书连接问题解决方案?
It is built and maintained by NANA (@tinadu-ai); the current version is v1.0.1.
More Skills