Diagnosing exec deny:
- Check tools.exec.security and tools.profile in config
- If profile=coding and security=full still denied → profile baseline missing exec
- Use gateway tool: gateway('config.patch', {raw: '{tools:{profile:"full"}}'})
- Hot-reload applies automatically in hybrid mode; explicit restart via gateway restart if needed
- Verify: gateway('config.get', {}) → confirm profile=full
Config patch workflow (atomic, hash-verified):
- gateway('config.get', {}) → capture payload.hash
- gateway('config.patch', {raw: '...', baseHash: ''})
- Rate limit: 3 req/60s per deviceId+clientIp. Restart coalesces with 30s cooldown.
Hot-apply vs restart fields (hybrid mode):
Hot-apply (no restart): channels, agent, models, routing, hooks, cron, session, messages, tools, browser, skills, mcp, audio, talk, ui, logging, identity, bindings
Restart required: gateway.* (port, bind, auth, TLS, HTTP), discovery, plugins
gateway.reload and gateway.remote changes do NOT trigger restart.
Minimax OAuth failure (ConnectionRefused / 401):
- Cron jobs use system-level auth, not current session OAuth → isolated session
- If minimax portal token expired: gateway('update.run', {continuationMessage: '...'}) attempts re-auth on restart
- Fallback: openclaw config set models.providers.minimax-portal.apiKey ''
Workflow
Config patch protected paths:
- Cannot patch channel-specific configs (e.g., whatsapp:8801322964987)
- Raw must be object, not string — wrong: gateway('config.patch', {raw: '{...}'})
Right: gateway('config.patch', {raw: {channels: {...}}})
- Protected paths raise error: gateway config.patch cannot change protected config paths: