配置详解
OpenClaw Gateway 的所有行为都通过 ~/.openclaw/workspace 配置文件控制。本页涵盖认证设置、模型配置、版本更新和诊断检查。
Gateway 认证设置
Breaking Change — v2026.3.7
从 v2026.3.7 起，Gateway 认证要求显式设置 gateway.auth.mode。如果不设置，Gateway 将无法启动。
在 ~/.openclaw/workspace 中添加认证配置：
yaml
gateway:
auth:
mode: token # Token 认证（推荐用于 API 集成）
# 或
mode: password # 密码认证（推荐用于 Web UI 访问）两种模式的适用场景：
| 认证模式 | 适用场景 | 说明 |
|---|---|---|
token | API 集成、自动化脚本、CI/CD | 使用 Bearer Token，适合程序化调用 |
password | Dashboard Web UI、人工交互 | 用户名 + 密码，适合浏览器访问 |
TIP
如果你同时需要 API 调用和 Web UI 访问，建议选择 token 模式 —— Dashboard 也支持 Token 登录。
模型选择与 API Key 配置
OpenClaw 支持多家模型供应商。根据你的使用场景选择合适的模型来源：
| 模型来源 | 获取方式 | 说明 |
|---|---|---|
| 阿里云百炼 | 百炼平台申请 | 国内首选，qwen3.5-plus 等模型 |
| 腾讯云 Coding Plan | 腾讯云购买 | 多模型套餐，首月 7.9 元 |
| 火山方舟 | 方舟平台申请 | 豆包系列模型 |
| Anthropic API | console.anthropic.com | Claude 系列，按量付费 |
| OpenAI API | platform.openai.com | GPT 系列，按量付费 |
| Ollama（本地） | 本地安装 | 免费，需本地算力 |
云厂商一键部署用户
如果你使用国内云厂商的一键部署方案，模型和 API Key 通常在购买时已自动配好，无需手动配置。只有本地安装和 Docker 部署才需要手动设置。
配置示例（以阿里云百炼为例）：
yaml
gateway:
auth:
mode: token
provider: dashscope
dashscope:
apiKey: sk-xxxxx
model: qwen3.5-plus配置示例（以 Ollama 本地模型为例）：
yaml
gateway:
auth:
mode: password
provider: ollama
ollama:
host: http://127.0.0.1:11434
model: llama3版本更新
OpenClaw 提供三个更新渠道，通过 openclaw update 命令切换：
bash
# 更新到最新稳定版
openclaw update --channel stable
# 更新到 Beta 版
openclaw update --channel beta
# 更新到开发版
openclaw update --channel dev三个渠道的区别：
| 渠道 | 更新频率 | 稳定性 | 适合人群 |
|---|---|---|---|
stable | 每周发布 | 最高，经过充分测试 | 生产环境、大多数用户 |
beta | 每天发布 | 中等，功能基本稳定 | 想提前体验新功能的用户 |
dev | 持续发布 | 最低，可能存在问题 | 开发者、贡献者 |
WARNING
生产环境建议使用 stable 渠道。beta 和 dev 渠道可能包含未完成的功能或已知问题。
诊断检查
遇到问题时，使用 openclaw doctor 进行全面诊断：
bash
openclaw doctor该命令会依次检查以下项目：
| 检查项 | 说明 |
|---|---|
| Node.js 版本 | 确认 Node.js 版本满足最低要求 |
| 系统依赖 | 检查操作系统级别的依赖库 |
| Gateway 连接 | 测试 Gateway 是否正常启动和响应 |
| API Key 有效性 | 验证已配置的 API Key 是否可用 |
| 守护进程状态 | 检查后台守护进程是否正常运行 |
| 网络连通性 | 测试到模型供应商 API 的网络连接 |
TIP
在社区提问或提交 Issue 时，附上 openclaw doctor 的输出可以帮助他人更快定位问题。
配置要点速查表
| 操作 | 命令 / 配置 |
|---|---|
| 查看当前配置 | openclaw config list |
| 设置认证模式 | gateway.auth.mode: token | password |
| 切换模型供应商 | 修改 provider 字段 |
| 更新到稳定版 | openclaw update --channel stable |
| 全面诊断 | openclaw doctor |
| 交互式配置 | openclaw configure |
| 配置文件位置 | ~/.openclaw/workspace |