OpenClaw 这款工具最令人省心的设计,就是全面支持热更新机制——运行时即可动态调整配置,完全无需重启服务。换言之,你无需手动修改配置文件、不必重启容器,也无需执行任何命令行指令,只需打开网页控制台轻松点击几下,2秒内即可完成所有设置。

具体操作路径也十分直观:通过 Web 控制台依次进入 Settings → AI Providers,编辑 API Key、Model Name 甚至 Base URL,点击 Sa ve & Reload Adapter 之后,所有修改即刻生效。如果同时配置了多个模型,在聊天界面的 agent 菜单中就能直接切换当前使用的模型,操作极为便捷。
通过Web控制台在线更换API Key
操作流程其实相当清晰,下面我们逐步展开:
第一步:在浏览器中打开 OpenClaw 控制台,地址为 http://127.0.0.1:18789(请确保服务已正常启动)。
第二步:点击左侧菜单栏 → Settings → AI Providers,进入模型提供商管理页面。
第三步:找到需要修改的模型条目(例如 OpenAI、DeepSeek、千帆等),点击右侧的 Edit 按钮。
第四步:在弹出的表单中,直接覆盖填写新的 API Key(支持 Base64 加密存储,前端自动掩码显示);同时可同步切换 Model Name(例如从 gpt-4o 改为 gpt-4-turbo);如果使用的是私有部署模型,还可以修改 Base URL(比如填入 https://your-llm-api.com/v1)。
第五步:点击 Sa ve & Reload Adapter,系统会立即重载对应的适配器,日志会输出 [INFO] Adapter 'openai' reloaded successfully. New model: gpt-4-turbo。⚠️注意:此操作即时生效,完全无需执行 openclaw restart 或 systemctl daemon-reload。
多模型共存时快速切换当前使用的模型
前提是你已经在 ~/.openclaw/openclaw.json 中正确配置了多个模型,并且 models.mode 设置为 "merge"。
启动 OpenClaw 后,在聊天界面右上角点击 agent 菜单 → 进入 main 子项,所有已配置的模型名称会以列表形式完整展开。
直接点击任意模型名称,当前会话会立刻切换到该模型,后续所有请求都将走新模型通道,旧会话的上下文内容会保持不变。
这一步操作非常简单,只需点选即可,无需刷新页面或重新登录。
命令行强制重走配置流程(仅当Web控制台不可用时备用)
某些情况下 Web 控制台可能暂时不可用,此时有两个备选方案可供参考:
方法一:保留原有服务进程,仅重新引导配置流程
openclaw onboard --reconfigure
方法二:跳过所有确认提示,直接覆盖写入新配置
openclaw onboard --reconfigure --skip-prompt
该命令会复用当前运行的服务进程,只重新执行「阶段四:初始配置与启动服务」中的模型配置步骤,网关监听端口(18789)和已有会话将全部保留不变。
