메뉴
企业微信插件前置条件检查。在执行任何 wecom_mcp 操作前，通过 shell 命令检查工具权限配置（profile 和白名单），若缺失则自动修复并提示用户重启 Gateway。所有使用 wecom_mcp 的技能都应在首次调用前执行此检查。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
企业微信文档（doc）管理技能。提供普通文档的新建、内容读取（Markdown）、内容覆写能力。适用场景：(1) 从零新建空白文档 (2) 以 Markdown 格式读取文档完整内容 (3) 用 Markdown 覆写文档正文。支持通过 docid 或文档 URL 定位文档。当用户提到「企业微信文档」「企微文档」「创建文档」「写个文档」，或链接形如 `https://doc.weixin.qq.com/doc/xxx` 时触发该技能。注意：在线表格（`/sheet/*`）请用 `wecom-sheet`；智能表格（`/smartsheet/*`）请用 `wecom-smartsheet`；智能文档/智能主页（`/smartpage/*`）请用 `wecom-smartpage`。
企业微信在线表格（sheet）管理技能。提供在线表格的新建、内容读取、内容修改、追加行数据，以及子工作表的增删管理。适用场景：(1) 新建空白在线表格 (2) 读取表格完整内容（Markdown）(3) 读取基础信息与子表列表 (4) 读取子表数据 (5) 修改指定区域内容 (6) 末尾追加一行数据 (7) 添加/删除子工作表。当用户提到「企业微信表格」「企业微信在线表格」「企微 excel 表格」，或链接形如 `https://doc.weixin.qq.com/sheet/xxx` 时触发该技能。注意：智能表格（`/smartsheet/*`）请用 `wecom-smartsheet`；普通文档（`/doc/*`）请用 `wecom-doc`；智能文档/智能主页（`/smartpage/*`）请用 `wecom-smartpage`。
企业微信智能文档（原名智能主页，smartpage）管理技能。提供智能文档的创建（将本地 Markdown 文件发布为智能文档）与内容导出（异步导出为 Markdown）能力。适用场景：(1) 将一个或多个本地 Markdown 文件创建为智能文档 (2) 异步导出智能文档内容为 Markdown。支持通过 docid 或文档 URL 定位文档。当用户明确提到「智能文档」「智能主页」，或链接形如 `https://doc.weixin.qq.com/smartpage/xxx` 时触发该技能。注意：普通文档（`/doc/*`）请用 `wecom-doc`；在线表格（`/sheet/*`）请用 `wecom-sheet`；智能表格（`/smartsheet/*`）请用 `wecom-smartsheet`。
企业微信智能表格（smartsheet）管理技能。提供智能表格的新建（doc_type=10）、结构管理（子表、字段/列）和数据管理（记录增删改查）。适用场景：(1) 从零新建智能表格 (2) 管理智能表格子表和字段/列 (3) 查询、添加、更新、删除智能表格记录。支持通过 docid 或文档 URL 定位文档。当用户提到「企业微信智能表格」「智能表格」，或链接形如 `https://doc.weixin.qq.com/smartsheet/xxx` 时触发该技能。注意：普通文档（`/doc/*`）请用 `wecom-doc`；在线表格（`/sheet/*`）请用 `wecom-sheet`；智能文档/智能主页（`/smartpage/*`）请用 `wecom-smartpage`。
企业微信待办事项管理技能，支持创建待办、更新待办、更改用户在待办中的状态、获取待办列表、批量获取待办详情、删除待办。在用户说"帮我创建一个待办"、"把这个任务分派给张三"、"标记待办完成"、"接受/拒绝这个待办"、"把我在这个待办里的状态改成已完成"、"删掉那个待办"、"帮我建个提醒"、"更新一下待办内容"、"把提醒时间改到下周"、"看看这个待办的详情"、"待办分派给谁了"、"看看我有哪些待办"、"列一下我最近的待办"等需要对待办进行读写操作的场景时使用。
通讯录成员查询技能，基于 MCP tool 协议封装的 `get_userlist` 接口，获取当前用户可见范围内的通讯录成员，支持按姓名/别名本地筛选匹配。返回 userid、姓名和别名。⚠️ 仅返回当前用户有权限查看的成员，非全量成员。
| name | wecom-preflight |
| description | 企业微信插件前置条件检查。在执行任何 wecom_mcp 操作前，通过 shell 命令检查工具权限配置（profile 和白名单），若缺失则自动修复并提示用户重启 Gateway。所有使用 wecom_mcp 的技能都应在首次调用前执行此检查。 |
本技能确保
wecom_mcp工具已正确获得执行权限。所有使用 wecom_mcp 的技能在首次调用前，必须先执行本检查流程。
当满足以下任一条件时，执行前置检查：
wecom_mcp 工具wecom_mcp 时收到 tool not allowed、not permitted、permission denied 或类似权限错误如果当前会话中已成功调用过
wecom_mcp（任何操作），则无需重复检查。
重要：以下所有步骤均为 shell 命令（在终端中执行），不是 MCP tool 调用。
wecom_mcp在未加入白名单前对 AI Agent 不可见，因此不能用 tool 调用来探测。
在终端执行以下命令，读取当前 tools.profile 配置：
openclaw config get tools.profile
根据返回结果分流：
full → ✅ 检查通过。full 模式无任何工具限制，所有工具（包括 wecom_mcp）直接可用，无需检查 alsoAllow，继续执行用户原始请求coding、messaging、minimal、undefined 或空）→ 进入步骤 1b（检查 alsoAllow）command not found: openclaw、权限错误等）→ 进入步骤 3（环境异常）在终端执行以下命令，读取当前 tools.alsoAllow 配置：
openclaw config get tools.alsoAllow
根据返回结果分流：
wecom_mcp（如 ["wecom_mcp"] 或 ["wecom_mcp", "other_tool"]）→ ✅ 白名单已配置，检查通过，继续执行用户原始请求wecom_mcp（如空数组 []、undefined、或列表中没有 wecom_mcp）→ 进入步骤 2（自动修复）在终端执行以下命令，将 wecom_mcp 加入工具白名单：
openclaw config set tools.alsoAllow '["wecom_mcp"]'
注意：如果步骤 1b 返回的列表中已有其他工具（如
["other_tool"]），需要合并后再写入，例如：openclaw config set tools.alsoAllow '["other_tool", "wecom_mcp"]'
根据执行结果分流：
向用户回复（不要自动执行重启）：
✅ 已自动将 wecom_mcp 加入工具执行权限白名单（tools.alsoAllow）。
⚠️ 配置变更需要重启 Gateway 后才能生效，请在终端执行以下命令：
openclaw gateway restart
重启完成后请重新发送您的请求。
为什么不自动重启：
openclaw gateway restart会中断当前所有活跃连接（包括本会话）， 如果由 AI 自动执行，用户可能无法看到完整的提示信息。交由用户手动重启更可控。
向用户回复以下手动修复指引：
❌ 自动配置失败，请在终端手动执行以下命令：
openclaw config set tools.alsoAllow '["wecom_mcp"]'
openclaw gateway restart
完成后请重新发送您的请求。
如果步骤 1 或 1b 的 openclaw 命令本身执行失败（如 command not found、权限不足等），说明 OpenClaw CLI 未正确安装或不在 PATH 中，直接告知用户：
⚠️ OpenClaw CLI 不可用：<错误信息>
可能原因：
- OpenClaw 未安装或未加入系统 PATH
- OpenClaw 版本过低，不支持 config 子命令
- 当前 shell 环境缺少必要配置
请检查 OpenClaw 安装状态后重试。
参考：https://docs.openclaw.dev/installation
openclaw CLI 在终端中执行，不涉及任何 MCP tool 调用。这样可以避免"tool 未白名单 → tool 不可见 → 无法探测"的死锁问题tools.profile 为 full 时所有工具无限制，无需检查 alsoAllow，可快速跳过tools.alsoAllow 中已包含 wecom_mcp，openclaw config set 命令不会产生副作用tools.alsoAllow 时，需保留列表中已有的其他工具名，仅追加 wecom_mcp| 场景 | 处理方式 |
|---|---|
| 首次调用 wecom_mcp 前 | 执行 openclaw config get tools.profile 检查 |
tools.profile 为 full | ✅ 跳过，直接执行原始请求 |
| profile 非 full + alsoAllow 已包含 wecom_mcp | ✅ 跳过，继续执行 |
| profile 非 full + alsoAllow 不包含 → 自动写入成功 | 提示已配置 + 附 openclaw gateway restart 命令让用户重启 |
| profile 非 full + alsoAllow 不包含 → 自动写入失败 | 给出手动修复指引 |
| openclaw CLI 不可用 | 告知用户检查 OpenClaw 安装 |
| 会话中已成功调用过 wecom_mcp | 跳过检查 |