​

Anthropic (Claude)

​

Option A: Anthropic API key

​

CLIセットアップ

openclaw onboard
# choose: Anthropic API key

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

​

Claude CLI configスニペット

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

​

Thinkingのデフォルト（Claude 4.6）

• Anthropic Claude 4.6 modelは、明示的なthinking levelが設定されていない場合、OpenClawでデフォルトで adaptive thinkingを使用します。
• メッセージごと（/think:<level>）またはmodel paramsで上書きできます: agents.defaults.models["anthropic/<model>"].params.thinking。
• 関連するAnthropicドキュメント:
  • Adaptive thinking
  • Extended thinking

​

Fast mode（Anthropic API）

• /fast on は service_tier: "auto" にマップされます
• /fast off は service_tier: "standard_only" にマップされます
• Configデフォルト:

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

• OpenClawは、Anthropic service tierを直接の api.anthropic.com リクエストに対してのみ注入します。anthropic/* をproxyまたはGateway経由でルーティングしている場合、/fast は service_tier に触れません。
• 明示的なAnthropic serviceTier または service_tier model paramsが設定されている場合、両方が存在するときは /fast のデフォルトよりそちらが優先されます。
• Anthropicは実効tierをresponseの usage.service_tier で返します。Priority Tier capacityがないaccountでは、service_tier: "auto" でも standard に解決されることがあります。

​

Prompt caching（Anthropic API）

​

設定

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

​

デフォルト

​

AgentごとのcacheRetention override

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // 多くのagent向けベースライン
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // このagentだけ上書き
    ],
  },
}

1. agents.defaults.models["provider/model"].params
2. agents.list[].params（一致する id、キー単位で上書き）

​

Bedrock Claudeに関する注意

• Bedrock上のAnthropic Claude model（amazon-bedrock/*anthropic.claude*）は、設定されていれば cacheRetention のパススルーを受け付けます。
• Anthropic以外のBedrock modelは、実行時に cacheRetention: "none" へ強制されます。
• Anthropic API-keyのsmart defaultは、明示値がない場合、Claude-on-Bedrock model refにも cacheRetention: "short" を設定します。

​

1M context window（Anthropic beta）

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

​

Option B: メッセージproviderとしてClaude CLIを使う

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

1. OpenClawはGateway host上で claude -p --output-format stream-json --include-partial-messages ... を起動し、stdin経由でpromptを送ります。
2. 最初のturnでは --session-id <uuid> を送ります。
3. 後続turnでは、保存されたClaude sessionを --resume <sessionId> で再利用します。
4. chatメッセージ自体は通常のOpenClaw message pipelineを通りますが、 実際のmodel replyはClaude CLIによって生成されます。

​

要件

• Gateway hostにClaude CLIがインストールされていてPATH上にあること、または absolute command pathで設定されていること。
• 同じhost上でClaude CLIがすでに認証済みであること:

claude auth status

• OpenClawは、configで claude-cli/... または claude-cli backend configが明示的に参照されている場合、 Gateway起動時にbundled Anthropic pluginを自動読み込みします。

​

Configスニペット

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

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

​

得られるもの

• ローカルCLIから再利用されるClaude subscription認証（実行時に読み取られ、永続化されない）
• 通常のOpenClaw message/session routing
• turnをまたいだClaude CLI session継続性（auth変更時に無効化）
• loopback MCP bridge経由でClaude CLIへ公開されるGateway tools
• live partial-message progressを伴うJSONL streaming

​

Anthropic authからClaude CLIへ移行する

• OpenClawを実行している同じGateway host にClaude CLIがインストールされていること
• そのhost上でClaude CLIがすでにサインイン済みであること: claude auth login

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

openclaw onboard --auth-choice anthropic-cli

• Claude CLIがGateway host上ですでにサインイン済みか検証する
• デフォルトmodelを claude-cli/... へ切り替える
• anthropic/claude-opus-4-6 のようなAnthropic default-model fallbackを claude-cli/claude-opus-4-6 に書き換える
• agents.defaults.models に対応する claude-cli/... エントリーを追加する

openclaw models status

• 既存のAnthropic auth profileを削除すること
• メインのdefault model/allowlist経路以外にある古い anthropic/... config参照をすべて削除すること

​

重要な制限

• これはAnthropic API providerではありません。ローカルCLI runtimeです。
• OpenClawはtool callを直接注入しません。Claude CLIはGateway toolsをloopback MCP bridge経由で受け取ります（bundleMcp: true、デフォルト）。
• Claude CLIはJSONL（stream-json と --include-partial-messages）でreplyをstreamします。promptはargvではなくstdin経由で送られます。
• Authは、実行時に有効なClaude CLI資格情報から読み取られ、OpenClaw profileへは永続化されません。非対話コンテキストではkeychain promptは抑制されます。
• Session再利用は cliSessionBinding metadataで追跡されます。Claude CLI login状態が変わると（再ログイン、token rotation）、保存済みsessionは 無効化され、新しいsessionが開始されます。
• 共有されたmulti-user課金構成ではなく、個人用Gateway hostに最適です。

​

注意

• Anthropicの公開Claude Code docsには、引き続き claude -p のような直接CLI利用が記載されています。ローカルで ユーザー管理されるfallbackはおそらく許可されていると私たちは考えていますが、 AnthropicがOpenClawユーザーへ出した別通知では、OpenClaw Claude-login経路はサードパーティharness利用であり、Extra Usage が必要だとされています（subscriptionとは別請求の従量課金）。本番用途では、 代わりにAnthropic API keyを推奨します。
• Anthropic setup-tokenは、legacy/manual経路としてOpenClawで再び利用可能です。AnthropicのOpenClaw固有課金通知は引き続き適用されるため、この経路ではAnthropicがExtra Usage を要求する前提で使ってください。
• Auth詳細と再利用ルールは /concepts/oauth にあります。

​

トラブルシューティング

• Legacy Anthropic token authは期限切れになったり、取り消されたりすることがあります。
• 新しいセットアップでは、Anthropic API keyまたはGateway host上のローカルClaude CLI経路へ移行してください。

• Authはagentごとです。新しいagentはメインagentのkeyを継承しません。
• そのagent向けにonboardingを再実行するか、Gateway host上でAPI keyを設定し、その後 openclaw models status で確認してください。

• どのauth profileがアクティブか確認するには openclaw models status を実行してください。
• onboardingを再実行するか、そのprofile経路向けにAPI keyまたはClaude CLIを設定してください。

• auth.unusableProfiles を確認するには openclaw models status --json を使ってください。
• Anthropicのrate-limit cooldownはmodelスコープであることがあるため、現在のものがcooldown中でも、別のAnthropic modelは使える場合があります。
• 別のAnthropic profileを追加するか、cooldownが明けるまで待ってください。