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

​
Anthropic (Claude)

AnthropicはClaudeモデルファミリーを開発しており、APIと Claude CLIを通じて利用できます。OpenClawでは、Anthropic APIキーとClaude CLIの再利用の両方が サポートされています。既存のレガシーAnthropicトークンプロファイルも、すでに設定済みであれば 引き続きランタイムで尊重されます。
Anthropicのスタッフから、OpenClawスタイルのClaude CLI利用は再び許可されていると伝えられたため、 Anthropicが新しいポリシーを公開しない限り、OpenClawはこの統合においてClaude CLIの再利用とclaude -pの利用を許可済みとして扱います。長期間稼働するGatewayホストでは、Anthropic APIキーが依然として最も明確で 予測しやすい本番運用パスです。ホスト上ですでにClaude CLIを使っている場合、 OpenClawはそのログインを直接再利用できます。Anthropicの現在の公開ドキュメント:最も明確な課金パスを望む場合は、代わりにAnthropic APIキーを使ってください。 OpenClawは、OpenAI Codex、Qwen Cloud Coding Plan、 MiniMax Coding Plan、および Z.AI / GLM Coding Plan を含む、他のサブスクリプション型オプションもサポートしています。

​
オプションA: Anthropic APIキー

最適な用途: 標準的なAPIアクセスと従量課金。 APIキーはAnthropic Consoleで作成してください。

​
CLIセットアップ

openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​
Anthropic設定スニペット

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

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

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

​
Fast mode（Anthropic API）

OpenClawの共通/fastトグルは、APIキーおよびOAuth認証済みでapi.anthropic.comへ送信されるリクエストを含む、公開Anthropicへの直接トラフィックもサポートしています。
  • /fast on は service_tier: "auto" に対応
  • /fast off は service_tier: "standard_only" に対応
  • 設定デフォルト:
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
重要な制限:
  • OpenClawがAnthropic service tiersを注入するのは、直接のapi.anthropic.comリクエストに対してのみです。anthropic/*をプロキシまたはGateway経由でルーティングする場合、/fastはservice_tierを変更しません。
  • 明示的なAnthropicのserviceTierまたはservice_tierモデルパラメータが設定されている場合、両方があるときはそれらが/fastのデフォルトを上書きします。
  • Anthropicは有効なtierをレスポンスのusage.service_tierで報告します。Priority Tier容量のないアカウントでは、service_tier: "auto"でもstandardに解決される場合があります。

​
Prompt caching（Anthropic API）

OpenClawはAnthropicのprompt caching機能をサポートしています。これはAPI専用です。レガシーAnthropicトークン認証ではキャッシュ設定は尊重されません。

​
設定

モデル設定でcacheRetentionパラメータを使います。
ValueCache DurationDescription
noneキャッシュなしprompt cachingを無効化
short5分API Key認証のデフォルト
long1時間拡張キャッシュ
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

​
デフォルト

Anthropic API Key認証を使用している場合、OpenClawはすべてのAnthropicモデルに対して自動的にcacheRetention: "short"（5分キャッシュ）を適用します。設定でcacheRetentionを明示的に指定すれば、これをオーバーライドできます。

​
エージェントごとのcacheRetentionオーバーライド

モデルレベルのparamsをベースラインとして使い、その後agents.list[].paramsで特定のagentをオーバーライドします。 
{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // ほとんどのagent向けのベースライン
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // このagentだけのオーバーライド
    ],
  },
}
キャッシュ関連パラメータの設定マージ順序:
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params（一致するid、キーごとに上書き）
これにより、同じモデル上のあるagentは長時間のキャッシュを維持しつつ、別のagentはキャッシュを無効化して、突発的で再利用の少ないトラフィックにおける書き込みコストを避けられます。

​
Bedrock Claudeに関する注意

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

​
1Mコンテキストウィンドウ（Anthropic beta）

Anthropicの1Mコンテキストウィンドウはbeta制です。OpenClawでは、対応するOpus/Sonnetモデルごとに params.context1m: trueで有効にします。 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}
OpenClawはこれをAnthropic リクエスト上のanthropic-beta: context-1m-2025-08-07にマッピングします。 これは、そのモデルに対してparams.context1mが明示的にtrueに設定されている場合にのみ有効化されます。 要件: Anthropicがその認証情報で長コンテキスト利用を許可している必要があります。 注: Anthropicは現在、レガシーAnthropicトークン認証（sk-ant-oat-*）を使用している場合、 context-1m-* betaリクエストを拒否します。このレガシー認証モードで context1m: trueを設定した場合、OpenClawは警告をログに出し、 必要なOAuth betaは維持したまま、context1m beta ヘッダーをスキップして標準のコンテキストウィンドウへフォールバックします。

​
Claude CLIバックエンド

バンドル済みのAnthropic claude-cliバックエンドはOpenClawでサポートされています。
  • Anthropicのスタッフから、この利用は再び許可されていると伝えられました。
  • そのためOpenClawは、Anthropicが新しいポリシーを公開しない限り、この統合においてClaude CLIの再利用とclaude -pの利用を許可済みとして扱います。
  • Anthropic APIキーは、常時稼働するGateway ホストと明示的なサーバー側課金制御において、依然として最も明確な本番運用パスです。
  • セットアップとランタイムの詳細は/gateway/cli-backendsにあります。

​
注意事項

  • Anthropicの公開Claude Codeドキュメントは、依然として claude -pのような直接CLI利用を記載しており、AnthropicのスタッフからもOpenClawスタイルのClaude CLI利用は 再び許可されていると伝えられています。Anthropicが 新しいポリシー変更を公開しない限り、私たちはこのガイダンスを確定したものとして扱っています。
  • Anthropic setup-tokenは、サポートされるtoken-authパスとしてOpenClawで引き続き利用可能ですが、OpenClawは現在、利用可能な場合はClaude CLIの再利用とclaude -pを優先します。
  • 認証の詳細と再利用ルールは/concepts/oauthにあります。

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

401エラー / トークンが突然無効になった
  • Anthropicのトークン認証は期限切れまたは失効することがあります。
  • 新規セットアップでは、Anthropic APIキーへ移行してください。
provider “anthropic” のAPIキーが見つかりません
  • 認証はagentごとです。新しいagentはメインagentのキーを引き継ぎません。
  • そのagentに対してオンボーディングを再実行するか、Gateway ホストにAPIキーを設定してから、openclaw models statusで確認してください。
プロファイルanthropic:defaultの認証情報が見つかりません
  • どの認証プロファイルがアクティブかを確認するにはopenclaw models statusを実行してください。
  • オンボーディングを再実行するか、そのプロファイルパスにAPIキーを設定してください。
利用可能な認証プロファイルがありません（すべてクールダウン中/利用不可）
  • auth.unusableProfilesを確認するにはopenclaw models status --jsonを使ってください。
  • Anthropicのレート制限クールダウンはモデルスコープの場合があるため、現在のモデルがクールダウン中でも、兄弟のAnthropic モデルはまだ利用できる可能性があります。
  • 別のAnthropicプロファイルを追加するか、クールダウンが終わるまで待ってください。
詳細: /gateway/troubleshooting と /help/faq。