메인 콘텐츠로 건너뛰기

​
openclaw config

config helper입니다. path 기준으로 get/set/unset/validate를 수행하고, 현재 active config file도 출력할 수 있습니다. subcommand 없이 실행하면 configure wizard를 엽니다. (openclaw configure와 동일)

​
Examples

openclaw config file
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
openclaw config validate
openclaw config validate --json

​
Paths

path는 dot notation 또는 bracket notation을 사용합니다. 
openclaw config get agents.defaults.workspace
openclaw config get agents.list[0].id
특정 agent를 대상으로 할 때는 agent list index를 사용합니다. 
openclaw config get agents.list
openclaw config set agents.list[1].tools.exec.node "node-id-or-name"

​
Values

value는 가능하면 JSON5로 parse하고, 아니면 string으로 취급합니다. JSON5 parsing을 강제하려면 --strict-json을 사용하세요. --json은 legacy alias로 계속 지원됩니다. 
openclaw config set agents.defaults.heartbeat.every "0m"
openclaw config set gateway.port 19001 --strict-json
openclaw config set channels.whatsapp.groups '["*"]' --strict-json

​
Subcommands

  • config file: active config file path를 출력합니다. (OPENCLAW_CONFIG_PATH 또는 default location 기준)
설정 변경 후에는 gateway를 재시작하세요.

​
Validate

gateway를 실제로 시작하지 않고, 현재 config를 active schema에 대해 검증합니다. 
openclaw config validate
openclaw config validate --json