OpenClawでAnthropic Claudeを統合：API設定とキャッシュ最適化

Claude を使った開発を進める中で、API キーの管理やサブスクリプションの活用方法に悩むことはありませんか？プロジェクトごとに設定を切り替えたり、最新モデルの機能を最大限に引き出したりするのは、意外と手間がかかるものです。

OpenClaw を使えば、Anthropic の強力なモデル群をスムーズに統合できます。この記事では、API キーを使用した標準的な接続から、Claude サブスクリプションを活かした高度な設定まで、最適なセットアップ方法を解説します。

Anthropic (Claude)

Anthropic は Claude モデルファミリーを開発しており、API を通じてアクセスを提供しています。 OpenClaw では、API キーまたは setup-token を使用して認証を行うことができます。

オプション A: Anthropic API key

最適なケース: 標準的な API アクセスや、従量課金ベースでの利用。 Anthropic Console で API キーを作成してください。

CLI でのセットアップ

openclaw onboard
# choose: Anthropic API key

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

Claude CLI 設定スニペット

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

Thinking のデフォルト設定 (Claude 4.6)

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

Fast mode (Anthropic API)

OpenClaw の共有 /fast トグルは、api.anthropic.com に送信される API キー認証および OAuth 認証のリクエストを含む、直接的な Anthropic トラフィックをサポートしています。

/fast on は service_tier: "auto" にマッピングされます
/fast off は service_tier: "standard_only" にマッピングされます
デフォルト設定：

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

重要な制限事項：

