wecom-doc

star 3.9k

当用户提到企业微信文档、智能表格、创建文档、编辑文档、写文档时启用。优先复用 wecom channel 自动写入的文档 MCP 配置,并通过 mcporter 调用文档能力。

BytePioneer-AI By BytePioneer-AI schedule Updated 3/17/2026

name: wecom-doc description: 当用户提到企业微信文档、智能表格、创建文档、编辑文档、写文档时启用。优先复用 wecom channel 自动写入的文档 MCP 配置,并通过 mcporter 调用文档能力。 metadata: { "openclaw": { "emoji": "📄", "always": true, "requires": { "bins": ["mcporter"], }, "install": [ { "id": "mcporter", "kind": "node", "package": "mcporter", "bins": ["mcporter"], "label": "Install mcporter (npm)", }, ], },

}

企业微信文档 MCP

这个 skill 只负责通过 mcporter 调用企业微信文档 MCP,不要直接调用企业微信 Wedoc API。

使用时机

  • 用户要创建企业微信文档
  • 用户要创建企业微信智能表格
  • 用户要编辑机器人创建的企微文档或智能表格

前置检查

1. 检查 mcporter

先确认 mcporter 可执行。若未安装,提示用户安装;用户同意后执行:

npm install -g mcporter

安装完成后继续后续步骤,不要停在中间。

2. 确认 wecom-doc MCP 已配置

先执行:

mcporter list wecom-doc --output json

如果已经能正常返回 tool 列表,直接进入调用阶段。

如果返回 server not foundunknown server 或类似错误,读取:

~/.openclaw/wecomConfig/config.json

检查是否存在 mcpConfig.doc.typemcpConfig.doc.url。若存在,执行:

mcporter config add wecom-doc --type "<type>" --url "<url>"

添加完成后再次执行 mcporter list wecom-doc --output json 进行验证。

3. 自动配置失败时的引导

如果本地没有 mcpConfig.doc,说明当前 wecom 长连接还没成功拉到文档 MCP 配置。此时:

  • 如果能读取到 channels.wecom.botId,提示用户去企业微信授权当前机器人文档权限
  • 或让用户直接发送 StreamableHttp URL / JSON Config

当用户提供 URL 或 JSON Config 后,提取 url 并执行:

mcporter config add wecom-doc --type streamable-http --url "<url>"

配置完成后重新执行 mcporter list wecom-doc --output json,然后继续用户原始请求。

调用规则

  • 所有请求必须通过 mcporter call wecom-doc.<tool> --args '{...}' --output json 执行
  • 先用 mcporter list wecom-doc --output json 读取实际 tool 列表,不要硬编码 tool 名称和参数结构
  • create_doc 返回的 docid 要保存在当前会话里,后续编辑操作依赖它
  • 如果用户要编辑已有文档,但当前会话里没有机器人创建时返回的 docid,直接输出:

仅支持对机器人创建的文档进行编辑

文档工作流

新建普通文档

  1. 调用 create_doc,传 doc_type: 3
  2. 保存返回的 docid
  3. 如需写内容,调用 edit_doc_content

新建智能表格

  1. 调用 create_doc,传 doc_type: 10
  2. 保存返回的 docid
  3. 根据需要继续调用智能表格相关 tool

错误处理

  • 如果 mcporter call 返回 help_message,优先把其中面向用户的说明直接输出给用户
  • 如果返回 850001,说明还需要用户提供配置或授权,按上面的配置引导继续处理
  • 如果返回 daemon not runningconnection refused,提示用户先执行:
mcporter daemon start
Install via CLI
npx skills add https://github.com/BytePioneer-AI/openclaw-china --skill wecom-doc
Repository Details
star Stars 3,944
call_split Forks 345
navigation Branch main
article Path SKILL.md
Occupations
More from Creator
BytePioneer-AI
BytePioneer-AI Explore all skills →