| --- |
| summary: "CLI reference for `openclaw config` (get/set/unset config values)" |
| read_when: |
| - You want to read or edit config non-interactively |
| --- |
| |
| # `openclaw config` |
|
|
| Config helpers: get/set/unset values by path. Run without a subcommand to open |
| the configure wizard (same as `openclaw configure`). |
|
|
| ## Examples |
|
|
| ```bash |
| openclaw config get browser.executablePath |
| openclaw config set browser.executablePath "/usr/bin/google-chrome" |
| openclaw config set agents.defaults.heartbeat.every "2h" |
| openclaw config set agents.list[0].tools.exec.node "node-id-or-name" |
| openclaw config unset tools.web.search.apiKey |
| ``` |
|
|
| ## Paths |
|
|
| Paths use dot or bracket notation: |
|
|
| ```bash |
| openclaw config get agents.defaults.workspace |
| openclaw config get agents.list[0].id |
| ``` |
|
|
| Use the agent list index to target a specific agent: |
|
|
| ```bash |
| openclaw config get agents.list |
| openclaw config set agents.list[1].tools.exec.node "node-id-or-name" |
| ``` |
|
|
| ## Values |
|
|
| Values are parsed as JSON5 when possible; otherwise they are treated as strings. |
| Use `--json` to require JSON5 parsing. |
|
|
| ```bash |
| openclaw config set agents.defaults.heartbeat.every "0m" |
| openclaw config set gateway.port 19001 --json |
| openclaw config set channels.whatsapp.groups '["*"]' --json |
| ``` |
|
|
| Restart the gateway after edits. |
|
|
