核心用法
wecom-doc 技能提供企业微信文档与智能表格的完整操作能力,基于 mcporter 调用 wecom-doc MCP server 实现。
文档操作:支持创建新文档(create_doc,doc_type=3)和全量编辑内容(edit_doc_content,content_type: 1 使用 markdown)。创建后需保存返回的 docid,仅支持编辑本会话中创建的文档,不支持从 URL 解析 docid。
智能表格操作:采用四层架构(文档→子表→字段→记录)。创建智能表(create_doc,doc_type=10)后,需依次通过 smartsheet_add_sheet 创建子表、wedoc_smartsheet_add_fields 定义字段(支持 16 种类型),最后用 smartsheet_add_records 写入数据。操作已有智能表时需先 smartsheet_get_sheet 和 smartsheet_get_fields 获取元数据。
前置依赖:必须安装 mcporter(npm install -g mcporter)并配置 MCP server。首次使用会自动检测环境:检查 mcporter 安装 → 验证 MCP 配置 → 获取 tool 列表。若未配置,提供分场景引导(OpenClaw 用户可直接授权,其他环境需手动配置 StreamableHttp URL 或 JSON Config)。
显著优点
- 深度集成企业微信生态:原生对接企业微信文档能力,适合企业协作场景
- 结构化数据支持完善:智能表格支持 16 种字段类型,涵盖文本、数字、日期、成员、进度、位置、条码等复杂业务场景
- 自动化工作流:前置检查自动处理安装、配置、授权,用户首次配置后无需重复操作
- 类型安全:详细定义 FieldType ↔ CellValue 映射,避免数据格式错误
潜在缺点与局限性
- 严格的作用域限制:仅支持编辑本会话创建的文档,无法操作历史文档或通过 URL 指定文档
- 配置门槛较高:依赖 mcporter 工具链和 MCP server 配置,非 OpenClaw 环境需手动完成多步骤配置
- 全量覆写风险:
edit_doc_content为全量覆写,追加内容需先读取再拼接 - 字段类型不可变更:
wedoc_smartsheet_update_fields无法修改字段类型,仅可调整标题和属性 - 外部依赖脆弱:依赖 mcporter daemon 运行状态,可能出现连接拒绝等运行时错误
适合人群
- 企业微信用户,需自动化文档/表格操作的企业开发者
- 使用 OpenClaw 平台的智能机器人创建者(配置流程最简化)
- 需要将 AI 输出结构化存入企业微信智能表的业务场景
常规风险
- 数据覆盖风险:文档编辑为全量覆写,误操作可能导致内容丢失
- 配置信息泄露:MCP server URL 可能包含敏感信息,需妥善保管
- 依赖服务可用性:mcporter daemon 或企业微信服务异常时将完全不可用
- 权限边界模糊:机器人授权范围需明确,避免越权访问企业文档数据