Yuomoz CLI

🚀 OpenClaw 单反代覆盖切换与下游修复向导

它是干什么的

npx yuomoz 用来给 OpenClaw 完成一次覆盖切换，并尽量修掉常见的下游兼容问题：

• 默认模型
• API Key
• 固定默认反代 Base URL
• auth-profiles.json
• Gateway 基础配置
• OpenClaw 版本检测
• 自动重启 + 自动测试

配置完成后，它会自动把设置写入 OpenClaw，并重启 Gateway，让配置立即生效。

运行方式

# 交互模式
npx yuomoz

# 非交互模式
npx yuomoz --model gpt-5.4 --api-key sk-xxx

参数

• --model <id>：要切换的模型
• --api-key <key>：API Key
• --help：显示帮助

交互流程

运行：

npx yuomoz

然后按顺序：

1. 查看当前配置
2. 进入明显的“第 1 步 / 选择模型”界面并选择模型
3. 进入“第 2 步 / API Key”界面，直接输入新的 API Key
4. 进入“第 3 步 / 最终确认”界面再次确认
5. 自动使用默认反代地址写入 OpenClaw 配置
6. 自动完全覆盖切换当前 Provider 与主模型
7. 自动写入 auth-profiles.json
8. 自动补齐 Gateway 基础配置
9. 自动检测 OpenClaw 版本并提示是否偏旧
10. 自动重启 OpenClaw Gateway
11. 自动测试当前模型链路

默认配置目标

当前默认会写入 OpenClaw 的 codex-proxy 提供商：

• Provider: codex-proxy
• 默认 Base URL: https://www.yuomoz.site/v1
• 默认 API 类型: openai-completions

并更新：

• models.providers（完全覆盖为当前 Provider）
• models.providers.codex-proxy.baseUrl
• models.providers.codex-proxy.apiKey
• models.providers.codex-proxy.models
• agents.defaults.models（完全覆盖为当前主模型映射）
• agents.defaults.model.primary
• agents.defaults.model.fallbacks（清空）
• 当前活动配置文件（通过 openclaw config file 识别）
• 当前活动状态目录下的 agents/<agentId>/agent/auth-profiles.json
• gateway.mode
• gateway.bind
• gateway.port
• gateway.auth.mode
• gateway.auth.token
• gateway.remote.token

支持模型

• gpt-5
• gpt-5.1
• gpt-5.2
• gpt-5.3-codex
• gpt-5.4
• gpt-5-codex
• gpt-5.1-codex
• gpt-5.2-codex
• gpt-5.1-codex-max
• gpt-5.3-codex-spark

使用结果

配置成功后，OpenClaw 会切换到类似这样的主模型：

codex-proxy/gpt-5.4

并额外完成：

• 认证配置文件同步
• Gateway 基础配置修复
• 重启后的连通性验证

注意

• 这个工具当前是 单反代覆盖切换工具，不是多节点管理器。
• 它默认只使用固定反代：https://www.yuomoz.site/v1
• 修改配置后会自动执行：

openclaw gateway restart

• 自动测试当前通过：

http://127.0.0.1:<gateway-port>/v1/chat/completions

• 需要本机已经安装并可执行 openclaw。
• 如果系统里没有 openclaw，工具会直接报错并提示先安装。