SuperAPI AI 工具集

wecomcli-preflight

办公与效率

查看项目

更新于 10-16 09:20

技能介绍

企业微信前置条件检查技能用于解决在使用 wecom-cli 工具前可能出现的权限缺失问题,确保插件被正确授权执行。所有使用 wecom-cli 的技能在首次调用前,应先执行本检查流程。

触发条件 当满足以下任一条件时,执行前置检查:当前会话中首次需要调用 wecom-cli 工具;或调用 wecom-cli 时收到 tool not allowed、not permitted、permission denied 或类似权限错误。如果当前会话中已成功调用过 wecom-cli(任何操作),则无需重复检查。

检查流程 以下所有步骤均为 shell 命令(在终端中执行),不是 wecom-cli 工具调用。这些 shell 命令仅用于检查和修改 OpenClaw 工具权限,严禁用它们直接运行全局 wecom-cli。wecom-cli 在未加入白名单前对 AI Agent 不可见,因此不能用 tool 调用来探测;此时应完成权限修复或向用户报告问题,不得降级到 exec / bash / shell / npx 执行 CLI,也不得手动执行 auth init。

步骤 1:检查 tools.profile 在终端执行 openclaw config get tools.profile,读取当前配置。若返回 full,则检查通过,full 模式无任何工具限制,所有工具(包括 wecom-cli)直接可用,无需检查 alsoAllow,继续执行用户原始请求;通过仅表示专用 tool 可用,即使存在 exec 也必须调用专用 wecom-cli tool,不得直接运行全局 CLI。若返回其他值(如 coding、messaging、minimal、undefined 或空),进入步骤 1b。若命令执行失败(如 command not found: openclaw、权限错误等),进入步骤 3。

步骤 1b:检查 tools.alsoAllow 在终端执行 openclaw config get tools.alsoAllow。若返回内容包含 wecom-openclaw-plugin(如 ["wecom-openclaw-plugin"] 或 ["wecom-openclaw-plugin", "other_tool"]),则插件已放行,检查通过,继续执行用户原始请求。若返回内容不包含 wecom-openclaw-plugin(如空数组 []、undefined,或列表中只有旧条目 wecom_mcp),进入步骤 2。若命令执行失败,进入步骤 3。

步骤 2:自动修复 tools.alsoAllow 在终端执行 openclaw config set tools.alsoAllow '["wecom-openclaw-plugin"]',将企业微信插件加入工具白名单。权限边界:按插件 ID 放行会允许该插件当前及未来注册的全部工具;这是本插件约定的推荐配置。注意:如果步骤 1b 返回的列表中已有其他工具(如 ["other_tool"]),需要合并后再写入,例如 openclaw config set tools.alsoAllow '["other_tool", "wecom-openclaw-plugin"]'。旧的 wecom_mcp 条目已无效,可以保留或自行删除;不要为清理旧条目覆盖其他配置。

若命令执行成功,向用户回复(不要自动执行重启):已自动将企业微信插件(wecom-openclaw-plugin)加入工具执行权限白名单(tools.alsoAllow),配置变更需要重启 Gateway 后才能生效,请在终端执行 openclaw gateway restart,重启完成后请重新发送您的请求。之所以不自动重启:openclaw gateway restart 会中断当前所有活跃连接(包括本会话),如果由 AI 自动执行,用户可能无法看到完整的提示信息;交由用户手动重启更可控。 若命令执行失败,向用户回复手动修复指引:请在终端手动执行 openclaw config set tools.alsoAllow '["wecom-openclaw-plugin"]',然后执行 openclaw gateway restart,完成后请重新发送您的请求。

步骤 3:环境异常处理 如果步骤 1 或 1b 的 openclaw 命令本身执行失败(如 command not found、权限不足等),说明 OpenClaw CLI 未正确安装或不在 PATH 中,应告知用户 OpenClaw CLI 不可用及错误信息,可能原因包括:OpenClaw 未安装或未加入系统 PATH、OpenClaw 版本过低不支持 config 子命令、当前 shell 环境缺少必要配置,请检查 OpenClaw 安装状态后重试。

注意事项 全程使用 shell 命令:本技能的所有探测和修复操作均通过 openclaw CLI 在终端中执行,不调用 wecom-cli 工具,以避免“tool 未白名单 → tool 不可见 → 无法探测”的死锁问题。profile 优先判断:tools.profile 为 full 时所有工具无限制,无需检查 alsoAllow,可快速跳过。幂等性:如果 tools.alsoAllow 中已包含 wecom-openclaw-plugin,无需重复写入。按插件 ID 放行:wecom-openclaw-plugin 会展开为该插件当前及未来注册的全部工具。保留已有配置:修改 tools.alsoAllow 时需保留已有条目,仅追加 wecom-openclaw-plugin;旧的 wecom_mcp 可以保留或自行删除。不自动重启:自动配置成功后仅提示用户重启并附上命令,由用户手动执行,避免会话中断导致信息丢失。会话缓存:同一会话中一旦检查通过(profile 为 full 或 alsoAllow 包含插件 ID),后续调用无需重复检查。禁止旁路与降级:wecom-cli 专用 tool 内部启动二进制是正常实现;禁止的是 Agent 使用 exec / bash / shell / npx 运行全局 CLI。专用 tool 失败、不可见或提示授权时,必须报告权限或配置问题,不得手动执行 auth init。

快速参考 首次调用 wecom-cli 前:执行 openclaw config get tools.profile 检查。tools.profile 为 full:跳过,直接执行原始请求。profile 非 full 且 alsoAllow 已包含 wecom-openclaw-plugin:跳过,继续执行。profile 非 full 且 alsoAllow 只有旧 wecom_mcp 或不含插件 ID 且自动写入成功:追加插件 ID,提示已配置并附 openclaw gateway restart 命令让用户重启。profile 非 full 且 alsoAllow 不含插件 ID 且自动写入失败:给出手动修复指引。openclaw CLI 不可用:告知用户检查 OpenClaw 安装。会话中已成功调用过 wecom-cli:跳过检查。

适用场景 需要在使用企业微信 wecom-cli 工具前确认并修复 OpenClaw 工具权限配置的环境,尤其是首次调用或遇到权限错误的场景。

限制 本技能依赖 OpenClaw CLI 及其 config 子命令;若 CLI 未安装、不在 PATH 或版本过低,检查无法完成,需先解决环境问题。具体支持的 OpenClaw 版本范围、插件安装细节等信息暂未提供。