​

Anthropic（Claude）

​

選項 A：Anthropic API 鑰

​

CLI 設定

openclaw onboard
# 選擇：Anthropic API 鑰

# 或非互動
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​

設定片段

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

​

Thinking 預設值（Claude 4.6）

• Anthropic Claude 4.6 模型在 OpenClaw 中當未設定明確的 thinking 層級時，預設為 adaptive thinking。
• 可以按訊息覆蓋（/think:<level>）或在模型參數： agents.defaults.models["anthropic/<model>"].params.thinking。
• 相關 Anthropic 文件：
  • Adaptive thinking
  • Extended thinking

​

提示快取（Anthropic API）

​

設定

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

​

預設值

​

按代理 cacheRetention 覆蓋

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // 大多數代理的基線
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // 僅覆蓋此代理
    ],
  },
}

1. agents.defaults.models["provider/model"].params
2. agents.list[].params（匹配 id，按鍵覆蓋）

​

Bedrock Claude 註記

• Anthropic Claude 模型在 Bedrock（amazon-bedrock/*anthropic.claude*）在設定時接受 cacheRetention pass-through。
• 非 Anthropic Bedrock 模型在執行時被強制設定為 cacheRetention: "none"。
• Anthropic API 鑰智慧預設值也在未設定明確值時為 Claude-on-Bedrock 模型引用設置 cacheRetention: "short"。

​

舊版參數

• "5m" 映射至 short
• "1h" 映射至 long

​

1M 內容視窗（Anthropic beta）

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}

​

選項 B：Claude setup-token

​

何處取得 setup-token

claude setup-token

openclaw models auth setup-token --provider anthropic

openclaw models auth paste-token --provider anthropic

​

CLI 設定（setup-token）

# 在上線期間貼 setup-token
openclaw onboard --auth-choice setup-token

​

設定片段（setup-token）

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

​

註記

• 用 claude setup-token 生成 setup-token 並貼它，或在 gateway 主機上執行 openclaw models auth setup-token。
• 若看到 Claude 訂閱上的「OAuth token refresh failed …」，使用 setup-token 重新認證。見 /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription。
• 認證詳情 + 重用規則在 /concepts/oauth。

​

疑難排解

• Claude 訂閱認證可過期或被撤銷。重新執行 claude setup-token 並貼它到 gateway 主機。
• 如 Claude CLI 登入在不同機器，使用 openclaw models auth paste-token --provider anthropic 在 gateway 主機。

• 認證是每個代理。新代理不繼承主代理的鑰。
• 重新執行該代理的上線，或貼 setup-token / API 鑰在 gateway 主機，然後用 openclaw models status 驗證。

• 執行 openclaw models status 看啟用哪個認證設定檔。
• 重新執行上線，或為該設定檔貼 setup-token / API 鑰。

• 檢查 openclaw models status --json 用於 auth.unusableProfiles。
• 新增另一 Anthropic 設定檔或等待冷卻。