メインコンテンツへスキップ
Anthropic は Claude モデルファミリーを構築しています。OpenClaw は 2 つの認証ルートをサポートしています。
  • APIキー - 使用量ベースの課金による Anthropic API への直接アクセス（anthropic/* モデル）
  • Claude CLI - 同じホスト上の既存の Claude Code ログインを再利用

​
使用量とコストの追跡

OpenClaw は利用可能な Anthropic 認証情報を検出し、一致する使用状況サーフェスを選択します。
  • Claude サブスクリプション/セットアップ認証情報では、クォータ期間と任意の追加使用量予算が表示されます。
  • ANTHROPIC_ADMIN_KEY または ANTHROPIC_ADMIN_API_KEY では、Control UI の 使用状況 に、プロバイダーが報告する過去 30 日間の組織コストと Messages API 使用量が表示されます。日次支出、トークン/キャッシュ合計、上位モデル、コストカテゴリが含まれます。
  • Anthropic プロバイダープロファイルに保存された sk-ant-admin... 認証情報は、Admin APIキーとして自動的に検出されます。
Admin API のコスト履歴は Anthropic の 使用量とコスト API から取得されます。これは実際のプロバイダー請求であり、OpenClaw のセッション由来の推定コストとは別です。
OpenClaw の Claude CLI バックエンドは、インストール済みの Claude Code CLI を 非対話型の print モード（claude -p）で実行します。Anthropic の現在の Claude Code ドキュメントでは、 そのモードを Agent SDK/プログラム的使用として説明しています。Anthropic の 2026 年 6 月 15 日の サポート更新では、発表済みだった別個の Agent SDK 課金変更が一時停止されました。Claude Agent SDK、claude -p、サードパーティアプリの使用は、引き続きサインイン中の サブスクリプションの使用制限から消費されます。また、以前に発表された月次 Agent SDK クレジットは、Anthropic がそのプランを見直している間は利用できません。対話型の Claude Code も、引き続きサインイン中の Claude プランの制限から消費されます。 APIキー認証は直接の従量課金であり、そのプランには依存しません。 長期間稼働する Gateway ホスト、共有自動化、予測可能な本番 支出には、Anthropic APIキーを使用してください。Anthropic の現在のサポート記事により、この動作は OpenClaw リリースなしで変更される可能性があります。

​
はじめに

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

APIキーを取得する

Anthropic Console で APIキーを作成します。
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: "example-anthropic-key-not-real" },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },
}

​
Thinking のデフォルト（Claude Fable 5、4.8、4.6）

anthropic/claude-fable-5 は常に adaptive thinking を使用し、デフォルトは high effort です。Anthropic はこのモデルで thinking を無効にすることを許可していないため、 /think off と /think minimal は代わりに low effort にマッピングされます。OpenClaw はまた、 Fable 5 リクエストではカスタム温度値を省略します。Anthropic が thinking が有効なすべてのリクエストで温度オーバーライドを拒否するためです。 Claude Opus 4.8 は OpenClaw ではデフォルトで thinking をオフのままにします。/think high|xhigh|max で adaptive thinking を明示的に 有効にすると、OpenClaw は Anthropic の Opus 4.8 effort 値を送信します。Claude 4.6 モデル（Opus 4.6 と Sonnet 4.6）は デフォルトで adaptive になります。 メッセージごとに /think:<level> で、またはモデルパラメータでオーバーライドします。 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-8": {
          params: { thinking: "high" },
        },
      },
    },
  },
}
関連する Anthropic ドキュメント:

​
安全性拒否フォールバック（Claude Fable 5）

Claude Fable 5 を使用することは、Claude Opus 4.8 も使用することを意味します。Fable 5 には リクエストを拒否できる安全性分類器が同梱されており、Anthropic が認める 回復方法は、そのターンを claude-opus-4-8 に処理させることです。OpenClaw は 直接の APIキーリクエストではこれに自動的にオプトインするため、一部の Fable ターンは Claude Opus 4.8 として回答され、課金されます。ポリシーまたは予算上、 Opus が処理するターンを受け入れられない場合は、anthropic/claude-fable-5 を選択しないでください。

​
これが存在する理由

Fable 5 の分類器は、制限付き ドメインのリクエストで stop_reason: "refusal" を返し、良性に近い作業（セキュリティ ツール、ライフサイエンス、さらにはモデルに生の 推論を再現させる依頼）でも誤検知することがあります。フォールバックがない場合、別の Claude モデルなら問題なく処理できる場合でも、 ターンはエラーで終了します。Anthropic 自身の拒否メッセージは、 API インテグレーターにフォールバックモデルを設定するよう伝えています。

​
仕組み

  1. anthropic/claude-fable-5 へのすべての直接 APIキーリクエストで、OpenClaw は Anthropic のサーバー側フォールバックのオプトインを送信します。つまり、 server-side-fallback-2026-06-01 ベータヘッダーと fallbacks: [{"model": "claude-opus-4-8"}] です。Claude Opus 4.8 は、Anthropic が Fable 5 に対して許可する唯一の フォールバックターゲットです。
  2. 安全性分類器による拒否のみがフォールバックをトリガーします。レート制限、 過負荷、サーバーエラーは以前とまったく同じように動作し、 OpenClaw の通常の モデルフェイルオーバー を通ります。
  3. レスキューは同じ呼び出しの内部で発生します。出力前の拒否は レイテンシ以外では見えません。回答全体が Opus 4.8 から返されます。 ストリーム途中の拒否では、部分テキストがフォールバック モデルの継続元プレフィックスとして保持され、一方で拒否されたモデルの推論とツール呼び出しは Anthropic のリプレイルールに従って破棄されます（それらを返したり 実行したりしてはなりません）。
  4. Claude Opus 4.8 も拒否した場合、そのターンは この機能以前とまったく同じように拒否をエラーとして表面化します。
フォールバックは Anthropic API レベルで発生するため、claude-opus-4-8 は 設定済みのモデルリストやフォールバックチェーンに含まれている必要はありません。Fable 対応の APIキーであれば、常に Opus を提供できます。

​
可観測性と課金

  • フォールバックで処理されたターンは、アシスタントメッセージに fromModel と toModel を示す provider_fallback 診断を記録し、メッセージの responseModel は claude-opus-4-8 を報告します。
  • Anthropic は試行ごとに課金します。出力前の拒否は無料で、レスキューは Claude Opus 4.8 の料金（現在は Fable 5 の料金の半分）で課金されます。OpenClaw の ターンごとのコスト推定も、これに合わせてフォールバック処理されたターンを Opus 料金で価格付けします。
  • ストリーム途中の拒否では、すでにストリーミングされた Fable の部分も Anthropic 側で追加課金されます。その部分は API の試行ごとの 使用量に報告されますが、OpenClaw のターンごとの推定には組み込まれません。

​
スコープ

api.anthropic.com に対する APIキー認証の anthropic/claude-fable-5 に適用されます。OAuth（Claude CLI サブスクリプション再利用）、プロキシベース URL、 Bedrock、Vertex、Foundry リクエストは変更されず、そこでは引き続き 拒否がエラーとして表面化します。 ライブ検証済み: Fable 5 に生の chain of thought を再現するよう求める良性のプロンプトは、フォールバックなしで送信すると category: "reasoning_extraction" で拒否され、OpenClaw 経由の同じプロンプトは provider_fallback 診断が添付された通常の Opus 処理の回答を返します。 基礎となる動作については、Anthropic の 拒否とフォールバック ガイド を参照してください。

​
プロンプトキャッシュ

OpenClaw は APIキー認証で Anthropic のプロンプトキャッシュ機能をサポートしています。
値キャッシュ期間説明
"short" (デフォルト)5分APIキー認証に自動適用
"long"1時間拡張キャッシュ
"none"キャッシュなしプロンプトキャッシュを無効化
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
モデルレベルの params をベースラインとして使用し、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キーのスマートデフォルトは Claude-on-Bedrock 参照にも cacheRetention: "short" を設定します。

​
高度な設定

OpenClaw の共有 /fast トグルは、api.anthropic.com への直接 APIキー トラフィックに対して Anthropic の service_tier フィールドを設定します。
コマンド対応先
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • APIキーで行われる直接の api.anthropic.com リクエストにのみ適用されます。OAuth/サブスクリプショントークンのリクエストとプロキシルートには、service_tier フィールドは追加されません。
  • 明示的な serviceTier または service_tier params は、両方が設定されている場合に /fast を上書きします。
  • Priority Tier 容量がないアカウントでは、service_tier: "auto" が standard に解決される場合があります。
バンドルされた Anthropic Plugin は、画像と PDF の理解を登録します。OpenClaw は 設定済みの Anthropic 認証からメディア機能を自動解決します。追加の 設定は不要です。
プロパティ値
デフォルトモデルclaude-opus-4-8
サポートされる入力画像、PDFドキュメント
会話に画像または PDF が添付されると、OpenClaw は自動的に Anthropic メディア理解プロバイダー経由でルーティングします。
Anthropic の 1M コンテキストウィンドウは、adaptive thinking 対応の Claude 4.x モデルで GA です。対象は Opus 4.8、Opus 4.7、Opus 4.6、Sonnet 4.6 です。OpenClaw はこれらの モデルを自動的に 1,048,576 トークンとしてサイズ設定するため、params.context1m は不要です。
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {},
      },
    },
  },
}
古い設定では params.context1m: true を残してもかまいません。これらの モデルでは無害な no-op であり、OpenClaw は廃止済みの context-1m-2025-08-07 beta ヘッダーを今後送信しません。その値を持つ古い anthropicBeta 設定 エントリはリクエストヘッダー解決時に削除され、 サポート対象外の古い Claude モデルは通常のコンテキストウィンドウのままです。params.context1m: true は Claude CLI バックエンド （claude-cli/*）でも同じように動作します。対象の GA 対応 Opus および Sonnet モデルはすでに 1M ウィンドウを自動的に取得するため、この param はそこでも任意です。
Anthropic 資格情報でロングコンテキストアクセスが必要です。OAuth/サブスクリプショントークン認証は必要な Anthropic beta ヘッダーを維持しますが、OpenClaw は古い設定に廃止済みの 1M beta ヘッダーが残っている場合、それを削除します。
anthropic/claude-opus-4-8 とその claude-cli バリアントは、デフォルトで 1M コンテキスト ウィンドウを持ちます。params.context1m: true は不要です。

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

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

​
関連

モデル選択

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

CLI バックエンド

Claude CLI バックエンドのセットアップと実行時の詳細。

プロンプトキャッシュ

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

OAuth と認証

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