openclaw/docs/cli/doctor.md

---
summary: "CLI reference for `clawdbot doctor` (health checks + guided repairs)"
read_when:
  - You have connectivity/auth issues and want guided fixes
  - You updated and want a sanity check
---

# `clawdbot doctor`

Health checks + quick fixes for the gateway and channels.

Related:
- Troubleshooting: [Troubleshooting](/gateway/troubleshooting)
- Security audit: [Security](/gateway/security)

## Examples

```bash
clawdbot doctor
clawdbot doctor --repair
clawdbot doctor --deep
```

Notes:
- Interactive prompts (like keychain/OAuth fixes) only run when stdin is a TTY and `--non-interactive` is **not** set. Headless runs (cron, Telegram, no terminal) will skip prompts.
- `--fix` (alias for `--repair`) writes a backup to `~/.clawdbot/clawdbot.json.bak` and drops unknown config keys, listing each removal.

## macOS: `launchctl` env overrides

If you previously ran `launchctl setenv CLAWDBOT_GATEWAY_TOKEN ...` (or `...PASSWORD`), that value overrides your config file and can cause persistent “unauthorized” errors.

```bash
launchctl getenv CLAWDBOT_GATEWAY_TOKEN
launchctl getenv CLAWDBOT_GATEWAY_PASSWORD

launchctl unsetenv CLAWDBOT_GATEWAY_TOKEN
launchctl unsetenv CLAWDBOT_GATEWAY_PASSWORD
```
docs(cli): add per-command CLI pages 2026-01-15 06:12:54 +00:00			`---`
			summary: "CLI reference for `clawdbot doctor` (health checks + guided repairs)"
			`read_when:`
			`- You have connectivity/auth issues and want guided fixes`
			`- You updated and want a sanity check`
			`---`

			# `clawdbot doctor`

			`Health checks + quick fixes for the gateway and channels.`

			`Related:`
			`- Troubleshooting: [Troubleshooting](/gateway/troubleshooting)`
			`- Security audit: [Security](/gateway/security)`

			`## Examples`

			```bash
			`clawdbot doctor`
			`clawdbot doctor --repair`
			`clawdbot doctor --deep`
			```

docs: clarify model refs and runtime notes Co-authored-by: Yuri Chukhlib <YuriNachos@users.noreply.github.com> 2026-01-17 17:16:20 +00:00			`Notes:`
			- Interactive prompts (like keychain/OAuth fixes) only run when stdin is a TTY and `--non-interactive` is not set. Headless runs (cron, Telegram, no terminal) will skip prompts.
fix: repair doctor config cleanup 2026-01-20 01:30:33 +00:00			- `--fix` (alias for `--repair`) writes a backup to `~/.clawdbot/clawdbot.json.bak` and drops unknown config keys, listing each removal.
docs: clarify model refs and runtime notes Co-authored-by: Yuri Chukhlib <YuriNachos@users.noreply.github.com> 2026-01-17 17:16:20 +00:00
fix(macos): check config file mode for gateway token/password resolution (#1022) * fix: honor config gateway mode for credentials * chore: oxfmt doctor platform notes --------- Co-authored-by: Peter Steinberger <steipete@gmail.com> 2026-01-16 19:29:48 +00:00			## macOS: `launchctl` env overrides

			If you previously ran `launchctl setenv CLAWDBOT_GATEWAY_TOKEN ...` (or `...PASSWORD`), that value overrides your config file and can cause persistent “unauthorized” errors.

			```bash
			`launchctl getenv CLAWDBOT_GATEWAY_TOKEN`
			`launchctl getenv CLAWDBOT_GATEWAY_PASSWORD`

			`launchctl unsetenv CLAWDBOT_GATEWAY_TOKEN`
			`launchctl unsetenv CLAWDBOT_GATEWAY_PASSWORD`
			```