Providers
Anthropic
Anthropic 建構 Claude 模型家族。OpenClaw 支援兩種驗證路徑：
- API 金鑰 — 直接存取 Anthropic API，並依用量計費（
anthropic/*模型） - Claude CLI — 在同一台主機上重用既有的 Claude CLI 登入
開始使用
API 金鑰
最適合： 標準 API 存取與依用量計費。
取得你的 API 金鑰
在 Anthropic Console 中建立 API 金鑰。
執行導覽設定
openclaw onboard
# choose: Anthropic API key
或直接傳入金鑰：
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
確認模型可用
openclaw models list --provider anthropic
設定範例
{
env: { ANTHROPIC_API_KEY: "sk-ant-..." },
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
Claude CLI
最適合： 不使用獨立 API 金鑰，重用既有的 Claude CLI 登入。
確認已安裝 Claude CLI 並已登入
使用以下指令確認：
claude --version
執行導覽設定
openclaw onboard
# choose: Claude CLI
OpenClaw 會偵測並重用既有的 Claude CLI 認證。
確認模型可用
openclaw models list --provider anthropic
設定範例
建議使用正式的 Anthropic 模型參照，再加上 CLI 執行階段覆寫：
{
agents: {
defaults: {
model: { primary: "anthropic/claude-opus-4-7" },
agentRuntime: { id: "claude-cli" },
},
},
}
舊版 claude-cli/claude-opus-4-7 模型參照仍可為了
相容性而運作，但新的設定應將供應商/模型選擇維持為
anthropic/*，並將執行後端放在 agentRuntime.id。
思考預設值（Claude 4.6）
當未設定明確的思考層級時，Claude 4.6 模型在 OpenClaw 中預設使用 adaptive 思考。
可透過每則訊息的 /think:<level> 或在模型參數中覆寫：
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { thinking: "adaptive" },
},
},
},
},
}
提示快取
OpenClaw 支援 Anthropic 的提示快取功能，用於 API 金鑰驗證。
| 值 | 快取期間 | 說明 |
|---|---|---|
"short"（預設） |
5 分鐘 | 針對 API 金鑰驗證自動套用 |
"long" |
1 小時 | 延長快取 |
"none" |
不快取 | 停用提示快取 |
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { cacheRetention: "long" },
},
},
},
},
}
每個代理的快取覆寫
使用模型層級參數作為基準，然後透過 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"].paramsagents.list[].params（符合id，依金鑰覆寫）
這可讓同一模型上的某個代理保留長效快取，同時讓另一個代理針對突發性/低重用流量停用快取。
Bedrock Claude 注意事項
- Bedrock 上的 Anthropic Claude 模型（
amazon-bedrock/*anthropic.claude*）在已設定時接受cacheRetention透傳。 - 非 Anthropic 的 Bedrock 模型會在執行階段被強制設為
cacheRetention: "none"。 - 當未設定明確值時，API 金鑰智慧預設值也會為 Bedrock 上的 Claude 參照填入
cacheRetention: "short"。
進階設定
快速模式
OpenClaw 的共用 /fast 切換支援直接 Anthropic 流量（API 金鑰與連到 api.anthropic.com 的 OAuth）。
| 指令 | 對應至 |
|---|---|
/fast on |
service_tier: "auto" |
/fast off |
service_tier: "standard_only" |
{
agents: {
defaults: {
models: {
"anthropic/claude-sonnet-4-6": {
params: { fastMode: true },
},
},
},
},
}
媒體理解（圖片與 PDF）
內建的 Anthropic Plugin 會註冊圖片與 PDF 理解。OpenClaw 會從已設定的 Anthropic 驗證自動解析媒體能力，不需要 額外設定。
| 屬性 | 值 |
|---|---|
| 預設模型 | claude-opus-4-7 |
| 支援的輸入 | 圖片、PDF 文件 |
當圖片或 PDF 附加到對話時，OpenClaw 會自動 透過 Anthropic 媒體理解供應商路由它。
1M 脈絡視窗（beta）
Anthropic 的 1M 脈絡視窗受到 beta 門檻控管。請針對每個模型啟用：
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { context1m: true },
},
},
},
},
}
OpenClaw 會在請求上將此對應為 anthropic-beta: context-1m-2025-08-07。
params.context1m: true 也會套用到 Claude CLI 後端
（claude-cli/*）中符合資格的 Opus 與 Sonnet 模型，將那些 CLI 工作階段的執行階段
脈絡視窗擴展到與直接 API 行為相符。
Claude Opus 4.7 1M 脈絡
anthropic/claude-opus-4.7 與其 claude-cli 變體預設具有 1M 脈絡
視窗，不需要 params.context1m: true。
疑難排解
401 錯誤 / 權杖突然無效
Anthropic 權杖驗證會過期，也可能遭撤銷。對於新的設定，請改用 Anthropic API 金鑰。
找不到供應商 "anthropic" 的 API 金鑰
Anthropic 驗證是每個代理各自設定，新的代理不會繼承主要代理的金鑰。請為該代理重新執行導覽設定（或在 Gateway 主機上設定 API 金鑰），然後使用 openclaw models status 確認。
找不到設定檔 "anthropic:default" 的認證
執行 openclaw models status 以查看目前使用中的驗證設定檔。重新執行導覽設定，或為該設定檔路徑設定 API 金鑰。
沒有可用的驗證設定檔（全部都在冷卻中）
查看 openclaw models status --json 中的 auth.unusableProfiles。Anthropic 速率限制冷卻可能是以模型為範圍，因此同層的 Anthropic 模型可能仍可使用。新增另一個 Anthropic 設定檔，或等待冷卻結束。