{
  "markdown": "<p align=\"center\">\n  <h1 align=\"center\">Feishu Skills for OpenClaw</h1>\n  <p align=\"center\">\n    <strong>120+ 项飞书 API 实测经验，让你的 AI Agent 成为飞书自动化专家</strong>\n  </p>\n  <p align=\"center\">\n    <a href=\"https://github.com/alextangson/feishu_skills/stargazers\"><img src=\"https://img.shields.io/github/stars/alextangson/feishu_skills?style=social\" alt=\"Stars\"></a>\n    <a href=\"https://github.com/alextangson/feishu_skills/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"License\"></a>\n  </p>\n</p>\n\n---\n\n## 这是什么？\n\n一套**开箱即用**的飞书 API Skill 库，专为 [OpenClaw](https://github.com/openclaw/openclaw) AI Agent 框架设计。\n\n**不是 SDK，不是代码库** —— 而是 **Prompt 知识模板**，让 AI Agent 直接\"学会\"怎么正确调用飞书 API。\n\n### 核心价值\n\n- ✅ **实测验证**：所有 API 均通过实际调用测试\n- ✅ **Token 优化**：2026-03-07 优化，减少 65% token 消耗（2229 行 → 790 行）\n- ✅ **即插即用**：复制到 OpenClaw 即可使用\n- ✅ **权限清单**：每个 skill 标注所需权限\n\n### 更新日志\n\n**2026-03-07**\n- ✅ 优化所有 skills，token 减少 65%\n- ✅ 添加 Spark v1 ID 转换 API（feishu-contact）\n- ✅ 实测验证：Contact API、IM API、Token 获取\n- ✅ 新增 [QUICKSTART.md](./QUICKSTART.md) 快速开始指南\n\n---\n\n## Skill 目录\n\n| Skill | 能力 | API 数量 |\n|-------|------|---------|\n| [feishu-im](./feishu-im/SKILL.md) | 消息、群聊、卡片 | 25+ |\n| [feishu-bitable](./feishu-bitable/SKILL.md) | 多维表格 | 30+ |\n| [feishu-doc-writer](./feishu-doc-writer/SKILL.md) | 文档写入 | 15+ |\n| [feishu-drive](./feishu-drive/SKILL.md) | 文件管理 | 10 |\n| [feishu-task](./feishu-task/SKILL.md) | 任务管理 | 5 |\n| [feishu-calendar](./feishu-calendar/SKILL.md) | 日历日程 | 5 |\n| [feishu-approval](./feishu-approval/SKILL.md) | 审批流 | 5 |\n| [feishu-contact](./feishu-contact/SKILL.md) | 通讯录 | 10 |\n| [feishu-wiki](./feishu-wiki/SKILL.md) | 知识库 | 5 |\n| [feishu-card](./feishu-card/SKILL.md) | 交互卡片 | 10 |\n\n---\n\n## 快速开始\n\n### 1. 安装到 OpenClaw\n\n```bash\n# 克隆仓库\ngit clone https://github.com/alextangson/feishu_skills.git\n\n# 复制到 OpenClaw skills 目录\ncp -r feishu_skills/feishu-* ~/.openclaw/workspace/skills/\n\n# 重启 OpenClaw\n```\n\n### 2. 配置飞书应用\n\n1. 在 [飞书开放平台](https://open.feishu.cn/) 创建企业自建应用\n2. 开通所需权限（每个 Skill 文件顶部有 `required_permissions` 列表）\n3. 配置环境变量：\n\n```bash\nexport FEISHU_APP_ID=\"your_app_id\"\nexport FEISHU_APP_SECRET=\"your_app_secret\"\n```\n\n详细配置请参考 [OpenClaw 文档](https://github.com/openclaw/openclaw)。\n\n### 3. 复用本地 Token 缓存\n\n从 `feishu_skills` 根目录执行：\n\n```bash\nTOKEN=\"$(./scripts/get_feishu_token.sh)\"\n```\n\n- 脚本会把 token 写入 `./.feishu_token_cache.json`\n- 缓存未过期时直接复用，不重复调用换 token 接口\n- 默认在过期前 5 分钟自动刷新\n- 若业务接口返回 token 无效或 401，执行 `./scripts/get_feishu_token.sh --force-refresh` 后重试一次原请求\n\n---\n\n## 使用示例\n\n安装后，直接对话即可：\n\n```\n你：帮我在飞书群里发一条消息，通知大家明天开会\n\nAI：（自动读取 feishu-im Skill）\n好的，我会先读取本地 token 缓存，再发送消息...\n```\n\n```\n你：在多维表格里新增一条记录\n\nAI：（自动读取 feishu-bitable Skill）\n好的，我来创建记录...\n```\n\n---\n\n## 实测心法示例\n\n每个 Skill 都包含实战经验，例如：\n\n> **feishu-bitable**：日期字段必须转为 **13 位毫秒级时间戳**，这是最常踩的坑。\n\n> **feishu-doc-writer**：严禁并发写入，必须串行执行，否则 Block 顺序会错乱。\n\n> **feishu-im**：content 字段必须是**字符串化的 JSON**，不能直接传对象。\n\n这些坑，官方文档不会告诉你。\n\n---\n\n## 典型应用场景\n\n- **项目管理**：多维表格看板 + 任务管理 + 消息通知\n- **知识管理**：文档写入 + 知识库 + 文件管理\n- **审批自动化**：审批流 + 消息通知 + 数据记录\n- **团队协作**：群聊管理 + 交互卡片 + 日历排期\n\n---\n\n## Token Helper\n\n- 脚本路径：`./scripts/get_feishu_token.sh`\n- 凭证来源：`FEISHU_APP_ID` / `FEISHU_APP_SECRET`\n- 缓存文件：`./.feishu_token_cache.json`\n- 强制刷新：`./scripts/get_feishu_token.sh --force-refresh`\n\n---\n\n## 贡献\n\n欢迎提交 PR！详见 [CONTRIBUTING.md](CONTRIBUTING.md)。\n\n---\n\n## 关于\n\n### 📖 延伸阅读\n\n👉 [我的飞书知识库：AI Agent 实战经验分享](https://jvbmlo28x0.feishu.cn/wiki/YXOMw7tbIiFzIDkWj58cX9Sznsh)\n\n### 🔗 相关项目\n\n- [OpenClaw](https://github.com/openclaw/openclaw) - 开源 AI Agent 运行时\n\n---\n\n## License\n\nMIT\n",
  "bytes": 3493,
  "sha": "752b732a1cee0b26e3d4ced22610a97cc0874d28b5b3c152c6c45f7f0850d5bd",
  "repo_slug": "alextangson/feishu_skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_alextangson_feishu_skills_feishu_calenda_25a1e4fe/readme"
}