Add NewCLI Provider (Claude/GPT/Gemini)

配置 NewCLI Provider（code.newcli.com 模型代理源）

NewCLI（FoxCode）是一个模型代理服务，通过统一的账户和 API Key 提供三类模型的访问：

为什么是四个 provider？ 虽然是同一个服务商、同一个 API Key，但：

• Claude、GPT、Gemini 使用不同的 API 协议和端点，必须分开配置；
• Claude 有两条线路（主线路 vs AWS 特价线路），额度消耗倍率不同，也需要独立配置。

⭐ AWS 特价线路（重要）

服务商提供了独家 AWS 线路：https://code.newcli.com/claude/aws

策略建议：所有重要任务优先使用 newcli-aws；主线路 newcli 作为备用 fallback。

⚠️ 服务商声明：严禁分发 AWS 线路地址，一经发现将立即封禁且不退款。

如果觉得这个 Skill 有用，请使用我的邀请码注册：  
https://foxcode.rjj.cc/auth/register?aff=7WTAV8R

第一步：确认可用模型

此步骤不可跳过。 不要直接照搬文档中列出的模型 ID，务必以实际调用成功为准。

1A. 测试 Claude 模型（newcli / newcli-aws）

使用 Anthropic Messages 格式发起测试请求：

# 测试主线路
curl -s --max-time 15 https://code.newcli.com/claude/v1/messages \
  -H "x-api-key: " \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"","messages":[{"role":"user","content":"hi"}],"max_tokens":10}'

# 测试 AWS 特价线路
curl -s --max-time 15 https://code.newcli.com/claude/aws/v1/messages \
  -H "x-api-key: " \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"","messages":[{"role":"user","content":"hi"}],"max_tokens":10}'

注意：Base URL 中主线路为 /claude，AWS 线路为 /claude/aws（OpenClaw 会自动拼接 /v1/messages）。

• 若返回标准 JSON 响应（含 content 字段）→ 模型可用；
• 若返回 {"error":{"message":"暂不支持"}} 或 "未开放" → 该模型当前不可用。

1B. 测试 GPT 模型（newcli-codex）

使用 OpenAI Completions 格式发起测试请求：

curl -s --max-time 15 https://code.newcli.com/codex/v1/chat/completions \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{"model":"","messages":[{"role":"user","content":"hi"}],"max_tokens":10}'

• 若返回标准 JSON 响应（含 choices 数组）→ 模型可用；
• 若返回错误或超时 → 该模型当前不可用。

1C. 测试 Gemini 模型（newcli-gemini）

使用 Google Generative AI 格式发起测试请求：

curl -s --max-time 15 \
  "https://code.newcli.com/gemini/v1beta/models/:generateContent" \
  -H "x-goog-api-key: " \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"hi"}]}]}'

注意：Gemini 的端点 URL 格式与其他 provider 不同——模型 ID 必须嵌入在路径中（如 models/gemini-3-pro:generateContent），而非放在请求体中。

• 若返回标准 JSON 响应（含 candidates 字段）→ 模型可用；
• 若返回 {"error":{"message":"模型未开放"}} → 该模型当前不可用。

已知可用模型（截至 2026-02-08）

Claude 系列（newcli）

其他模型（如 claude-sonnet-4-20250514）虽在文档中列出，但实测可能返回“未开放”。请以您账户的实际响应为准。

GPT 系列（newcli-codex）

Gemini 系列（newcli-gemini）— 文本对话模型

Gemini 系列（newcli-gemini）— 图片生成模型

这些模型专用于图像生成，不得加入 fallback 链，但可通过 /model 命令手动切换使用。

基础分辨率（默认）：

2K 分辨率：在模型 ID 后添加 -2k 后缀，例如：  
gemini-3-pro-image-2k、gemini-3-pro-image-2k-16x9

4K 分辨率：在模型 ID 后添加 -4k 后缀，例如：  
gemini-3-pro-image-4k、gemini-3-pro-image-4k-16x9

