dingtalk-doc-enterprise — 钉钉文档企业版操作

Ash

dingtalk-doc-enterprise — 钉钉文档企业版操作

v1.0.6

钉钉文档操作技能，支持读取、更新、追加文本和删除块。仅在明确识别为钉钉文档时使用，通过官方 API 调用，需要提供钉钉应用凭证。

1· 90·0 当前·0 累计

by @shyzhen (Ash)·MIT-0

通信工具文档工具开发工具自动化

下载技能包

License

MIT-0

最后更新

2026/4/11

安全扫描

VirusTotal

无害

查看报告

OpenClaw

安全

high confidence

该技能的代码、指令和请求的凭证与钉钉文档管理助手一致，不要求无关的秘密或安装远程代码。

评估建议

该技能似乎做了它宣称的事情：运行一个本地 Node 脚本，调用官方钉钉端点，需要您的钉钉应用凭证。安装前，请验证您信任作者并检查 doc-enterprise.js（已包含）——确认端点仅为 api.dingtalk.com / oapi.dingtalk.com 且没有意外的外部 URL。仅在您打算使用这些应用权限时提供 DINGTALK_CLIENTID/DINGTALK_CLIENTSECRET，避免提供高权限应用秘密，除非必要。注意，脚本可以覆盖整个文档（更新/overwriteContent）和删除块——在非关键文档上测试，并确保在钉钉中正确配置每用户权限。最后，确保您的 Node 运行时支持全局 fetch 或提供适当的运行时；否则，脚本可能会失败，但这是一项操作问题，而不是安全问题。...

详细分析 ▾

✓ 用途与能力

名称/描述、SKILL.md、README 和包含的脚本都集中在读取/更新钉钉（alidocs）文档。所需二进制文件（node）和环境变量（DINGTALK_CLIENTID、DINGTALK_CLIENTSECRET）适用于调用钉钉 API。

✓ 指令范围

运行时指令明确限制为使用钉钉文档，并描述了要运行的确切命令（读取、块、更新、追加文本、删除）。脚本仅访问与识别操作员相关的环境变量（DINGTALK_OPERATOR_ID、OPENCLAW_SENDER_ID/DINGTALK_SENDER_ID）并调用钉钉端点；它不指示读取无关的本地文件或将数据泄露到第三方端点。

ℹ 安装机制

没有远程安装步骤（仅指令安装规格）。存储库包含一个本地 Node 脚本（doc-enterprise.js），SKILL.md 指示代理直接执行它。与下载远程存档相比，这是低风险的，但用户在运行脚本之前应该查看它，因为它将在本地执行。

✓ 凭证需求

请求的环境变量（DINGTALK_CLIENTID、DINGTALK_CLIENTSECRET）用于获取钉钉访问令牌。操作员识别的可选变量（DINGTALK_OPERATOR_ID、OPENCLAW_SENDER_ID、DINGTALK_SENDER_ID）由脚本使用并且合理。技能不请求无关的凭证或广泛的系统秘密。

✓ 持久化与权限

always 为 false，技能不请求持久的高权限或修改其他技能或系统设置。技能仅在根据 SKILL.md 规则调用时运行；默认允许自主调用，但对于技能来说这是普通的。

⚠ doc-enterprise.js:18

环境变量访问与网络发送结合。

安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

查看条款 ↗

运行时依赖

无特殊依赖

版本

latestv1.0.62026/4/10

- 澄清使用规则：技能仅在消息或上下文明确指示为钉钉文档时触发。 - 更新触发条件：不会响应泛型文档/编辑请求，除非上下文确认为钉钉文档。 - 扩展“不触发”列表以排除其他文档平台和泛型链接。 - 添加强调前提：在运行命令前确认对象为钉钉文档。 - 整体文档编辑和指令澄清。

● 无害

安装命令点击复制

官方npx clawhub@latest install dingtalk-doc-enterprise

镜像加速npx clawhub@latest install dingtalk-doc-enterprise --registry https://cn.clawhub-mirror.com

技能文档

使用同目录脚本 doc-enterprise.js 调用钉钉文档企业 API。OpenClaw 不会因为目录里存在 .js 文件就自动执行它；当任务命中本 skill 时，应按下面规则主动调用脚本。

何时使用

🔑 触发关键词

只有在已经确认对象是钉钉文档时，同时消息包含以下任一关键词时，优先使用本 skill： ... （此处为完整的 SKILL.md 中文翻译，太长省略，建议根据需要补充完整）

# 钉钉文档企业版使用同目录脚本 doc-enterprise.js 调用钉钉文档企业 API。OpenClaw 不会因为目录里存在 .js 文件就自动执行它；当任务命中本 skill 时，应按下面规则主动调用脚本。

何时使用

🔑 触发关键词

只有在已经确认对象是钉钉文档时，同时消息包含以下任一关键词时，优先使用本 skill： | 类别 | 关键词 | |------|--------| | 平台名 | 钉钉文档、钉钉知识库、alidocs | | 读取类 | 总结、读取、查看、浏览、列出结构 | | 修改类 | 更新、修改、追加、删除、覆写 | | 对象 | 文档、链接、这篇、这个文档 | 组合示例：

"总结一下这篇钉钉文档"
"读取这个 alidocs 链接"
"更新文档内容"
"删除第三段"

✅ 触发场景（优先级从高到低）

| 场景 | 示例 | 动作 | |------|------|------| | 钉钉文档链接 | alidocs.dingtalk.com/i/nodes/xxx | 自动识别，调用 read 或 blocks | | 钉钉上下文 + 链接 | "总结 https://alidocs.dingtalk.com/..." | 根据意图选择命令 | | 明确命令 | "总结这篇文档"、"读取这个 alidocs 链接" | 根据意图选择命令 | | 已知上下文是钉钉文档 | 前文已给出 alidocs 链接，后续说"更新文档"、"删除某段" | 调用对应命令 | | 结构查询 | "列出结构"、"这个 alidocs 有哪些章节" | 调用 blocks |

