OpenClaw网关首次配置有四种方法：一、交互式向导（推荐新手）；二、命令行直接配置（适合脚本化部署）；三、控制UI可视化配置（适合调试）；四、直接编辑配置文件（适合高级用户）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已完成 OpenClaw 的安装，但尚未完成初始配置，则网关将处于未就绪状态，无法启动或响应任何指令。以下是多种可行的首次配置方法：
一、交互式向导配置（推荐新手）
该方式通过问答形式引导用户逐步填写关键配置项，自动校验输入合法性，避免手动编辑错误导致启动失败。
1、在终端中执行 openclaw onboard 命令启动向导。
2、根据提示依次输入工作区路径（默认为 ~/openclaw-workspace）、默认代理名称、心跳周期等参数。
3、向导结束时将自动生成 ~/.openclaw/openclaw.json 并验证格式有效性。
4、执行 openclaw gateway start 启动服务并确认状态为 running。
二、命令行直接配置（适合脚本化部署）
通过 CLI 工具逐项设置核心配置，适用于 DevOps 流水线或批量初始化场景，所有变更即时生效且可重复执行。
1、设置默认工作区路径：openclaw config set agents.defaults.workspace "~/my-claw"。
2、启用心跳机制：openclaw config set agents.defaults.heartbeat.every "1h"。
3、禁用桌面模式以适配无 GUI 环境：openclaw config set browser.headless true。
4、强制启用 NoSandbox 模式（若以 root 运行）：openclaw config set browser.noSandbox true。
5、验证全部已设项：openclaw config list。
三、控制 UI 可视化配置（适合调试与快速调整）
通过本地 Web 界面操作配置，支持表单校验与 JSON 原始编辑双模式，便于非技术用户理解结构与约束。
1、确保网关进程已运行（即使未完成配置，openclaw gateway start 仍可启动基础服务）。
2、在浏览器中访问 http://127.0.0.1:18789。
3、点击顶部导航栏的 Config 标签页。
4、选择 表单模式，修改 workspace、heartbeat、browser.headless 等字段后点击保存。
5、如需高级调整，切换至 RawJSON 模式，手动编辑并提交 JSON 内容。
四、直接编辑配置文件（适合高级用户与离线环境）
绕过所有中间层，直接操作底层 JSON 文件，配合支持 JSON5 的编辑器（如 VS Code + JSON5 插件）可获得语法高亮与智能补全。
1、打开文件：~/.openclaw/openclaw.json。
2、确保根对象包含 $schema 字段（仅用于编辑器提示，不参与验证）。
3、在 agents.defaults 下添加 workspace 和 heartbeat 配置项。
4、在 browser 节点下设置 headless: true 与 noSandbox: true。
5、保存后等待热重载生效，或手动执行 openclaw gateway restart。
