メインコンテンツへスキップ

​
Anthropic（Claude）

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

​
オプション A: Anthropic API キー

最適な用途: 標準的な API アクセスおよび使用量ベースの課金。 Anthropic Console で API キーを作成してください。 最適な用途: 標準的な API アクセスおよび使用量ベースの課金。 Anthropic Console で API キーを作成してください。 Anthropic ConsoleでAPIキーを作成します。

​
CLI セットアップ

openclaw onboard
# choose: Anthropic API key

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

​
設定スニペット

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

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

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

​
設定

モデル設定で cacheRetention パラメーターを使用してください。
値キャッシュ期間説明
noneキャッシュなしプロンプトキャッシュを無効化
short5 分API キー認証のデフォルト
long1 時間拡張キャッシュ（ベータフラグが必要）
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

​
デフォルト

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

​
レガシーパラメーター

古い cacheControlTtl パラメーターは、後方互換性のために引き続きサポートされています。
  • "5m" は short にマップされます
  • "1h" は long にマップされます
新しい cacheRetention パラメーターへの移行を推奨します。 OpenClaw には Anthropic API リクエスト用の extended-cache-ttl-2025-04-11 ベータフラグが含まれています。プロバイダーヘッダーを上書きする場合は、これを保持してください（/gateway/configuration を参照）。

​
オプション B: Claude setup-token

最適な用途: Claude サブスクリプションを使用する場合。

​
setup-token の取得方法

setup-token は Anthropic Console ではなく、Claude Code CLI によって作成されます。任意のマシン で実行できます。 どのマシンでも実行できます： どのマシンでも実行できます： 
claude setup-token
トークンを OpenClaw に貼り付ける（ウィザード: Anthropic token（setup-token を貼り付け））か、ゲートウェイ ホストで実行してください。 
openclaw models auth setup-token --provider anthropic
別のマシンでトークンを生成した場合は、貼り付けてください。 
openclaw models auth paste-token --provider anthropic

​
CLI セットアップ（setup-token）

# Paste a setup-token during onboarding
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 を実行してください。
    1. Claude のサブスクリプションで「OAuth token refresh failed …」と表示された場合は、setup-token で再認証してください。 Claude のサブスクリプションで「OAuth token refresh failed …」と表示された場合は、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。