zeroclaw doctor

Run diagnostics for system health and configuration

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

'Config file not found'

Solution:

zeroclaw config init

'Provider not configured'

Solution:

export ANTHROPIC_API_KEY="sk-ant-..."
zeroclaw doctor

'Channel authentication failed'

Solution: Check credentials in config:

zeroclaw config get channels.telegram.bot_token

'Workspace not accessible'

Solution:

chmod 755 ~/.zeroclaw/workspace

Verbose Output

Enable debug logging:

RUST_LOG=debug zeroclaw doctor

Related

• Status Command
• Troubleshooting Guide
• Configuration