Docs
CLI reference
`moltbot doctor`

`moltbot doctor`

Scope

Use this page when:

  • You have connectivity/auth issues and want guided fixes
  • You updated and want a sanity check

Health checks + quick fixes for the gateway and channels.

Related:

Examples 

moltbot doctor
moltbot doctor --repair
moltbot 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 ~/.moltbot/moltbot.json.bak and drops unknown config keys, listing each removal.

macOS: launchctl env overrides

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

launchctl getenv MOLTBOT_GATEWAY_TOKEN
launchctl getenv MOLTBOT_GATEWAY_PASSWORD

launchctl unsetenv MOLTBOT_GATEWAY_TOKEN
launchctl unsetenv MOLTBOT_GATEWAY_PASSWORD
`moltbot docs``moltbot health`