前言¶
在飞书里做自动化，常见路径是自建应用、走 Bot、再向管理员申请租户级权限。对个人开发者或小团队来说，审批周期长，且很多操作其实只需要「当前登录用户」能做的事。若你的 Agent 运行在 OpenClaw 或 EnClaws 上，又希望直接读写文档、发消息、改日历和任务，就需要一套按通用 SKILL.md 组织的集成说明，而不是零散的 API 笔记。
下面介绍 SkillHub 上的 feishu-skills（坐标 @user_3ad8e894/feishu-skills，版本 1.0.0）：社区来源的 ai-agent 类 Skill，面向 OpenClaw 与 EnClaws，强调用用户个人 OAuth Token 访问飞书能力，而不是依赖 Bot Owner 权限，也无需管理员授权。
这是什么¶
feishu-skills 是飞书集成的完整技能包。发布者为 SkillHub 用户 user_3ad8e894，标签标明 requires_api_key=false（以 SkillHub 页面元数据为准）。
官方简介概括为：让 AI Agent 能够读写飞书文档、发送消息，并管理日历、任务和多维表格；运行环境以 OpenClaw 和 EnClaws 为主。与「先建企业机器人、再申请全租户权限」相比，这条路径更贴近「谁授权、谁的数据就按谁的令牌操作」。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在页面单独展开接口清单的部分不在此臆造：
- 飞书文档：读写文档类内容（具体 API 与字段以 Skill 包内 SKILL.md 为准）。
- 消息：通过集成能力发送消息。
- 日历：管理日历相关资源。
- 任务：管理任务。
- 多维表格：操作多维表格（飞书 Bitable 场景）。
鉴权模型：用户个人 OAuth Token，而非 Bot Owner 权限；无需管理员授权（官方表述）。
安装与启用¶
SkillHub 页面给出的安装指引是：先阅读官方安装文档，再安装本 Skill。
1. 准备 SkillHub CLI¶
若尚未安装 CLI，按 SkillHub 安装与优先源配置 检查或安装：
command -v skillhub && skillhub --version
未安装时，文档推荐执行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装 feishu-skills¶
安装时必须用 --dir 指向当前 Agent 正在使用的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法加载。
skillhub install @user_3ad8e894/feishu-skills --dir <你的 Agent skills 目录>
常用客户端的 skills 路径（摘自 SkillHub 安装文档，按你实际使用的工具选用）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
OpenClaw 及其变体（文档列出的 NanoBot、PicoClaw、memUBot、MaxClaw、CoPaw、AutoClaw、KimiClaw、QClaw、EasyClaw、workbuddy 等）通常也有各自的 skills 目录，需与当前运行环境一致。
3. 让 Agent 完成配置¶
SkillHub 页面提供的提示词范式为：让 AI 根据 https://skillhub.cn/install/skillhub.md 安装 @user_3ad8e894/feishu-skills。安装完成后，OAuth 授权、令牌存放与具体工具调用步骤应以 Skill 包内的 SKILL.md 为准；公开页面未列出单独的配置字段名，本文不编造。
典型用法¶
公开资料未附带可逐行复制的业务脚本示例。可复现的流程是：
- 按上一节将
@user_3ad8e894/feishu-skills安装到对应 Agent 的 skills 目录。 - 在 OpenClaw 或 EnClaws 中加载该 Skill，按 SKILL.md 完成飞书个人 OAuth 授权。
- 在对话中用自然语言描述目标（例如整理文档、发送通知、更新任务或多维表格记录），由 Agent 按 Skill 内说明调用飞书能力。
具体请求参数、错误码与速率限制需以飞书开放平台文档及 Skill 内指引为准。
适用场景与注意¶
适合谁
- 已在或计划使用 OpenClaw、EnClaws 的开发者，希望 Agent 直接操作飞书文档、消息、日历、任务与多维表格。
- 希望用个人 OAuth 完成授权，避免走 Bot Owner 与管理员审批链路的场景。
需要注意
- 来源为 community：维护节奏与官方飞书 SDK 文档可能不同步，升级前建议在 SkillHub 查看版本 1.0.0 是否有更新。
- 环境绑定：简介明确面向 OpenClaw / EnClaws；Cursor、Codex 等仅能通过「把 Skill 装到对应 skills 目录」尝试加载，是否与这些客户端的全部能力兼容，需以实际 Agent 行为为准。
- 权限边界：个人 OAuth 只能代表授权用户可访问的资源；不能替代企业合规审计或跨租户管理。
- 页面统计（截至资料抓取）：SkillHub 评分 100000，下载约 748 次；安装计数为 0 仅表示商店侧统计，不代表不可用。
结尾¶
feishu-skills 把飞书文档、消息、日历、任务与多维表格串成一套面向 Agent 的集成 Skill，并用个人 OAuth 降低管理员介入成本。若要查看元数据或安装入口，可打开 SkillHub 页面：
- https://www.skillhub.cn/skills/user_3ad8e894/feishu-skills
- https://api.skillhub.cn/user_3ad8e894/feishu-skills
