wecom-doc

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 found、unknown server 或类似错误，读取：

~/.openclaw/wecomConfig/config.json

检查是否存在 mcpConfig.doc.type 和 mcpConfig.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 running 或 connection refused，提示用户先执行：

mcporter daemon start