Anthropic

​

Option A: Anthropic API キー

​

CLI セットアップ

openclaw onboard
# choose: Anthropic API key

# or non-interactive
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 系モデルでは、thinking level を明示しない場合、OpenClaw は既定で adaptive thinking を使います。
• 上書きするには、メッセージ単位の /think:<level>、またはモデル パラメータ agents.defaults.models["anthropic/<model>"].params.thinking を使用します。
• 関連ドキュメント:
  • Adaptive thinking
  • Extended thinking

​

Prompt caching（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" }, // baseline for most agents
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // override for this agent only
    ],
  },
}

1. agents.defaults.models["provider/model"].params
2. agents.list[].params（id が一致するもの。キー単位で上書き）

​

Bedrock 上の Claude に関する注意

• Bedrock 上の Anthropic Claude モデル（amazon-bedrock/*anthropic.claude*）でも、設定されていれば cacheRetention がそのまま渡されます。
• Anthropic 以外の Bedrock モデルでは、実行時に cacheRetention: "none" が強制されます。
• 明示的な値がない場合、Anthropic API キーの smart default は Claude-on-Bedrock モデル参照にも cacheRetention: "short" を適用します。

​

旧パラメータ

• "5m" は short に対応
• "1h" は long に対応

​

1M context window（Anthropic beta）

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

​

Option 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）

# Paste a setup-token during onboarding
openclaw onboard --auth-choice setup-token

​

設定例（setup-token）

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

​

注意事項

• claude setup-token で setup-token を生成して貼り付けるか、ゲートウェイ ホストで openclaw models auth setup-token を実行してください。
• Claude subscription で OAuth token refresh failed ... と表示される場合は、setup-token で再認証してください。詳細は /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription を参照してください。
• 認証の詳細と再利用ルールは /concepts/oauth にあります。

​

トラブルシューティング

• Claude subscription 認証は期限切れや revoke が起こりえます。claude setup-token を再実行し、ゲートウェイ ホスト に貼り付けてください。
• Claude CLI のログインが別マシン上にある場合は、ゲートウェイ ホストで openclaw models auth paste-token --provider anthropic を使ってください。

• 認証は エージェント単位 です。新しいエージェントは main エージェントのキーを自動継承しません。
• 該当エージェントの onboarding をやり直すか、ゲートウェイ ホストで setup-token / API キーを追加し、openclaw models status で確認してください。

• openclaw models status を実行して、どの auth profile が有効か確認してください。
• onboarding をやり直すか、その profile 用の setup-token / API キーを登録してください。

• openclaw models status --json で auth.unusableProfiles を確認してください。
• 別の Anthropic profile を追加するか、cooldown が終わるまで待ってください。