跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Vercel AI Gateway 提供統一的 API,可透過單一端點 存取數百種模型。
屬性
提供者vercel-ai-gateway
驗證AI_GATEWAY_API_KEY
API與 Anthropic Messages 相容
模型目錄透過 /v1/models 自動探索
OpenClaw 會自動探索 Gateway /v1/models 目錄,因此 /models vercel-ai-gateway 會包含目前的模型參照,例如 vercel-ai-gateway/openai/gpt-5.5vercel-ai-gateway/moonshotai/kimi-k2.6

開始使用

1

設定 API 金鑰

執行 onboarding,並選擇 AI Gateway 驗證選項:
openclaw onboard --auth-choice ai-gateway-api-key
2

設定預設模型

將模型加入你的 OpenClaw 設定:
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}
3

確認模型可用

openclaw models list --provider vercel-ai-gateway

非互動式範例

對於指令碼或 CI 設定,請在命令列傳入所有值:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

模型 ID 簡寫

OpenClaw 接受 Vercel Claude 簡寫模型參照,並會在執行階段將其正規化:
簡寫輸入正規化模型參照
vercel-ai-gateway/claude-opus-4.6vercel-ai-gateway/anthropic/claude-opus-4.6
vercel-ai-gateway/opus-4.6vercel-ai-gateway/anthropic/claude-opus-4-6
你可以在設定中使用簡寫或完整限定的模型參照。OpenClaw 會自動解析為標準形式。

進階設定

如果 OpenClaw Gateway 以 daemon(launchd/systemd)執行,請確保 AI_GATEWAY_API_KEY 可供該程序使用。
只在 ~/.profile 中設定的金鑰不會對 launchd/systemd daemon 可見,除非明確匯入該環境。請在 ~/.openclaw/.env 中設定金鑰,或透過 env.shellEnv 設定,以確保 gateway 程序可以 讀取它。
Vercel AI Gateway 會根據模型參照前綴,將請求路由至上游提供者。例如,vercel-ai-gateway/anthropic/claude-opus-4.6 會透過 Anthropic 路由, 而 vercel-ai-gateway/openai/gpt-5.5 會透過 OpenAI 路由,vercel-ai-gateway/moonshotai/kimi-k2.6 則透過 MoonshotAI 路由。你的單一 AI_GATEWAY_API_KEY 會處理所有 上游提供者的驗證。
當 OpenClaw 知道上游提供者合約時,/think 選項會遵循可信任的上游模型前綴。vercel-ai-gateway/anthropic/... 會使用 Claude 思考設定檔,包括 Claude 4.6 模型的自適應預設值。 vercel-ai-gateway/openai/gpt-5.4gpt-5.5 和 Codex 風格的參照會公開 /think xhigh,就像直接的 OpenAI/OpenAI Codex 提供者一樣。其他 命名空間參照會保留一般 reasoning 等級,除非其目錄 中繼資料宣告更多內容。

相關

模型選擇

選擇提供者、模型參照和容錯移轉行為。

疑難排解

一般疑難排解與常見問題。