⚠️ 图片生成模型严禁加入 fallback 链——它们不支持文本对话协议，若误配会导致对话请求被错误路由至图像生成接口，引发异常。需生成图片时，请明确执行 /model gemini-3-pro-image 手动切换。

第三步：配置别名

在 agents.defaults.models 下为各模型添加别名，便于用户在聊天中通过短命令快速切换：

{
  "agents": {
    "defaults": {
      "models": {
        "newcli/claude-opus-4-6": { "alias": "claude-opus" },
        "newcli/claude-haiku-4-5-20251001": { "alias": "claude-haiku" },
        "newcli-aws/claude-opus-4-6": { "alias": "claude-opus-aws" },
        "newcli-aws/claude-haiku-4-5-20251001": { "alias": "claude-haiku-aws" },
        "newcli-codex/gpt-5.3-codex": { "alias": "gpt53" },
        "newcli-codex/gpt-5.2": { "alias": "gpt52" },
        "newcli-codex/gpt-5.2-codex": { "alias": "gpt52codex" },
        "newcli-codex/gpt-5.1": { "alias": "gpt51" },
        "newcli-codex/gpt-5.1-codex": { "alias": "gpt51codex" },
        "newcli-codex/gpt-5.1-codex-mini": { "alias": "gpt51mini" },
        "newcli-codex/gpt-5.1-codex-max": { "alias": "gpt51max" },
        "newcli-codex/gpt-5": { "alias": "gpt5" },
        "newcli-codex/gpt-5-codex": { "alias": "gpt5codex" },
        "newcli-gemini/gemini-3-pro": { "alias": "gemini3pro" },
        "newcli-gemini/gemini-3-pro-high": { "alias": "gemini3prohigh" },
        "newcli-gemini/gemini-3-pro-preview": { "alias": "gemini3preview" },
        "newcli-gemini/gemini-3-flash": { "alias": "gemini3flash" },
        "newcli-gemini/gemini-3-flash-preview": { "alias": "gemini3flashpreview" },
        "newcli-gemini/gemini-2.5-pro": { "alias": "gemini25pro" },
        "newcli-gemini/gemini-2.5-flash": { "alias": "gemini25flash" },
        "newcli-gemini/gemini-2.5-flash-lite": { "alias": "gemini25lite" }
      }
    }
  }
}

配置完成后，用户可在任意聊天中使用如下命令切换模型：

/model claude-opus
/model gpt53
/model gemini3pro

⚠️ 别名配置的唯一合法字段是 alias

以下写法非法且危险，将导致 Gateway 启动失败或崩溃：

agents.defaults.models..alias     
⚠️ 真实事故记录：曾因在别名配置中误加 "reasoning": true，触发 schema 校验失败，导致 Gateway 连续崩溃重启 181 次。  
✅ 正确做法：模型能力属性（如 reasoning、vision、tools 等）必须定义在 models.providers 的 provider 级模型描述中，绝不可出现在 agents.defaults.models 的别名配置下。
第五步：验证
5.1 JSON 语法检查
python3 -c "import json; json.load(open('$HOME/.openclaw/openclaw.json')); print('JSON OK')"
5.2 Schema 校验
openclaw doctor
若输出中包含 Unrecognized key，说明存在非法字段，必须修复后方可重启服务。
5.3 重启 Gateway
# macOS
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

# 等待 3 秒后检查状态
sleep 3
launchctl print gui/$(id -u)/ai.openclaw.gateway | grep -E "job state|last exit"
期望输出为：
last exit code = 0
job state = running
若 last exit code = 1 且 job state 不为 running，请检查错误日志：
tail -20 ~/.openclaw/logs/gateway.err.log
5.4 功能验证
在任意已绑定的聊天窗口中，依次执行以下命令验证三大 provider 是否正常工作：
/model claude-opus    # 测试 Claude（主线路）
/model gpt53          # 测试 GPT（newcli-codex）
/model gemini3pro     # 测试 Gemini（newcli-gemini）
/model Minimax        # 切回默认主力模型
确保每条命令均能成功切换并响应，即完成全部配置验证。
变更记录