プロバイダー

Anthropic

AnthropicはClaudeモデルファミリーを構築し、API経由でアクセスを提供しています。OpenClawでは、APIキーまたはsetup-tokenを使用して認証できます。

オプションA: Anthropic APIキー

最適な用途: 標準的なAPIアクセスと使用量ベースの課金。AnthropicコンソールでAPIキーを作成します。

CLIセットアップ

openclaw onboard
# 選択: Anthropic API key

# または非対話型
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

設定スニペット

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

思考のデフォルト (Claude 4.6)

Anthropic Claude 4.6モデルは、明示的な思考レベルが設定されていない場合、OpenClawではデフォルトでadaptive思考を使用します。
メッセージごとに上書き（/think:<レベル>）するか、モデルパラメータで上書きできます: agents.defaults.models["anthropic/<モデル>"].params.thinking。
関連するAnthropicドキュメント:
- 適応的思考
- 拡張思考

プロンプトキャッシング (Anthropic API)

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

設定

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

値	キャッシュ期間	説明
`none`	キャッシングなし	プロンプトキャッシングを無効化
`short`	5分	APIキー認証のデフォルト
`long`	1時間	拡張キャッシュ (ベータフラグが必要)

{
  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" }, // ほとんどのエージェントのベースライン
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // このエージェントのみ上書き
    ],
  },
}

キャッシュ関連パラメータの設定マージ順序:

agents.defaults.models["provider/model"].params
agents.list[].params (一致するid、キーごとに上書き)

これにより、1つのエージェントが長期間のキャッシュを保持し、同じモデル上の別のエージェントはバースト的/再利用率の低いトラフィックでの書き込みコストを避けるためにキャッシングを無効にできます。

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ベータフラグが含まれています。プロバイダーヘッダーを上書きする場合は保持してください (/gateway/configurationを参照)。

100万トークンコンテキストウィンドウ (Anthropic ベータ)

Anthropicの100万トークンコンテキストウィンドウはベータゲートされています。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はその認証情報に対して長いコンテキストの使用を許可する必要があります (通常はAPIキー課金、またはExtra Usageが有効なサブスクリプションアカウント)。そうでない場合、AnthropicはHTTP 429: rate_limit_error: Extra usage is required for long context requestsを返します。注: Anthropicは現在、OAuth/サブスクリプショントークン (sk-ant-oat-*) を使用する場合、context-1m-*ベータリクエストを拒否します。OpenClawはOAuth認証に対してcontext1mベータヘッダーを自動的にスキップし、必要なOAuthベータを保持します。

オプションB: Claude setup-token

最適な用途: Claudeサブスクリプションの使用。

setup-tokenの入手方法

Setup-tokenはAnthropicコンソールではなく、Claude Code CLIによって作成されます。これは任意のマシンで実行できます:

claude setup-token

トークンをOpenClawに貼り付けます (ウィザード: Anthropic token (paste setup-token))、またはゲートウェイホストで実行します:

openclaw models auth setup-token --provider anthropic

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

openclaw models auth paste-token --provider anthropic

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

# オンボーディング中にsetup-tokenを貼り付け
openclaw onboard --auth-choice setup-token

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

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

注意点

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

トラブルシューティング

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

Claudeサブスクリプション認証は期限切れまたは取り消される可能性があります。claude setup-tokenを再実行し、ゲートウェイホストに貼り付けます。
Claude CLIログインが別のマシンにある場合は、ゲートウェイホストでopenclaw models auth paste-token --provider anthropicを使用します。

プロバイダー「anthropic」のAPIキーが見つかりません

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

プロファイルanthropic:defaultの認証情報が見つかりません

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

利用可能な認証プロファイルがありません (すべてクールダウン中/利用不可)

openclaw models status --jsonでauth.unusableProfilesを確認します。
別のAnthropicプロファイルを追加するか、クールダウンを待ちます。

詳細: /gateway/troubleshooting および /help/faq。

モデルフェイルオーバー Amazon Bedrock