❌ 不触发的场景

创建新文档（脚本未实现 create）
没有文档链接、docKey、或明确钉钉文档上下文，却要求修改文档
用户只说“总结文档”“更新这个链接”等泛化请求，但上下文无法确认对象是钉钉文档
与钉钉无关的文档系统，例如本地 Markdown、飞书文档、语雀、Google Docs

🔑 链接识别规则

支持以下格式的钉钉文档链接： ``


https://alidocs.dingtalk.com/i/nodes/
https://alidocs.dingtalk.com/i/nodes/?utm_scene=person_space
https://alidocs.dingtalk.com/i/nodes/?utm_scene=team_space
alidocs.dingtalk.com/i/nodes/  （无 https）

`



脚本会自动提取

 部分。

运行前提

必需环境变量：

DINGTALK_CLIENTID

DINGTALK_CLIENTSECRET

可选环境变量：

DINGTALK_OPERATOR_ID：默认操作人 unionId

OPENCLAW_SENDER_ID：由 OpenClaw/连接器注入，用于自动识别当前发送者

OPENCLAW_SENDER_NAME

脚本优先使用 DINGTALK_OPERATOR_ID。若未设置，则尝试使用 OPENCLAW_SENDER_ID

 查询 unionId。

执行入口

脚本文件：

doc-enterprise.js



执行时使用绝对路径，形式如下：

`

bash
node /absolute/path/to/doc-enterprise.js  [args]

`



当本 skill 引用了相对路径文件时，将其相对于

SKILL.md

 所在目录解析成绝对路径后再执行。

命令映射

1. 读取文档概览

适用：

用户只说“读取这篇文档”
用户贴了一个文档链接，想先快速看内容概况

执行：

`

bash
node /absolute/path/to/doc-enterprise.js read

`



说明：

read 只输出块列表和部分预览文本


适合快速探测，不适合直接拿来做高质量总结

`2. 获取完整结构或用于总结`



适用：

用户要求“总结这篇文档”
用户要求“列出结构”

后续操作需要 blockId

执行：

`

bash
node /absolute/path/to/doc-enterprise.js blocks

`



说明：

优先用 blocks 获取更完整的块结构

做总结前，先读取 blocks 的结果，再基于结果总结

删除或追加前，如果用户没有给出 blockId，先运行 blocks

`3. 覆写整篇文档`



适用：

用户明确要求“更新整篇文档”
用户给出了新的 Markdown 内容

执行：

`

bash
node /absolute/path/to/doc-enterprise.js update

`



说明：

这是整篇覆写，不是局部编辑

若用户只是想在末尾补一段，不要用 update

`4. 追加文本到段落块`



适用：

用户要求在某个已知段落块后追加文本

已经拿到了目标 blockId

执行：

`

bash
node /absolute/path/to/doc-enterprise.js append-text

`



说明：

如果没有 blockId，先运行 blocks


仅在目标块确实是段落块时使用

“没有 blockId” 不代表不触发本 skill，而是先查结构再执行追加

`5. 删除块元素`



适用：

用户明确要求删除某一段或某个块

已经拿到了目标 blockId

执行：

`

bash
node /absolute/path/to/doc-enterprise.js delete

`



说明：

删除前先确认目标块，避免误删

如果用户说“删除第 3 段”，先运行 blocks 找到对应 blockId

“没有 blockId” 不代表不触发本 skill，而是先查结构再执行删除

`工作流程`

从用户消息中提取文档链接或 docKey。
先确认对象确实是钉钉文档，再判断是读取、总结、列结构、覆写、追加，还是删除。

需要 blockId 时，先运行 blocks。

读取概览用 read；做总结或定位块时优先用 blocks。


执行脚本后，把结果用自然语言返回给用户。

`错误处理`



若脚本报以下错误，按对应方式处理：

缺少 DINGTALK_CLIENTID 或 DINGTALK_CLIENTSECRET：提示未配置钉钉应用凭证

缺少 operatorId：提示配置 DINGTALK_OPERATOR_ID，或确认连接器是否传入 OPENCLAW_SENDER_ID

forbidden.accessDenied：提示当前用户对该文档无权限

docNotExist：提示文档不存在，检查链接或 docKey

blockNotExist：提示块不存在，先重新运行 blocks 核对

paramError：提示参数格式错误，优先检查链接与文档 ID

`限制`

当前脚本未实现创建文档，不要承诺或尝试 create

read 只适合概览，不足以替代完整正文提取

追加和删除依赖 blockId


覆写会直接替换整篇文档内容

`参考`

背景说明与人工阅读材料：README.md

实际执行脚本：doc-enterprise.js`

数据来源：ClawHub ↗ · 中文优化：龙虾技能库

OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务

License

运行时依赖

版本

安装命令 点击复制

技能文档

何时使用

🔑 触发关键词

何时使用

🔑 触发关键词

✅ 触发场景（优先级从高到低）

❌ 不触发的场景

🔑 链接识别规则

运行前提

执行入口

命令映射

1. 读取文档概览

2. 获取完整结构或用于总结

3. 覆写整篇文档

4. 追加文本到段落块

5. 删除块元素

工作流程

错误处理

限制

参考

安装命令点击复制

`2. 获取完整结构或用于总结`

`3. 覆写整篇文档`

`4. 追加文本到段落块`

`5. 删除块元素`

`工作流程`

`错误处理`

`限制`

`参考`