OpenClaw配置指南

2026-03-31 109

对于正在使用本地AI、折腾OpenClaw的用户而言,掌握核心配置命令是高效使用OpenClaw的基础。无论是刚完成安装、环境崩溃需要重置,还是配置模型、工作空间等核心功能,都离不开基础配置操作。本节将带大家快速配置OpenClaw,适配本地AI各类使用场景。

一、初始化OpenClaw

该命令主要用于两种场景:一是刚刚安装完OpenClaw,需要完成初始配置;二是软件环境出现故障、无法恢复时,用于重置OpenClaw至初始状态。

openclaw onboard

二、配置OpenClaw

该命令是核心配置入口,可配置工作空间、模型厂商、web工具、网关、通道、技能、健康检查等所有核心功能,大部分手动配置操作在此处进行效率更高。

openclaw config

OpenClaw配置指南

1、Workspace-工作空间配置

选择Workspace选项,可修改OpenClaw的工作空间路径。默认情况下,OpenClaw会安装在Windows系统C盘的用户目录下(路径:.openclaw/wordspace),不更改也可正常使用。但如果长期使用、技能和数据较多,工作空间会逐渐变大,建议修改路径至文档目录,方便后续数据迁移和管理。

OpenClaw配置指南

2、Model-配置模型

OpenClaw配置指南

配置大模型的操作非常简单,只需前往对应大模型厂商购买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”,这是正常的脱敏保护,仅用于前端界面隐藏,不影响实际调用。

OpenClaw配置指南

温馨提示:对于新手小白而言,配置大模型可能存在一定难度,不同厂商的配置Url和复杂程度有所差异。如果无法完成大模型配置,可私信咨询,协助完成配置。

注意:OpenClaw使用过程中会消耗大量Token,若按Token计费,短短几轮对话就可能产生较高成本,建议优先选择包月套餐,且优先选择按次对话计费的套餐,性价比更高。

3、网页搜索-Brave Search配置

网页搜索是很多用户使用OpenClaw的核心需求之一,实现该功能的前提是拥有Brave Search API。配置Brave Search API key后,可轻松实现OpenClaw网页搜索功能;若没有API key,也可通过浏览器插件完成网页搜索。

OpenClaw配置指南

注意:若在国内使用Brave Search,配置API key后必须开启代理,否则无法正常访问Brave Search服务。

OpenClaw配置指南

4、Gateway-网关配置

若没有特殊需求,不建议随意修改网关配置。网关主要用于配置访问端口、是否支持IP访问、映射到公网等高级功能,属于进阶操作,本章暂不详细概述。

5、Daemon-服务管理

主要用于对网关服务进行管理,包括重启、安装、跳过等基础操作,操作简单,无需额外复杂配置。

6、Channel-配置通道

主流APP链接OpenClaw的教程篇幅较长,将在后续篇章单独讲解,本章暂不概述。

OpenClaw配置指南

7、Skills-技能安装

参考:《OpenClaw常用Skill分享及安装教程

三、修复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命令大全

  • 广告合作

  • QQ群号:4114653

温馨提示:
1、本网站发布的内容(图片、视频和文字)以原创、转载和分享网络内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。邮箱:2942802716#qq.com(#改为@)。 2、本站原创内容未经允许不得转裁,转载请注明出处“站长百科”和原文地址。
OpenClaw
上一篇: OpenClaw添加模型
OpenClaw
下一篇: OpenClaw常见问题