Anthropic (Claude)

AnthropicはClaudeモデルファミリーを開発しており、APIを通じてアクセスできます。 OpenClawでは、APIキーまたはsetup-tokenで認証できます。

方法A：Anthropic APIキー

おすすめ： 標準的なAPIアクセスと従量課金。 Anthropic ConsoleでAPIキーを作成してください。

CLIセットアップ

openclaw onboard
# choose: 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" } } },
}

Thinkingのデフォルト設定（Claude 4.6）

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

Fastモード（Anthropic API）

OpenClawの共通/fastトグルは、Anthropic APIキー経由の直接トラフィックにも対応しています。

  • /fast on → service_tier: "auto"
  • /fast off → service_tier: "standard_only"
  • 設定デフォルト：
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-5": {
          params: { fastMode: true },
        },
      },
    },
  },
}

重要な制限事項：

  • APIキー専用です。Anthropic setup-token / OAuth認証ではOpenClawのFastモードティア注入は機能しません。
  • OpenClawがAnthropic service tierを注入するのはapi.anthropic.comへの直接リクエストのみです。anthropic/*をプロキシやゲートウェイ経由で配信している場合、/fastはservice_tierに影響しません。
  • Anthropicはレスポンスのusage.service_tierで実効ティアを報告します。Priority Tier容量のないアカウントでは、service_tier: "auto"がstandardに解決される場合があります。

プロンプトキャッシュ（Anthropic API）

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

設定

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

値キャッシュ期間説明
noneキャッシュなしプロンプトキャッシュを無効化
short5分APIキー認証のデフォルト
long1時間拡張キャッシュ（betaフラグ必要）
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

デフォルト

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

エージェント単位のcacheRetention上書き

モデルレベルの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 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コンテキストウィンドウ（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がその認証情報でロングコンテキスト使用を許可している必要があります（通常はAPIキー課金、またはExtra Usageが有効なサブスクリプションアカウント）。そうでなければ、Anthropicは次のエラーを返します： HTTP 429: rate_limit_error: Extra usage is required for long context requests

注意：Anthropicは現在、OAuth/サブスクリプショントークン（sk-ant-oat-*）ではcontext-1m-* betaリクエストを拒否します。OpenClawはOAuth認証時にcontext1m betaヘッダーを自動的にスキップし、必要なOAuth betaのみを維持します。

方法B：Claude setup-token

おすすめ： Claudeサブスクリプションの利用。

setup-tokenの取得方法

setup-tokenはAnthropic Consoleではなく、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を使用してください。

No API key found for provider “anthropic”

  • 認証はエージェント単位です。新しいエージェントはメインエージェントのキーを引き継ぎません。
  • そのエージェントに対してオンボーディングを再実行するか、ゲートウェイホスト上で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

arrow_back
前へ
Model Failover
次へ
Bedrock
arrow_forward