wecom-deep-op - 企业微信全能操作 Skill

基于微信官方插件 @wecom/wecom-openclaw-plugin v1.0.13+，一站式企业微信自动化解决方案

wecom-deep-op 是对企业微信官方 MCP 服务的统一封装，你可以方便操作文档、日历、会议、待办、通讯录所有企业微信MCP能力，充分发挥 OpenClaw 与企业微信的协同能力。

重要：请务必先阅读前置条件！

📋 前置条件

✨ 核心优势

🚀 快速开始

1. 前置条件

• ✅ OpenClaw 已安装（v0.5.0+）
• ✅ Node.js 环境（v18+）
• ✅ 已安装 @wecom/wecom-openclaw-plugin（官方插件）
• ✅ 企业微信管理员已创建 BOT 并配置 MCP 权限

2. 安装 Skill

# 方法1: 从Clawhub安装（推荐）
clawhub install wecom-deep-op

# 方法2: 本地安装（开发中）
cd /path/to/wecom-deep-op
npm install
npm run build

3. 授权配置

重要： 本 Skill 不会也不应该包含任何企业微信的敏感凭证。你需要自己完成授权。

Step 1: 获取企业微信 BOT 的 MCP 权限

1. 登录 企业微信管理后台
2. 进入「应用管理」→ 「自建应用」→ 选择你的 BOT 应用
3. 在「权限管理」中开通以下 MCP 权限：
   • ✅ 文档管理（读写）
   • ✅ 日程管理（读写）
   • ✅ 会议管理（创建/查询/取消）
   • ✅ 待办事项（读写）
   • ✅ 通讯录查看（受限范围）
4. 保存后，复制 uaKey 参数（在 MCP 设置页面可见）

Step 2: 配置 OpenClaw

编辑 OpenClaw 配置文件（或通过 mcporter）：

// ~/.openclaw/workspace/config/mcporter.json
{
  "mcpServers": {
    "wecom-deep-op": {
      "baseUrl": "https://qyapi.weixin.qq.com/mcp/bot/combined?uaKey=YOUR_UA_KEY"
    }
  }
}

注意：

• YOUR_UA_KEY 替换为企业微信 BOT 真实的 uaKey
• 该配置仅为示例，实际使用时会根据技能部署情况调整端点
• 所有 UA_KEY 必须通过环境变量或配置文件管理，禁止硬编码

Step 3: 测试连接

# 使用 mcporter 测试
mcporter --config ~/.openclaw/workspace/config/mcporter.json call wecom-deep-op.ping "{}"

期望返回：

{
  "errcode": 0,
  "errmsg": "ok",
  "data": {
    "service": "wecom-deep-op",
    "version": "1.0.0",
    "status": "healthy"
  }
}

📚 使用指南

统一调用模式

所有操作都通过 wecom_mcp tool 调用：

# 语法
wecom_mcp call wecom-deep-op.<function_name> '<json_params>'

# 示例：创建文档
wecom_mcp call wecom-deep-op.doc_create '{"doc_name": "项目周报", "content": "# 周报\n\n..."}'

# 示例：查询日程
wecom_mcp call wecom-deep-op.schedule_list '{"start_time": "2026-03-21 00:00:00", "end_time": "2026-03-22 00:00:00"}'

📄 文档管理 (doc_*)

创建文档

wecom_mcp call wecom-deep-op.doc_create '{"doc_type": 3, "doc_name": "会议纪要"}'

返回：{ "errcode": 0, "docid": "xxx", "url": "https://..." }

读取文档

# 首次调用（开始导出）
wecom_mcp call wecom-deep-op.doc_get '{"docid": "DOCID", "type": 2}'

# 轮询（如果 task_done=false，用返回的 task_id 继续调用）
wecom_mcp call wecom-deep-op.doc_get '{"docid": "DOCID", "type": 2, "task_id": "xxx"}'

编辑文档

wecom_mcp call wecom-deep-op.doc_edit '{"docid": "DOCID", "content": "# 新内容\n\nMarkdown格式", "content_type": 1}'

📅 日程管理 (schedule_*)