Providers

Anthropic

Anthropic は Claude モデルファミリーを構築しています。OpenClaw は 2 つの認証ルートをサポートしています。

API キー — 使用量ベースの課金による Anthropic API への直接アクセス（anthropic/* モデル）
Claude CLI — 同じホスト上の既存の Claude CLI ログインを再利用

はじめに

API キー

最適な用途: 標準の API アクセスと使用量ベースの課金。

API キーを取得する

Anthropic Console で API キーを作成します。

オンボーディングを実行する

openclaw onboard
# choose: Anthropic API key

または、キーを直接渡します:

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

モデルが利用可能か確認する

openclaw models list --provider anthropic

設定例

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

Claude CLI

最適な用途: 別の API キーなしで既存の Claude CLI ログインを再利用する場合。

Claude CLI がインストールされ、ログイン済みであることを確認する

次で確認します:

claude --version

オンボーディングを実行する

openclaw onboard
# choose: Claude CLI

OpenClaw は既存の Claude CLI 認証情報を検出して再利用します。

モデルが利用可能か確認する

openclaw models list --provider anthropic

設定例

正規の Anthropic モデル参照に CLI ランタイムのオーバーライドを組み合わせることを推奨します:

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-7" },
      agentRuntime: { id: "claude-cli" },
    },
  },
}

レガシーな claude-cli/claude-opus-4-7 モデル参照も互換性のために引き続き機能しますが、新しい設定では provider/model の選択を anthropic/* のままにし、実行バックエンドを agentRuntime.id に指定してください。

thinking のデフォルト（Claude 4.6）

Claude 4.6 モデルは、明示的な thinking レベルが設定されていない場合、OpenClaw ではデフォルトで adaptive thinking を使用します。

メッセージごとに /think:<level> で、またはモデルパラメータ内でオーバーライドします:

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

プロンプトキャッシュ

OpenClaw は、API キー認証向けに Anthropic のプロンプトキャッシュ機能をサポートしています。

値	キャッシュ期間	説明
`"short"`（デフォルト）	5 分	API キー認証で自動的に適用されます
`"long"`	1 時間	拡張キャッシュ
`"none"`	キャッシュなし	プロンプトキャッシュを無効化します

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

エージェントごとのキャッシュオーバーライド

モデルレベルのパラメータをベースラインとして使用し、agents.list[].params で特定のエージェントをオーバーライドします:

{
  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" } },
    ],
  },
}

設定のマージ順序:

agents.defaults.models["provider/model"].params
agents.list[].params（一致する id、キーごとにオーバーライド）

これにより、同じモデル上の別のエージェントがバースト的で再利用の少ないトラフィック向けにキャッシュを無効化する一方で、あるエージェントは長期間有効なキャッシュを維持できます。

Bedrock Claude の注意事項

Bedrock 上の Anthropic Claude モデル（amazon-bedrock/*anthropic.claude*）は、設定されている場合に cacheRetention のパススルーを受け付けます。
Anthropic 以外の Bedrock モデルは、ランタイムで cacheRetention: "none" に強制されます。
API キーのスマートデフォルトは、明示的な値が設定されていない場合、Claude-on-Bedrock 参照にも cacheRetention: "short" を初期値として設定します。

高度な設定

高速モード

OpenClaw の共有 /fast トグルは、Anthropic への直接トラフィック（API キーおよび api.anthropic.com への OAuth）をサポートします。

コマンド	対応先
`/fast on`	`service_tier: "auto"`
`/fast off`	`service_tier: "standard_only"`

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

メディア理解（画像と PDF）

バンドルされた Anthropic Plugin は、画像と PDF の理解を登録します。OpenClaw は、設定済みの Anthropic 認証からメディア機能を自動解決します。追加設定は不要です。

プロパティ	値
デフォルトモデル	`claude-opus-4-7`
サポートされる入力	画像、PDF ドキュメント

画像または PDF が会話に添付されると、OpenClaw は自動的に Anthropic メディア理解プロバイダー経由でルーティングします。

1M コンテキストウィンドウ（ベータ）

Anthropic の 1M コンテキストウィンドウはベータで制限されています。モデルごとに有効化します:

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

OpenClaw はリクエスト上でこれを anthropic-beta: context-1m-2025-08-07 にマッピングします。

params.context1m: true は、対象となる Opus および Sonnet モデルの Claude CLI バックエンド（claude-cli/*）にも適用され、その CLI セッションのランタイムコンテキストウィンドウを直接 API の動作に合わせて拡張します。

Claude Opus 4.7 1M コンテキスト

anthropic/claude-opus-4.7 とその claude-cli バリアントは、デフォルトで 1M コンテキストウィンドウを持ちます。params.context1m: true は不要です。

トラブルシューティング

401 エラー / トークンが突然無効になる

Anthropic トークン認証は期限切れになり、取り消されることがあります。新規セットアップでは、代わりに Anthropic API キーを使用してください。

プロバイダー "anthropic" の API キーが見つかりません

Anthropic 認証は エージェントごと です。新しいエージェントはメインエージェントのキーを継承しません。そのエージェントでオンボーディングを再実行するか（または gateway ホストで API キーを設定して）、openclaw models status で確認してください。

プロファイル "anthropic:default" の認証情報が見つかりません

openclaw models status を実行して、どの認証プロファイルがアクティブか確認します。オンボーディングを再実行するか、そのプロファイルパスに API キーを設定してください。

利用可能な認証プロファイルがありません（すべてクールダウン中）

openclaw models status --json で auth.unusableProfiles を確認してください。Anthropic のレート制限クールダウンはモデルスコープの場合があるため、同系統の別の Anthropic モデルはまだ使用できる可能性があります。別の Anthropic プロファイルを追加するか、クールダウンを待ってください。

Anthropic

はじめに

API キー

API キーを取得する

オンボーディングを実行する

モデルが利用可能か確認する

設定例

Claude CLI

Claude CLI がインストールされ、ログイン済みであることを確認する

オンボーディングを実行する

モデルが利用可能か確認する

設定例

thinking のデフォルト（Claude 4.6）

プロンプトキャッシュ

高度な設定

トラブルシューティング

関連

Ask OpenClaw

# はじめに

API キー

API キーを取得する

オンボーディングを実行する

モデルが利用可能か確認する

# 設定例

Claude CLI

Claude CLI がインストールされ、ログイン済みであることを確認する

オンボーディングを実行する

モデルが利用可能か確認する

# 設定例

# thinking のデフォルト（Claude 4.6）

# プロンプトキャッシュ

# 高度な設定

# トラブルシューティング

# 関連

はじめに

設定例

設定例

thinking のデフォルト（Claude 4.6）

プロンプトキャッシュ

高度な設定

トラブルシューティング

関連