OpenClaw 模型与 API Key 常见问题：选型、配置与故障转移
模型是这只龙虾的大脑。官方 FAQ 有专门一册讲模型与验证，本页合并高频问题。
支持哪些提供商
官方目录列了 35 个以上：Anthropic、OpenAI、Google（Gemini）之外，还有 DeepSeek、Qwen、月之暗面、MiniMax、智谱、火山引擎（豆包）、阿里百炼、百度千帆、腾讯云、小米 MiMo 等国内选项，以及 Groq、Mistral、xAI、OpenRouter 等国际选项。接入形态分三类：API Key、OAuth 订阅复用、本地推理端点（Ollama、vLLM、SGLang、llama.cpp、LM Studio 或任何 OpenAI/Anthropic 兼容接口）。
官方推荐选什么
官方文档的原话值得背下来：为获得最佳质量与安全性，请使用最新一代中能力最强的模型。工具型智能体对模型指令跟随与工具调用能力高度敏感——用弱模型省的钱，会在任务失败与反复重试上加倍还回来。
API Key 与订阅复用怎么选
- API Key：按量计费、可控可审计，新手引导的默认路径。
- OAuth 订阅复用：复用部分编码工具订阅的验证（Claude 订阅、OpenAI Codex 等），固定月费；注意提供商的订阅条款与用量上限，且心跳等高频轮次走订阅前先算一笔账。
密钥配置在哪
引导时填的密钥由网关托管进凭据体系；想手工管理则写在配置的模型提供商区块或环境变量里。原则：密钥不进提示词、不进日志、不进工作区文件——技能的环境变量注入只作用于宿主机进程，沙箱内不生效，这是有意设计。
模型突然不回话
- openclaw models status 看验证状态与可用性。
- 提供商额度/账单页确认没欠费没限速。
- 网络出口（国内用户高频问题）：确认网关所在机器能直连提供商 API，必要时配代理。
- 配置故障转移链：主模型失败自动切后备，避免单点（官方概念页叫模型故障转移）。
本地模型能全本地跑吗
可以，Ollama 等方案官方都支持，嵌入检索还有专门的本地模型选项（适合不想把记忆内容发给第三方的用户）。取舍：本地模型的工具调用与长上下文能力通常弱于云端旗舰，复杂任务建议混合配置——日常闲聊走本地，重活走云端。
记忆搜索的嵌入也要钱吗
语义搜索需要嵌入模型，默认用 OpenAI 嵌入（按量计费但单价极低），可换本地 Ollama 嵌入实现零外发。不用语义搜索时关键词检索也能用，只是召回质量打折。