钉钉 Agent 技能库（dingtalk-skills）

English | 中文

---

已适配 OpenClaw 🦞 & Hermes，可从 ClawHub · Skills.sh 一键安装。

让 AI Agent 直接操作钉钉——无需手写 API 调用，无需手动管理 Token，对话即操作。

基于 Anthropic skills 规范 构建，仅依赖 curl，无需安装 Python、SDK 或任何第三方库。安装一行命令，Agent 即可理解"什么时候该调钉钉 API、该调哪个、参数怎么填"，并自动管理配置、错误处理。

为什么用这个

• 对话即操作："帮我在任务表里加三条记录" → Agent 自动完成，无需你知道任何 API
• 零依赖：仅使用 curl 发起 HTTP 请求，无需安装 Python、SDK 或任何第三方库
• 一次配置，永久生效：首次使用时 Agent 统一询问 appKey/appSecret/operatorId，写入 ~/.dingtalk-skills/config，后续所有技能直接复用，不再重复问

长期目标

本项目有两条并行的长期主线：

1. 永远只依赖 curl 不引入任何 SDK、运行时或第三方库。只要系统有 curl，技能就能运行。这保证了最大的可移植性，也让技能在任何 Agent 环境中都能免安装直接使用。

2. 将每次调用消耗的 Token 压到极限 Agent 每次执行任务都需要将技能文件装入上下文，skill 文件本身就是成本。我们的目标不只是「能用」，而是在保证正确率的前提下，把 SKILL.md 和 references/api.md 写得尽可能精炼——删掉所有冗余解释，用最短的指令表达最完整的语义。每一个字都要赚回自己的位置。

技能纵览

技能	状态	说明	已上架平台
dingtalk-document	✅ 已上线	知识库与文档的创建、查询、目录浏览、内容读写、成员管理	🦞 ClawHub · Skills.sh
dingtalk-ai-table	✅ 已上线	AI 表格的工作表管理、字段管理、记录增删改查	🦞 ClawHub · Skills.sh
dingtalk-message	✅ 已上线	消息发送：Webhook 机器人、单聊/群聊、工作通知	🦞 ClawHub · Skills.sh
dingtalk-todo	✅ 已上线	待办管理：创建、查询、更新、完成、删除	🦞 ClawHub · Skills.sh
dingtalk-contact	✅ 已上线	通讯录：搜索用户/部门、用户详情、部门树、成员列表	🦞 ClawHub · Skills.sh
dingtalk-ai-web-search	✅ 已上线	网页搜索：关键词搜索、时间过滤、JSON 输出	🦞 ClawHub · Skills.sh
dingtalk-calendar	✅ 已上线	日程：CRUD、闲忙、视频会议、会议室、签到签退	🦞 ClawHub · Skills.sh
dingtalk-knowledge-search	✅ 已上线	知识库搜索、文档读取导出 Markdown、图片/diagram、表格 CSV、文件下载、PDF 转文本	🦞 ClawHub · Skills.sh
dingtalk-approval	🗓️ 计划中	审批流程管理	—
dingtalk-attendance	🗓️ 计划中	考勤打卡管理	—
dingtalk-meeting	🗓️ 计划中	视频会议管理	—

快速开始

前置条件

1. 在钉钉开放平台创建企业内部应用
2. 开通对应 API 权限（知识库 / AI 表格 / 机器人消息 / 待办 等）
3. 准备好 appKey、appSecret，以及操作人的钉钉 userId（Agent 会引导你完成配置）

安装技能

每个技能支持三种安装方式（ClawHub / skills.sh / Hermes）：

1. ClawHub

clawhub install breath57/dingtalk-document

2. skills.sh（全通用方式，支持 Cursor、Claude、Copilot、🦞 OpenClaw 等几乎所有 Agent）

npx skills add breath57/dingtalk-skills@dingtalk-document

3. Hermes

npx skills add breath57/dingtalk-skills@dingtalk-document --agent hermes-agent -y

一键安装全部：

npx skills add breath57/dingtalk-skills \
  --skill dingtalk-document dingtalk-ai-table dingtalk-message dingtalk-todo dingtalk-contact dingtalk-ai-web-search dingtalk-calendar dingtalk-knowledge-search

一键安装全部（Hermes）：

npx skills add breath57/dingtalk-skills \
  --skill dingtalk-document dingtalk-ai-table dingtalk-message dingtalk-todo dingtalk-contact dingtalk-ai-web-search dingtalk-calendar dingtalk-knowledge-search \
  --agent hermes-agent -y

开口说话

安装后，Agent 会在首次运行时检查 ~/.dingtalk-skills/config，缺什么一次性问清楚，自动写入。之后直接对话：

"查看我的钉钉知识库列表"
"往 AI 表格的'需求池'工作表添加一条记录：标题=登录优化，优先级=高"
"发群消息说明天上午十点开周会，Markdown 格式"
"帮我建一个待办：下周五前完成竞品分析报告"

---

技能详情

dingtalk-document — 钉钉知识库 & 文档

🦞 ClawHub · dingtalk-document

安装

# 1. ClawHub
clawhub install breath57/dingtalk-document

# 2. skills.sh（全通用方式，支持 Cursor / Claude / Copilot / 🦞 OpenClaw 等几乎所有 Agent）
npx skills add breath57/dingtalk-skills@dingtalk-document

# 3. Hermes
npx skills add breath57/dingtalk-skills@dingtalk-document --agent hermes-agent -y

能力	说明
查询知识库列表	获取当前用户有权访问的全部知识库
查询知识库信息	按 workspaceId 获取知识库详情
浏览目录结构	列出知识库下的文档/文件夹节点树
查询节点信息	按 nodeId 或文档链接获取节点详情
创建文档/文件夹	在指定知识库/目录下新建文档或文件夹
读取文档内容	获取文档正文的 Block 结构（含标题、段落、列表、表格等）
写入/覆盖文档内容	用 Block 结构替换文档正文
删除文档	从知识库中删除指定文档
成员权限管理	添加/移除文档协作成员及权限级别

示例："把这份会议纪要写入知识库'项目文档'下的'2026-03'文件夹" → Agent 自动查目录、建文档、写内容。

---

dingtalk-ai-table — 钉钉 AI 表格

🦞 ClawHub · dingtalk-ai-table

安装

# 1. ClawHub
clawhub install breath57/dingtalk-ai-table

# 2. skills.sh（全通用方式，支持 Cursor / Claude / Copilot / 🦞 OpenClaw 等几乎所有 Agent）
npx skills add breath57/dingtalk-skills@dingtalk-ai-table

# 3. Hermes
npx skills add breath57/dingtalk-skills@dingtalk-ai-table --agent hermes-agent -y

能力	说明
列出工作表	获取 AI 表格内所有工作表及 ID
查询/新建/删除工作表	管理 AI 表格内的工作表
列出字段	获取工作表全部字段名称与类型（text / number / date 等）
新建/更新/删除字段	管理列定义
新增记录	批量向工作表插入数据行
查询记录列表	分页读取所有记录，支持翻页
更新记录	按 recordId 修改指定字段值
删除记录	按 recordId 批量删除数据行

示例："查一下任务表里状态是'进行中'的所有记录" → Agent 自动拉取字段定义、翻页读取、过滤返回。

---

dingtalk-message — 钉钉消息发送

🦞 [ClawHub · dingtalk-message](https://clawhub.ai/breath57/dingtalk-mess