メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Anthropic は Claude モデルファミリーを構築しています。OpenClaw は 2 つの認証ルートをサポートします。
  • API key — 使用量ベースの課金による Anthropic API への直接アクセス（anthropic/* モデル）
  • Claude CLI — 同じホスト上の既存の Claude CLI ログインを再利用
Anthropic スタッフは、OpenClaw スタイルの Claude CLI 利用が再び許可されたと私たちに伝えたため、 Anthropic が新しいポリシーを公開しない限り、OpenClaw は Claude CLI の再利用と claude -p の利用を認可済みとして扱います。長期稼働する Gateway ホストでは、Anthropic API key が依然として最も明確で 予測しやすい本番パスです。Anthropic の現在の公開ドキュメント:

​
はじめに

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

API key を取得する

Anthropic Console で API key を作成します。
2

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

openclaw onboard
# choose: Anthropic API key
または、キーを直接渡します。
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

モデルが利用可能であることを確認する

openclaw models list --provider anthropic

​
設定例

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

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

Claude 4.6 モデルは、明示的な thinking レベルが設定されていない場合、OpenClaw でデフォルトで adaptive thinking になります。 メッセージごとに /think:<level> で、またはモデルパラメータでオーバーライドします。 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}
関連する Anthropic ドキュメント:

​
プロンプトキャッシュ

OpenClaw は、API-key 認証向けに Anthropic のプロンプトキャッシュ機能をサポートします。
値キャッシュ期間説明
"short" (デフォルト)5 分API-key 認証で自動的に適用されます
"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" } },
    ],
  },
}
設定のマージ順序:
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params（id が一致するもの。キーごとにオーバーライド）
これにより、あるエージェントは長期間有効なキャッシュを保持し、同じモデル上の別のエージェントはバースト的または再利用の少ないトラフィック向けにキャッシュを無効化できます。
  • Bedrock 上の Anthropic Claude モデル（amazon-bedrock/*anthropic.claude*）は、設定されている場合 cacheRetention のパススルーを受け入れます。
  • Anthropic 以外の Bedrock モデルは、ランタイムで cacheRetention: "none" に強制されます。
  • API-key のスマートデフォルトは、明示的な値が設定されていない場合、Claude-on-Bedrock 参照にも cacheRetention: "short" をシードします。

​
高度な設定

OpenClaw の共有 /fast トグルは、Anthropic への直接トラフィック（API-key と api.anthropic.com への OAuth）をサポートします。
コマンド対応先
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • 直接の api.anthropic.com リクエストにのみ注入されます。プロキシルートでは service_tier は変更されません。
  • 明示的な serviceTier または service_tier パラメータは、両方が設定されている場合 /fast をオーバーライドします。
  • Priority Tier 容量がないアカウントでは、service_tier: "auto" が standard に解決される場合があります。
同梱の Anthropic plugin は、画像と PDF の理解を登録します。OpenClaw は 設定された Anthropic 認証からメディア機能を自動解決します。追加の 設定は不要です。
プロパティ値
デフォルトモデルclaude-opus-4-7
サポート入力画像、PDF ドキュメント
画像または PDF が会話に添付されると、OpenClaw は自動的に Anthropic メディア理解プロバイダー経由でルーティングします。
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 の挙動に合わせて拡張します。
Anthropic 認証情報で長いコンテキストへのアクセスが必要です。従来のトークン認証（sk-ant-oat-*）は 1M コンテキストリクエストでは拒否されます。OpenClaw は警告をログに記録し、標準のコンテキストウィンドウにフォールバックします。
anthropic/claude-opus-4.7 とその claude-cli バリアントは、デフォルトで 1M コンテキスト ウィンドウを持ちます。params.context1m: true は不要です。

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

Anthropic トークン認証は期限切れになり、取り消される場合があります。新しいセットアップでは、代わりに Anthropic API key を使用してください。
Anthropic 認証はエージェントごとです。新しいエージェントはメインエージェントのキーを継承しません。そのエージェントでオンボーディングを再実行するか（または Gateway ホストで API key を設定し）、その後 openclaw models status で確認してください。
openclaw models status を実行して、どの認証プロファイルがアクティブかを確認してください。オンボーディングを再実行するか、そのプロファイルパスに API key を設定してください。
openclaw models status --json で auth.unusableProfiles を確認してください。Anthropic のレート制限クールダウンはモデルスコープの場合があるため、同系統の別の Anthropic モデルはまだ利用できる場合があります。別の Anthropic プロファイルを追加するか、クールダウンを待ってください。
追加のヘルプ: トラブルシューティング と FAQ。

​
関連

モデル選択

プロバイダー、モデル参照、フェイルオーバー挙動の選択。

CLI バックエンド

Claude CLI バックエンドのセットアップとランタイム詳細。

プロンプトキャッシュ

プロバイダー全体でプロンプトキャッシュがどのように機能するか。

OAuth と認証

認証の詳細と認証情報の再利用ルール。