# CLIPROXY API + OpenClaw 設定筆記

目的：把 CLIPROXY 暴露的多家模型整合進 OpenClaw，並能在多代理（agents）間用不同主模型＋fallback。

## 1) Provider 設定（openai-responses 建議）

openclaw.json 片段：

```json5
{
  models: {
    mode: "merge",
    providers: {
      "cliproxyapi-2": {
        baseUrl: "http://127.0.0.1:8317/v1",
        apiKey: "${CLIPROXY_API_KEY}",
        api: "openai-responses",
        models: [
          { id: "claude-opus-4-6", name: "Opus 4.6 (antigravity)", reasoning: true },
          { id: "claude-opus-4-6-thinking", name: "Opus 4.6 Thinking (antigravity)", reasoning: true },
          { id: "claude-sonnet-4-5", name: "Sonnet 4.5 (antigravity)", reasoning: true },
          { id: "claude-sonnet-4-5-thinking", name: "Sonnet 4.5 Thinking (antigravity)", reasoning: true },
          { id: "gpt-5.3-codex", name: "GPT‑5.3 Codex" },
          { id: "gpt-5.1-codex", name: "GPT‑5.1 Codex" },
          { id: "gpt-5.1-codex-mini", name: "GPT‑5.1 Codex Mini" },
          { id: "gpt-5.2", name: "GPT‑5.2" },
          { id: "gemini-3-pro-high", name: "Gemini 3 Pro High" },
          { id: "gemini-3-flash", name: "Gemini 3 Flash" }
        ]
      }
    }
  }
}
```

備註：現有設定是 `openai-completions`，可運作；若要完整支援工具呼叫與流式事件，建議改為 `openai-responses`。

## 2) 模型列表（來自 /v1/models）

本機查詢到的可用 id：
- claude-opus-4-6, claude-opus-4-6-thinking, claude-opus-4-5-thinking
- claude-sonnet-4-5, claude-sonnet-4-5-thinking, claude-3-7-sonnet-20250219
- gpt-5, gpt-5.2, gpt-5.1, gpt-5.3-codex, gpt-5.3-codex-spark, gpt-5.1-codex, gpt-5.1-codex-mini, gpt-5-codex, gpt-5-codex-mini
- gemini-3-pro-high, gemini-3-pro-preview, gemini-3-flash, gemini-3-flash-preview, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite, gemini-3-pro-image

（來源：curl http://127.0.0.1:8317/v1/models）

## 3) Anthropic 最終備援

Selig 有 Anthropic 訂閱：在 OpenClaw 的 `auth-profiles.json` 維持 anthropic 憑證（API key 或 OAuth/setup-token）。
- Fallback 鏈結：優先 `cliproxyapi-2/claude-opus-4-6(-thinking)` → 失敗時退到 `anthropic/claude-opus-4-6`。

## 4) 安全建議

- 具工具權限的代理（browser/fs/exec）使用 Opus/Sonnet 等高等級模型，降低 prompt injection 風險。
- 低風險任務可用 codex/gemini flash 節省成本。
