对于正在使用本地AI、折腾OpenClaw的用户而言,掌握核心配置命令是高效使用OpenClaw的基础。无论是刚完成安装、环境崩溃需要重置,还是配置模型、工作空间等核心功能,都离不开基础配置操作。本节将带大家快速配置OpenClaw,适配本地AI各类使用场景。
一、初始化OpenClaw
该命令主要用于两种场景:一是刚刚安装完OpenClaw,需要完成初始配置;二是软件环境出现故障、无法恢复时,用于重置OpenClaw至初始状态。
openclaw onboard
二、配置OpenClaw
该命令是核心配置入口,可配置工作空间、模型厂商、web工具、网关、通道、技能、健康检查等所有核心功能,大部分手动配置操作在此处进行效率更高。
openclaw config
1、Workspace-工作空间配置
选择Workspace选项,可修改OpenClaw的工作空间路径。默认情况下,OpenClaw会安装在Windows系统C盘的用户目录下(路径:.openclaw/wordspace),不更改也可正常使用。但如果长期使用、技能和数据较多,工作空间会逐渐变大,建议修改路径至文档目录,方便后续数据迁移和管理。
2、Model-配置模型
配置大模型的操作非常简单,只需前往对应大模型厂商购买Token,将Token填入对应配置项即可。
Coding Plan汇总看这篇:《Agent开发者省钱指南:国内AI Coding Plan对比》
核心配置步骤(重点)
在终端执行以下命令,打开Web UI:
openclaw dashboard
- 在Web UI左侧菜单栏中,依次选择「配置」>「All Settings」>「RAW」。
将以下JSON内容复制到「Raw JSONS」输入框,替换原有内容;
- 若需保留已有配置,请勿直接全量替换,需在原有配置文件中找到models、agents和gateway字段,将Coding Plan的配置信息粘贴到对应字段下;
- 将JSON中的「YOUR_API_KEY」替换为你购买的阿里云百炼Coding Plan专属API Key。
{
“meta”: {
“lastTouchedVersion”: “2026.3.2”,
“lastTouchedAt”: “2026-03-03T07:28:22.400Z”
},
“models”: {
“mode”: “merge”,
“providers”: {
“bailian”: {
“baseUrl”: “https://coding.dashscope.aliyuncs.com/v1”,
“apiKey”: “YOUR_API_KEY”,
“api”: “openai-completions”,
“models”: [
{
“id”: “qwen3.5-plus”,
“name”: “qwen3.5-plus”,
“api”: “openai-completions”,
“reasoning”: false,
“input”: [
“text”,
“image”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: 1000000,
“maxTokens”: 65536
},
{
“id”: “qwen3-max-2026-01-23”,
“name”: “qwen3-max-2026-01-23”,
“api”: “openai-completions”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: 262144,
“maxTokens”: 65536
},
{
“id”: “qwen3-coder-next”,
“name”: “qwen3-coder-next”,
“api”: “openai-completions”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: 262144,
“maxTokens”: 65536
},
{
“id”: “qwen3-coder-plus”,
“name”: “qwen3-coder-plus”,
“api”: “openai-completions”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: 1000000,
“maxTokens”: 65536
},
{
“id”: “MiniMax-M2.5”,
“name”: “MiniMax-M2.5”,
“api”: “openai-completions”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: 204800,
“maxTokens”: 131072
},
{
“id”: “glm-5”,
“name”: “glm-5”,
“api”: “openai-completions”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: 202752,
“maxTokens”: 16384
},
{
“id”: “glm-4.7”,
“name”: “glm-4.7”,
“api”: “openai-completions”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: 202752,
“maxTokens”: 16384
},
{
“id”: “kimi-k2.5”,
“name”: “kimi-k2.5”,
“api”: “openai-completions”,
“reasoning”: false,
“input”: [
“text”,
“image”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: 262144,
“maxTokens”: 32768
}
]
}
}
},
“agents”: {
“defaults”: {
“model”: {
“primary”: “bailian/qwen3.5-plus”
},
“models”: {
“bailian/qwen3.5-plus”: {},
“bailian/qwen3-max-2026-01-23”: {},
“bailian/qwen3-coder-next”: {},
“bailian/qwen3-coder-plus”: {},
“bailian/MiniMax-M2.5”: {},
“bailian/glm-5”: {},
“bailian/glm-4.7”: {},
“bailian/kimi-k2.5”: {}
},
“compaction”: {
“mode”: “safeguard”
}
}
},
“commands”: {
“native”: “auto”,
“nativeSkills”: “auto”,
“restart”: true,
“ownerDisplay”: “raw”
},
“gateway”: {
“mode”: “local”,
“auth”: {
“mode”: “token”,
“token”: “__OPENCLAW_REDACTED__”
}
}
}
单击右上角「Save」保存配置,然后单击「Update」使配置生效。
保存成功后,apiKey将显示为“OPENCLAW_REDACTED”,这是正常的脱敏保护,仅用于前端界面隐藏,不影响实际调用。
温馨提示:对于新手小白而言,配置大模型可能存在一定难度,不同厂商的配置Url和复杂程度有所差异。如果无法完成大模型配置,可私信咨询,协助完成配置。
注意:OpenClaw使用过程中会消耗大量Token,若按Token计费,短短几轮对话就可能产生较高成本,建议优先选择包月套餐,且优先选择按次对话计费的套餐,性价比更高。
3、网页搜索-Brave Search配置
网页搜索是很多用户使用OpenClaw的核心需求之一,实现该功能的前提是拥有Brave Search API。配置Brave Search API key后,可轻松实现OpenClaw网页搜索功能;若没有API key,也可通过浏览器插件完成网页搜索。
注意:若在国内使用Brave Search,配置API key后必须开启代理,否则无法正常访问Brave Search服务。
4、Gateway-网关配置
若没有特殊需求,不建议随意修改网关配置。网关主要用于配置访问端口、是否支持IP访问、映射到公网等高级功能,属于进阶操作,本章暂不详细概述。
5、Daemon-服务管理
主要用于对网关服务进行管理,包括重启、安装、跳过等基础操作,操作简单,无需额外复杂配置。
6、Channel-配置通道
主流APP链接OpenClaw的教程篇幅较长,将在后续篇章单独讲解,本章暂不概述。
7、Skills-技能安装
三、修复OpenClaw
当修改配置错误导致网关无法启动时,可使用以下命令尝试自我修复,或查看具体报错信息,便于排查问题。
openclaw doctor –fix
四、卸载OpenClaw
若本地环境混乱,需要彻底卸载OpenClaw,可使用以下命令完成卸载。
openclaw uninstall
五、OpenClaw常用指令汇总
1、网关管理
openclaw gateway status # 查看网关状态
openclaw gateway start # 启动网关
openclaw gateway stop # 停止网关
openclaw gateway restart # 重启网关
2、帮助与信息
openclaw help # 查看所有命令
openclaw gateway –help # 网关命令帮助
openclaw status # 查看系统状态
3、模型管理(会话窗口)
/model <provider/model> # 切换模型
/models # 浏览所有提供商
/models <provider> # 查看某提供商的模型
/model status # 查看当前模型状态
4、会话管理(会话窗口)
/reasoning # 切换推理模式
/status # 查看会话状态(用量/时间/成本)
5、其他实用命令
openclaw version # 查看版本
更多命令:《OpenClaw命令大全》








