模型快速配置
本指南介绍如何在 OpenClaw 中添加 LLM 提供商、完成身份认证并设置默认模型。
引导式配置（推荐）
首次使用 OpenClaw 时，运行 onboard 命令即可进入交互式引导流程：
bash
openclaw onboard引导流程将自动完成以下步骤：
- 选择模型提供商
- 输入 API Key 或完成 OAuth 认证
- 选择并设置默认模型
手动配置
第一步：添加提供商并认证
bash
# 使用 API Key 认证
openclaw models auth login --provider openai
# 使用 OAuth 认证（部分提供商支持）
openclaw models auth login --provider qwen-portal --set-default第二步：设置默认模型
模型引用格式（Model Reference）为 provider/model，例如：
openai/gpt-4o
anthropic/claude-sonnet-4-20250514
ollama/qwen2.5:14b
deepseek/deepseek-chat
qwen-portal/coder-model设置默认模型：
bash
openclaw models default set openai/gpt-4o第三步：验证配置
bash
# 查看当前默认模型
openclaw models default get
# 列出所有已配置的提供商
openclaw models auth list
# 发送测试消息
openclaw chat "你好，请做个自我介绍"配置文件
模型配置存储在 OpenClaw 配置文件中，你也可以直接编辑：
jsonc
// ~/.openclaw/config.json
{
"models": {
"default": "openai/gpt-4o",
"providers": {
"openai": {
"apiKey": "sk-xxxxxxxxxxxxxxxx"
},
"anthropic": {
"apiKey": "sk-ant-xxxxxxxxxxxxxxxx"
},
"deepseek": {
"apiKey": "sk-xxxxxxxxxxxxxxxx",
"baseUrl": "https://api.deepseek.com"
}
}
}
}使用多个提供商
OpenClaw 支持同时配置多个提供商，并在运行时灵活切换：
bash
# 临时使用指定模型
openclaw chat --model anthropic/claude-sonnet-4-20250514 "请分析这段代码"
# 切换默认模型
openclaw models default set deepseek/deepseek-chat多提供商配置示例
jsonc
{
"models": {
"default": "deepseek/deepseek-chat",
"providers": {
"deepseek": {
"apiKey": "sk-xxxxxxxx",
"baseUrl": "https://api.deepseek.com"
},
"openai": {
"apiKey": "sk-xxxxxxxx"
},
"ollama": {
"baseUrl": "http://localhost:11434"
}
}
}
}环境变量
你也可以通过环境变量设置 API Key，避免将密钥写入配置文件：
bash
export OPENAI_API_KEY="sk-xxxxxxxx"
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"
export DEEPSEEK_API_KEY="sk-xxxxxxxx"模型选择建议
| 场景 | 推荐模型 | 说明 |
|---|---|---|
| 日常编程 | deepseek/deepseek-chat | 性价比极高，中文理解优秀 |
| 复杂推理 | anthropic/claude-sonnet-4-20250514 | 深度思考能力强 |
| 快速响应 | openai/gpt-4o-mini | 速度快、成本低 |
| 离线使用 | ollama/qwen2.5:14b | 完全本地运行，无需网络 |
| 免费体验 | qwen-portal/coder-model | 每日 2000 次免费请求 |
下一步
- 查看 提供商列表 了解所有可用提供商
- 阅读各提供商的详细配置指南
🇨🇳 中国用户须知
- 推荐首选：DeepSeek 或通义千问，无需代理，速度快，价格低
- 环境变量：建议将 API Key 写入
~/.bashrc或~/.zshrc，避免每次手动设置 - 网络问题：如使用国际提供商（OpenAI、Anthropic 等），请确保已配置代理或使用中转服务