OpenClaw网关首次配置有四种方法：一、交互式向导（推荐新手）；二、命令行直接配置（适合脚本化部署）；三、控制UI可视化配置（适合调试）；四、直接编辑配置文件（适合高级用户）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成 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。
从 agency-agents-zh 仓库管理和激活 AI 智能体人格。支持 176 个专业智能体，涵盖工程、设计、营销、销售、产品等领域。安装后首次使用时会自动克隆仓库。当用户要求激活特定智能体（如"激活小红书运营"、"激活前端开发者"）、列出可用智能体、或搜索智能体时使用此技能。
三、控制 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。
