wecom doc
- Repo stars 3,936
- Author repo openclaw-china
- Domain
- Documentation
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @BytePioneer-AI · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- macOS · Linux · Windows
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 企业微信文档 MCP
这个 skill 只负责通过 `mcporter` 调用企业微信文档 MCP,不要直接调用企业微信 Wedoc API。
## 使用时机
- 用户要创建企业微信文档
- 用户要创建企业微信智能表格
- 用户要编辑机器人创建的企微文档或智能表格
## 前置检查
### 1. 检查 mcporter
先确认 `mcporter` 可执行。若未安装,提示用户安装;用户同意后执行:
```bash
npm install -g mcporter
```
安装完成后继续后续步骤,不要停在中间。
### 2. 确认 wecom-doc MCP 已配置
先执行:
```bash
mcporter list wecom-doc --output json
```
如果已经能正常返回 tool 列表,直接进入调用阶段。
如果返回 `server not found`、`unknown server` 或类似错误,读取:
```bash
~/.openclaw/wecomConfig/config.json
```
检查是否存在 `mcpConfig.doc.type` 和 `mcpConfig.doc.url`。若存在,执行:
```bash
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` 并执行:
```bash
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`,提示用户先执行:
```bash
mcporter daemon start
```
Sections and files
Listed in source order.
sections -> See the original source for section headings
terms -> No English key terms available
files/cmd -> mcporter · server not found · unknown server · mcpConfig.doc.type · mcpConfig.doc.url · mcporter list wecom-doc --output json · mcpConfig.doc · channels.wecom.botId
body sha256 -> 721306b5cec2