Skip to main content
The zeroclaw doctor command runs comprehensive diagnostics to verify your ZeroClaw installation and configuration.

​
Overview

The doctor command checks:
  • Configuration file validity
  • Provider credentials and connectivity
  • Channel authentication
  • File permissions
  • Network access
  • Resource availability

​
Basic Usage

# Run all diagnostics
zeroclaw doctor

# Check specific subsystem
zeroclaw doctor channel

​
Subcommands

​
doctor (no subcommand)

Run full system diagnostics. 
zeroclaw doctor
Checks:
  • Config file parsing
  • Provider configuration
  • Workspace permissions
  • Binary location
  • Version info
Output: 
✓ Config file valid: ~/.zeroclaw/config.toml
✓ Provider configured: anthropic (claude-3-5-sonnet-20241022)
✓ Workspace accessible: ~/.zeroclaw/workspace
✓ Memory backend: sqlite (~/.zeroclaw/memory.db)
⚠ Gateway not configured
ℹ ZeroClaw v0.1.8

​
channel

Diagnose channel connectivity. 
zeroclaw doctor channel
Checks:
  • Channel credentials
  • API connectivity
  • Webhook URLs
  • Allowlist configuration
  • Bot permissions
Output: 
✓ Telegram: Connected (bot @zeroclaw_bot, 2 allowed users)
✓ Discord: Connected (guild: ZeroClaw Server)
✗ Slack: Invalid token (expired)
⚠ Email: IMAP IDLE not supported by server

​
Exit Codes

  • 0: All checks passed
  • 1: Warnings detected (non-critical)
  • 2: Errors detected (requires action)

​
Common Issues

Solution:
zeroclaw config init
Solution:
export ANTHROPIC_API_KEY="sk-ant-..."
zeroclaw doctor
Solution: Check credentials in config:
zeroclaw config get channels.telegram.bot_token
Solution:
chmod 755 ~/.zeroclaw/workspace

​
Verbose Output

Enable debug logging: 
RUST_LOG=debug zeroclaw doctor

Build docs developers (and LLMs) love

Get started for freeTalk to us