OpenClaw は、api.anthropic.com への直接リクエストに対してのみ Anthropic のサービスティアを挿入します。プロキシや Gateway を経由して anthropic/* をルーティングする場合、/fast は service_tier に影響を与えません。
明示的な Anthropic の serviceTier または service_tier モデルパラメータが設定されている場合、両方が設定されていても /fast のデフォルト設定より優先されます。
Anthropic は、レスポンスの usage.service_tier で有効なティアを報告します。Priority Tier のキャパシティがないアカウントでは、service_tier: "auto" を設定していても standard として処理される場合があります。

Prompt caching (Anthropic API)

OpenClaw は Anthropic の Prompt caching 機能をサポートしています。これは API 専用の機能であり、サブスクリプション認証ではキャッシュ設定は適用されません。

設定方法

モデル設定で cacheRetention パラメータを使用します：

値	キャッシュ保持期間	説明
`none`	キャッシュなし	Prompt caching を無効化します
`short`	5 分間	API キー認証のデフォルト設定です
`long`	1 時間	キャッシュを延長します（beta フラグが必要）

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

デフォルト設定

Anthropic API キー認証を使用する場合、OpenClaw はすべての Anthropic モデルに対して自動的に cacheRetention: "short"（5 分間のキャッシュ）を適用します。設定ファイルで cacheRetention を明示的に指定することで、この挙動を上書きできます。

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

モデルレベルのパラメータをベースラインとして使用し、agents.list[].params を通じて特定のエージェントの設定を上書きできます。

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // baseline for most agents
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // override for this agent only
    ],
  },
}

キャッシュ関連パラメータの構成マージ順序：

agents.defaults.models["provider/model"].params
agents.list[].params（id が一致するもの。キー単位で上書き）

これにより、あるエージェントでは長期キャッシュを保持しつつ、別のアージェントでは再利用性の低いバースト的なトラフィックによる書き込みコストを避けるためにキャッシュを無効化する、といった運用が可能です。

Bedrock Claude に関する注意点

Bedrock 上の Anthropic Claude モデル（amazon-bedrock/*anthropic.claude*）は、設定されている場合 cacheRetention のパススルーを受け入れます。
Anthropic 以外の Bedrock モデルは、実行時に強制的に cacheRetention: "none" となります。
Anthropic API キーのスマートデフォルト設定は、明示的な値が設定されていない場合、Claude-on-Bedrock モデルに対しても cacheRetention: "short" を適用します。

レガシーパラメータ

旧バージョンの cacheControlTtl パラメータも、後方互換性のために引き続きサポートされています：

"5m" は short にマッピングされます
"1h" は long にマッピングされます

新しい cacheRetention パラメータへの移行を推奨します。

OpenClaw は Anthropic API リクエストに extended-cache-ttl-2025-04-11 beta フラグを含めています。プロバイダーヘッダーを上書きする場合は、このフラグを保持するようにしてください（詳細は /gateway/configuration を参照）。

1M context window (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 に設定されている場合にのみ有効になります。

要件：使用している認証情報（通常は API キーの課金アカウント、または Extra Usage が有効なサブスクリプションアカウント）で、Anthropic が長いコンテキストの使用を許可している必要があります。許可されていない場合、Anthropic は以下のエラーを返します： HTTP 429: rate_limit_error: Extra usage is required for long context requests.

注意：Anthropic は現在、サブスクリプションの setup-token（sk-ant-oat-*）を使用している場合、context-1m-* beta リクエストを拒否します。サブスクリプション認証で context1m: true を設定した場合、OpenClaw は警告をログに出力し、必要な OAuth beta ヘッダーは維持しつつ context1m beta ヘッダーをスキップすることで、標準のコンテキストウィンドウにフォールバックします。

オプション B: メッセージプロバイダーとして Claude CLI を使用する

最適なケース: すでに Claude CLI がインストールされ、Claude サブスクリプションでサインインしているシングルユーザーの Gateway ホスト。

この方法では、Anthropic API を直接呼び出す代わりに、ローカルの claude バイナリを使用してモデル推論を行います。OpenClaw はこれを CLI backend provider として扱い、以下のようなモデル参照を使用します：

claude-cli/claude-sonnet-4-6
claude-cli/claude-opus-4-6

仕組み：

OpenClaw が Gateway ホスト上で claude -p --output-format json ... を起動します。
最初のターンで --session-id <uuid> を送信します。
以降のターンでは、--resume <sessionId> を使用して保存された Claude セッションを再利用します。
チャットメッセージは通常の OpenClaw メッセージパイプラインを通過しますが、実際のモデルの回答は Claude CLI によって生成されます。

要件

Gateway ホストに Claude CLI がインストールされ、PATH が通っていること。または絶対パスでコマンドが設定されていること。
同じホスト上で Claude CLI が認証済みであること：

claude auth status

設定で claude-cli/... または claude-cli バックエンド設定が明示的に参照されている場合、OpenClaw は Gateway 起動時に同梱の Anthropic プラグインを自動的にロードします。

設定スニペット

{
  agents: {
    defaults: {
      model: {
        primary: "claude-cli/claude-sonnet-4-6",
      },
      models: {
        "claude-cli/claude-sonnet-4-6": {},
      },
      sandbox: { mode: "off" },
    },
  },
}

claude バイナリが Gateway ホストの PATH に含まれていない場合：

{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
      },
    },
  },
}

メリット

ローカル CLI で使用している Claude サブスクリプション認証を再利用できます。
通常の OpenClaw メッセージ/セッションルーティングを利用できます。
ターンをまたいで Claude CLI のセッション継続性を維持できます。

Anthropic 認証から Claude CLI への移行

現在 setup-token や API キーで anthropic/... を使用しており、同じ Gateway ホストを Claude CLI に切り替えたい場合：

openclaw models auth login --provider anthropic --method cli --set-default

またはオンボーディング時：

openclaw onboard --auth-choice anthropic-cli

この操作により以下の処理が行われます：

Gateway ホストで Claude CLI がサインイン済みであることを確認します。
デフォルトモデルを claude-cli/... に切り替えます。
anthropic/claude-opus-4-6 のような Anthropic デフォルトモデルのフォールバックを claude-cli/claude-opus-4-6 に書き換えます。
agents.defaults.models に対応する claude-cli/... エントリを追加します。

以下の処理は行われません：

既存の Anthropic 認証プロファイルの削除。
メインのデフォルトモデルや許可リスト以外の場所にある古い anthropic/... 設定参照の削除。

そのため、必要に応じてデフォルトモデルを anthropic/... に戻すだけで、簡単にロールバックが可能です。

重要な制限事項

これは Anthropic API プロバイダーではありません。ローカルの CLI ランタイムです。
CLI バックエンド実行時、OpenClaw 側のツール（Tools）は無効になります。
テキスト入力、テキスト出力のみをサポートします。OpenClaw のストリーミングハンドオフは利用できません。
複数ユーザーでの課金共有セットアップではなく、個人用 Gateway ホストに最適です。

詳細：/gateway/cli-backends

オプション C: Claude setup-token

最適なケース: 自身の Claude サブスクリプションを使用する場合。

setup-token の取得方法

setup-token は Anthropic Console ではなく、Claude Code CLI によって作成されます。これは任意のマシンで実行可能です：

claude setup-token

表示されたトークンを OpenClaw に貼り付けるか（ウィザード：Anthropic token (paste setup-token)）、Gateway ホストで以下を実行してください：

openclaw models auth setup-token --provider anthropic

別のマシンでトークンを生成した場合は、それを貼り付けます：

openclaw models auth paste-token --provider anthropic

CLI でのセットアップ (setup-token)

# Paste a setup-token during setup
openclaw onboard --auth-choice setup-token

設定スニペット (setup-token)

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

注意事項

claude setup-token で setup-token を生成して貼り付けるか、Gateway ホストで openclaw models auth setup-token を実行してください。
Claude サブスクリプションで「OAuth token refresh failed …」と表示される場合は、setup-token で再認証を行ってください。詳細は /gateway/troubleshooting を参照してください。
認証の詳細と再利用ルールについては /concepts/oauth に記載されています。

トラブルシューティング

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

Claude サブスクリプション認証は期限切れになったり、取り消されたりすることがあります。claude setup-token を再実行し、Gateway ホストに貼り付けてください。
Claude CLI のログインが別のマシンにある場合は、Gateway ホストで openclaw models auth paste-token --provider anthropic を使用してください。

No API key found for provider “anthropic”

認証はエージェントごとに行われます。新しいエージェントは、メインエージェントのキーを継承しません。
そのエージェントに対してオンボーディングを再実行するか、Gateway ホストで setup-token / API キーを貼り付け、openclaw models status で確認してください。

No credentials found for profile anthropic:default

openclaw models status を実行して、どの認証プロファイルがアクティブかを確認してください。
オンボーディングを再実行するか、そのプロファイルに対して setup-token / API キーを貼り付けてください。

No available auth profile (all in cooldown/unavailable)

openclaw models status --json を実行し、auth.unusableProfiles を確認してください。
別の Anthropic プロファイルを追加するか、クールダウンが終わるまで待機してください。

詳細：/gateway/troubleshooting および /help/faq

次のステップ

AI Setup Assistant

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。