Anthropic

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

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

はじめに

openclaw onboard# choose: Anthropic API key

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

openclaw models list --provider anthropic

{  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}

claude --version

openclaw onboard# choose: Claude CLI

openclaw models list --provider anthropic

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

思考のデフォルト（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 リクエストでカスタム temperature 値も省略します。

Claude Opus 4.8 は OpenClaw ではデフォルトで thinking がオフのままです。/think high|xhigh|max で adaptive thinking を明示的に有効にすると、OpenClaw は Anthropic の Opus 4.8 effort 値を送信します。Claude 4.6 モデルのデフォルトは adaptive です。

メッセージごとに /think:<level> で上書きするか、モデルパラメーターで指定します。

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

安全拒否フォールバック（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 のプロンプトキャッシュ機能をサポートします。

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

{  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: {        "anthropic/claude-sonnet-4-6": {          params: { fastMode: true },        },      },    },  },}

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

トラブルシューティング

関連