OpenClaw接入付费大模型需确保使用OpenAI兼容接口，API Key必须通过环境变量OPENAI_API_KEY、config.toml中llm区块或Web UI的OpenAI Compatible选项正确配置，base_url须为/v1/chat/completions格式的兼容地址。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在 OpenClaw 中接入付费大模型（比如 OpenAI、Anthropic、DeepSeek 商用版等），但填完 API Key 后始终提示“Authentication failed”或模型列表为空——这通常不是密钥本身错了，而是配置路径、环境变量或 TOML 文件结构出了问题。
确认模型服务商与 OpenClaw 兼容性
OpenClaw 当前（2026年7月）仅支持通过 OpenAI 兼容 API 接入的付费模型。这意味着：你不能直接填 Anthropic 的原生 Claude API Key，也不能直接填百度文心一言的 aip.baidubce.com 地址；必须使用已部署的、提供 /v1/chat/completions 接口的代理服务，或厂商明确标注“OpenAI-compatible”的商用 endpoint（如 DeepSeek-R1 在华为 MaaS、阿里云百炼、腾讯混元控制台中开启的 OpenAI 模式）。
不兼容的典型例子：https://api.anthropic.com/v1/messages → 会报错；https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation → 不识别；https://api.deepseek.com/v1/chat/completions → ✅ 可用（DeepSeek 官方已开放 OpenAI 兼容接口）。
配置 API Key 的三种方式
方法一：环境变量（推荐用于 Docker 部署）
在启动容器前，将密钥写入宿主机 shell 环境：
export OPENAI_API_KEY=sk-xxxxxx-your-real-key-here
然后运行 docker run -e OPENAI_API_KEY -p 3000:3000 openclaw/openclaw。
【注意】环境变量名必须是 OPENAI_API_KEY，不能写成 CLAW_API_KEY 或 ANTHROPIC_API_KEY，否则 OpenClaw 启动时读不到。
方法二：修改 config.toml（适用于本地 CLI 或 GUI 直接运行）
找到 OpenClaw 安装目录下的 config.toml（通常在 ~/.openclaw/config.toml 或项目根目录）；
定位到 [llm] 区块；
确保以下三行存在且未被注释：
model = "deepseek-chat"api_key = "sk-xxxxxx-your-real-key-here"base_url = "https://api.deepseek.com/v1"
若使用其他厂商，请替换 base_url 为对应 OpenAI 兼容地址（例如百炼：https://dashscope.aliyuncs.com/compatible-mode/v1）。
方法三：首次启动时 Web UI 弹窗配置（仅限 Local GUI 模式）
启动 openclaw gui 后，浏览器自动打开 http://localhost:3000；
页面首次加载会弹出「LLM Setup」窗口；
选择 Provider → OpenAI Compatible（不是 OpenAI、不是 Anthropic）；
在 Model 字段填具体模型名（如 deepseek-chat、qwen-max、claude-3-5-sonnet-20240620）；
Base URL 填厂商提供的 OpenAI 兼容 endpoint；
【关键】API Key 必须粘贴进「API Key」输入框，而不是「Organization」或「Project」栏——后者留空即可。
验证配置是否生效
第一步：重启 OpenClaw 进程（如果是 Docker，先 docker stop 再 docker run；如果是本地 CLI，Ctrl+C 后重新执行 openclaw gui）；
第二步：打开 http://localhost:3000，点击右上角齿轮图标 → 「LLM Settings」→ 查看「Status」栏是否显示绿色「Connected」；
第三步：在聊天框输入「请输出 JSON 格式：{"status": "ok", "model": "deepseek-chat"}」，观察是否返回合法 JSON 且无认证错误；
第四步：若返回 {"error": {"message": "Invalid API key", ...}}，说明密钥格式错误或已被平台禁用；若返回 {"error": {"message": "Missing authorization header"}}，说明 base_url 未生效或请求头未携带 key。
