wecom-preflight

name	wecom-preflight
description	WeCom MCP 文档/智能表格调用前置检查。仅当已经决定调用 `wecom_mcp` 的 doc 类能力时使用；不要用于给企业微信用户或群发消息、联系人查询、日程、会议或待办。发消息必须使用 OpenClaw core `message` 工具。

企业微信前置检查

本技能只用于判断当前会话能否继续使用 wecom_mcp。 在 agent sandbox 内，不要执行宿主机级别的 openclaw config ... 或 openclaw gateway restart。 本技能不适用于发消息。用户要求“给某人/群发消息、转发、通知”时，禁止调用 wecom_mcp 的 msg category；应使用 OpenClaw core message 工具（action="send"、channel="wecom"）。如果当前工具列表没有 message，直接说明宿主机需要把 message 加入 tools.alsoAllow，不要改用 wecom_mcp。

⚠️ 路径与停止规则：

• 如果要读取 WeCom skill，必须直接使用 <available_skills> 或 skillsSnapshot 中给出的精确绝对路径。
• 不要猜测或改写为 /data/openclaw/skills/wecom-*、/workspace/.openclaw/skills/...、/root/.openclaw/workspace-*/.openclaw/skills/...，也不要用 exec + ls/find 探路。
• 若 wecom_mcp 返回 errcode: 846609 或 unsupported mcp biz type，表示当前 bot 未开通该 category，不是路径、白名单或 sandbox 问题；立即停止继续 read、list、find、memory fallback 探索，直接告知用户对应 category 未开通。

何时使用

在以下场景使用本技能：

1. 当前会话第一次准备调用 wecom_mcp
2. 调用 wecom_mcp 后返回 tool not allowed、not permitted、permission denied
3. 你怀疑当前环境没有把 WeCom MCP 正确暴露给 agent

如果当前会话里 wecom_mcp 已经成功调用过一次，就不要重复执行本技能。

当前部署的正确做法

本项目的 wecom_mcp 是否可用，取决于 宿主机 OpenClaw 配置 和 sandbox 挂载，不是由 agent 自己在容器里动态修复。

因此：

• 可以继续直接调用 wecom_mcp 的前提：工具已经出现在当前会话可用工具中，或你刚刚已经成功调用过
• 不可以做的事：在 sandbox 里执行 openclaw config get ...、openclaw config set ...、openclaw gateway restart
• 如果工具不可用，应该停止继续试探，并明确告知用户或管理员去宿主机修复

检查流程

情况 A：wecom_mcp 已可用

满足任一条件即可视为通过：

• 当前回合工具列表里已经有 wecom_mcp
• 当前会话里之前已经成功调用过 wecom_mcp

处理方式：

• 直接继续执行原始 WeCom 技能
• 不要再做额外的 shell 探测

情况 B：返回工具权限错误

如果错误类似：

• tool not allowed
• not permitted
• permission denied
• unknown tool: wecom_mcp

这说明问题在 宿主机工具放行配置，不是当前业务参数错误。

处理方式：

• 立即停止继续试探
• 明确告知用户：需要在宿主机上把 wecom_mcp 加入允许列表，并在必要时重启 gateway
• 不要在 sandbox 内尝试修复

可对用户说明：

当前会话所在的 agent sandbox 里还不能使用 wecom_mcp。这个问题需要在宿主机 OpenClaw 配置里放行 wecom_mcp，并在必要时重启 gateway 后才会生效；我无法在当前 sandbox 内直接执行这类宿主机配置。

情况 C：返回 MCP 业务错误

如果 wecom_mcp 工具本身可调用，但返回类似下面的业务错误：

• unsupported mcp biz type
• errcode: 846609

这说明：

• 工具权限通常已经没问题
• 但当前机器人或当前企业微信侧 没有开通对应 category，例如只开了 doc，没有开 schedule

处理方式：

• 不要再把它误判成“tool 未放行”
• 直接告诉用户：当前业务类型未开通，需要企业微信侧补充对应 MCP 配置

决策规则

现象	结论	动作
wecom_mcp 已成功调用	前置检查通过	继续原始任务
tool not allowed / unknown tool	宿主机未放行工具	停止试探，提示宿主机修复
unsupported mcp biz type / 846609	对应业务类型未开通	停止试探，提示开通对应 category
其他业务报错	接口调用失败	按具体错误处理，不要误改环境

关键约束

1. 本技能是 判断与分流，不是在 sandbox 内自动修配置。
2. 绝不要在当前容器里执行宿主机级别的 OpenClaw 配置命令。
3. 一旦确认是宿主机配置问题或企业微信侧未开通问题，就停止重复探索，直接给出明确结论。