openclaw-dingtalk-doc

English Version

非官方的DingTalk Doc - OpenClaw 插件，将钉钉文档（AliDocs）的 MCP 工具集成到 OpenClaw Agent 工作流中。

项目目的

钉钉官方的CLI目前还不支持钉钉文档的操作.

Cursor / Claude Code / Codex 接了钉钉MCP可以直接使用, 但是OpenClaw不可以.

2026.3.31版本的OpenClaw, 已经支持了MCP Client的接入，但是:

• MCP server 已配置成功，只说明 OpenClaw 认识这个 MCP endpoint
• MCP 工具能否被当前主 agent 调到，取决于这些工具有没有作为 tool 注册并通过全局/agent allow-deny
• MCP 工具能否被 subagent 调到，还要再过一层 tools.subagents.tools.allow/deny

而确认最终 tool name，最直接的方法不是看 openclaw mcp get，而是看当前会话里的 /tools 输出 因为 openclaw mcp get 只是在看 mcp.servers 里的注册定义；官方文档明确说 /mcp 只是把 MCP server definition 写进配置，真正“当前这个 agent 在这次会话里现在能用什么工具”，要看 /tools，而且 /tools 展示的是当前会话运行时实际可达的工具，不是静态配置目录。

所以钉钉文档MCP 虽然“注册到了配置里”，但并没有被运行时发现并注入成可调用 tools。所以 /tools 里看不到，是它没装载进模型工具面。

所以仿照openclaw-lark开发了这个插件, 暴露工具注入到OpenClaw Agent Turn中, 让OpenClaw也可以执行钉钉文档的自动化任务.

钉钉文档MCP地址

功能

封装了钉钉文档全部 15 个 MCP 工具，注册为 OpenClaw 工具：

文档工具

• create_document — 创建在线文档
• get_document_content — 获取文档内容（Markdown）
• get_document_info — 获取文档元信息
• update_document — 更新文档内容
• search_documents — 搜索文档

Block 工具

• list_document_blocks — 列出文档 block
• insert_document_block — 插入 block
• update_document_block — 更新 block
• delete_document_block — 删除 block

文件工具

• create_file — 创建文件/文件夹
• create_folder — 创建文件夹
• list_nodes — 列出子节点
• download_file — 获取下载凭证
• get_file_upload_info — 获取上传凭证
• commit_uploaded_file — 提交上传文件

安装

需要 2026.3.31 之后的 OpenClaw 版本，同时进行 MCP 的配置（如下）。

先配置 MCP，再安装本插件：

npx -y openclaw-dingtalk-doc install

卸载：

npx -y openclaw-dingtalk-doc uninstall

安装/卸载后执行 openclaw gateway restart 使配置生效。

配置

命令行方式

openclaw mcp set dingtalk-doc '{ "transport": "streamable-http", "url": "https://mcp-gw.dingtalk.com/server/$YOUR_PERSONAL_PATH?key=$YOUR_PERSONAL_KEY" }'

配置文件方式

在 openclaw.json 中添加：

{
  "mcp": {
    "servers": {
      "dingtalk-doc": {
        "transport": "streamable-http",
        "url": "https://mcp-gw.dingtalk.com/server/$YOUR_PERSONAL_PATH?key=$YOUR_PERSONAL_KEY"
      }
    }
  }
}

许可证

MIT