openclaw配置文件为openclaw.json,windows路径为c:users.openclawopenclaw.json,macos/linux为~/.openclaw/openclaw.json,docker需挂载至/app/.openclaw/;支持命令行编辑、cli读写、交互向导和web ui四种修改方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用 OpenClaw 时需要调整模型、技能或会话行为等参数,但无法定位配置文件位置或不确定如何安全修改,则很可能是因未掌握其标准化路径与格式规范。以下是针对不同操作系统和部署方式的配置文件定位与修改方法:
一、标准配置文件默认路径
OpenClaw 主配置文件始终命名为 openclaw.json,采用 JSON5 格式(支持注释与尾随逗号),其物理位置依运行环境而定。
1、Windows 系统默认路径为:C:Users\.openclawopenclaw.json
2、macOS 系统默认路径为:~/.openclaw/openclaw.json
3、Linux 系统默认路径为:~/.openclaw/openclaw.json
4、Docker 部署时,该文件需挂载至容器内路径:/app/.openclaw/openclaw.json
二、快速打开配置文件的命令方式
避免手动导航查找,可直接通过终端或命令提示符调用系统默认编辑器打开文件,确保路径解析准确且权限可控。
1、Windows(PowerShell)中执行:notepad "$env:USERPROFILE.openclawopenclaw.json"
2、macOS 中执行:open -e ~/.openclaw/openclaw.json
3、Linux(GNOME 桌面)中执行:gedit ~/.openclaw/openclaw.json
4、跨平台命令行编辑(需安装 nano):nano ~/.openclaw/openclaw.json
三、通过 CLI 工具读写配置项
OpenClaw 提供内置命令行接口,无需直接编辑 JSON 文件即可安全设置、获取或删除特定配置字段,适用于脚本集成与批量操作。
1、查看当前 workspace 路径值:openclaw config get agents.defaults.workspace
监控一个或多个 GitCode 仓库的 PR,通过 OpenClaw Gateway 自动执行 AI 审查,发布 PR 评论,并发送钉钉和企业微信通知。
2、将 heartbeat 发送间隔设为 2 小时:openclaw config set agents.defaults.heartbeat.every "2h"
3、清除 Web 搜索插件的 API Key:openclaw config unset tools.web.search.apiKey
4、重置整个 agents 配置节为默认值:openclaw config reset agents
四、使用交互式向导生成配置
对新手而言,手动编写 JSON 易出错且难以覆盖全部字段逻辑。OpenClaw 内置问答式向导可自动构建合法结构,并规避验证失败导致网关无法启动的问题。
1、运行完整设置流程:openclaw onboard
2、执行快速配置模式(跳过部分高级选项):openclaw configure
3、向导将依次询问模型提供商、API Key、工作空间路径、会话保持策略等关键项,并实时生成校验通过的 openclaw.json 内容。
五、通过本地 Web UI 修改配置
OpenClaw 启动后默认监听 http://127.0.0.1:18789,提供图形化配置界面,适合非技术人员或需频繁调试的用户。
1、访问地址后点击顶部 Config 标签页
2、选择 表单模式:按字段分组呈现,自动处理嵌套结构与类型约束
3、选择 RawJSON 模式:直接编辑原始 JSON5 内容,支持语法高亮与实时校验
4、保存后配置立即热重载,无需重启服务进程









