Dingtalk Doc

Name: Dingtalk Doc
Rating: 3.5 (1 reviews)
Author: suchasplus

By suchasplus 👁 7 views ▲ 0 votes

Unofficial OpenClaw plugin that integrates DingTalk Doc (AliDocs) MCP tools into agent workflows

GitHub

Install

npm install openclaw-dingtalk-doc

Configuration Example

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

README

# openclaw-dingtalk-doc

非官方的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地址](https://aihub.dingtalk.com/#/detail?instanceId=377958&detailType=instanceMcpDetail&mcpId=9629)

## 功能

封装了钉钉文档全部 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, 再安装本插件

```bash
npm install openclaw-dingtalk-doc
```
最后执行 `openclaw gateway restart`

## 配置


### 命令行方式

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

### 配置文件方式

在 `openclaw.json` 中添加：

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


## 许可证

MIT

integration