用途
configure-openclaw 是一个交互式设置向导，用于将 OpenClaw 配置为通知网关，使 OMX 能够把通知事件路由到你的 OpenClaw hook 端点（或本地命令网关）。它通过自然语言交互引导完成配置，并在最后给出明确的通过/失败诊断。
主要能力
- 检测 ~/.codex/.omx-config.json 中已有的 OpenClaw 配置，展示现有 gateways 与 hooks，并询问是更新还是替换。
- 支持两种网关模式：HTTP Gateway（推荐，OMX 向 OpenClaw hook 端点 POST JSON）和 CLI Command Gateway（OMX 执行本地命令模板）。
- 收集网关名称、Hook 基础 URL、OpenClaw hooks token（HTTP 模式）或命令模板（命令模式，支持 {{event}}、{{instruction}}、{{sessionId}}、{{projectPath}} 占位符）。
- 通过 AskUserQuestion 多选方式选择触发 OpenClaw hooks 的 OMX 事件，并为每个事件收集简短的指令模板。
- 将配置合并写入 ~/.codex/.omx-config.json，符合 OMX 运行时 schema：notifications.openclaw.enabled、notifications.openclaw.gateways、notifications.openclaw.hooks。不得使用 gatewayType、endpoint 或顶层 command 等旧键。
- 执行必选的验证流程：HTTP 网关会同时测试 /hooks/wake（唤醒冒烟测试，期望响应含 "ok":true）和 /hooks/agent（投递验证，期望 HTTP 2xx 且响应体确认接受）。
- 提供通过/失败诊断指导，覆盖 401/403、404、5xx、超时/连接拒绝以及命令网关被禁用等情况。
使用方式
该技能以交互式向导方式运行，主要流程如下：
- 检测现有 OpenClaw 配置（读取 ~/.codex/.omx-config.json 中的 enabled、gateways、hooks）。
- 选择网关模式：HTTP Gateway 或 CLI Command Gateway。 3A. HTTP 网关设置：收集网关名称（默认 local）、Hook 基础 URL（示例 http://127.0.0.1:18789）、OpenClaw hooks token；投递端点构建为 ${BASE_URL%/}/hooks/agent，可选唤醒冒烟端点为 ${BASE_URL%/}/hooks/wake。必须执行验证检查：token 是否存在、URL 格式是否为 http:// 或 https:// 开头、基础 URL 是否可达、投递端点探测是否返回 2xx。 3B. CLI 命令网关设置：收集网关名称（默认 local-command）和命令模板（支持 {{event}}、{{instruction}}、{{sessionId}}、{{projectPath}}），示例：~/.local/bin/my-notifier --event {{event}} --text {{instruction}}。命令网关仅在同时设置以下两个环境变量时运行：
export OMX_OPENCLAW=1
export OMX_OPENCLAW_COMMAND=1
若缺少 OMX_OPENCLAW_COMMAND，命令网关分发将按设计被阻止。
- 选择 Hook 事件映射（多选）。推荐默认：session-end、ask-user-question；可选：session-start、session-idle、stop。为每个选中事件收集简短指令模板。
- 使用 jq 将配置合并写入 ~/.codex/.omx-config.json。
- 解释激活门控环境变量：
# Required for OpenClaw integration
export OMX_OPENCLAW=1
# Required in addition for command gateways
export OMX_OPENCLAW_COMMAND=1
- 运行必选验证流程（HTTP 网关需同时测试 /hooks/wake 与 /hooks/agent）。
- 根据验证结果执行通过/失败诊断。
- 给出最终摘要：网关模式与名称、映射的事件、冒烟测试是否通过、/hooks/agent 投递测试是否通过、用户仍需在 shell profile 中导出的确切环境变量。
环境变量参考：
# Required for all OpenClaw gateways
export OMX_OPENCLAW=1
# Required additionally for CLI command gateways
export OMX_OPENCLAW_COMMAND=1
# Optional debug logs
export OMX_OPENCLAW_DEBUG=1
适用场景
适用于需要让 OMX 在特定事件（如会话结束、向用户提问等）发生时，将通知推送到 OpenClaw hook 端点或调用本地命令的用户。适合已经运行 OpenClaw 网关并希望在 OMX 中完成集成配置的场景。
限制
- 配置必须严格遵循 OMX 运行时 schema，不得使用 gatewayType、endpoint 或顶层 command 等旧键。
- CLI 命令网关必须同时设置 OMX_OPENCLAW=1 与 OMX_OPENCLAW_COMMAND=1 才会运行。
- HTTP 网关验证依赖 OpenClaw hooks 配置启用 /hooks/agent 与 /hooks/wake 路径。
- 验证失败时的排查需检查 token、路径、网关运行时日志、主机端口与本地防火墙。
- 其他功能细节、定价或平台支持信息暂未提供。