Skip to content

CLI Reference

40 top-level commands in the current CLI help surface. The roboticus binary is both the runtime server and the management CLI.

Usage:
$ roboticus <command> [options]
roboticus admin
Administrative operations
roboticus agents
Manage agents
roboticus auth
Manage provider authentication
roboticus channels
Manage channel adapters and dead-letter queue
roboticus check
Validate config, database, and provider connectivity
roboticus circuit
Manage circuit breaker state for LLM providers
roboticus completion
Generate shell completions
roboticus config
View and manage configuration
roboticus cron
Manage cron jobs
roboticus daemon
Manage the roboticus daemon (alias for service)
roboticus defrag
Database optimization or code quality scanning
roboticus help
Help about any command
roboticus ingest
Ingest documents into the knowledge system
roboticus init
Initialize a new roboticus workspace
roboticus keystore
Manage the encrypted keystore
roboticus logs
Stream or fetch recent log entries
roboticus mcp
Manage MCP (Model Context Protocol) servers
roboticus mechanic
Database diagnostics and repair
roboticus memory
Query and manage memory tiers
roboticus metrics
View cost, cache, and capacity metrics
roboticus migrate
Run migrations and data import/export
roboticus models
Query available models and routing diagnostics
roboticus plugins
Manage plugins (alias: apps)
roboticus profile
Manage agent configuration profiles
roboticus reset
Reset all data (preserves schema)
roboticus schedule
Manage scheduled jobs (alias for cron)
roboticus security
Security configuration and auditing
roboticus serve
Start the roboticus agent runtime
roboticus service
Manage the roboticus system service
roboticus sessions
Manage agent sessions
roboticus setup
Interactive onboarding wizard
roboticus skills
Manage agent skills
roboticus status
Display agent health and status
roboticus tui
Launch interactive terminal interface
roboticus uninstall
Uninstall the roboticus service and optionally remove data
roboticus update
Check for updates or update the binary
roboticus upgrade
Upgrade the roboticus runtime
roboticus version
Print version information
roboticus wallet
Wallet balance and address management
roboticus web
Open the dashboard in your default browser

Common Workflows

First-Time Setup

$ roboticus init           # Create ~/.roboticus/ with defaults
$ roboticus setup          # Interactive setup wizard
$ roboticus check          # Validate configuration
$ roboticus serve          # Start the runtime

Migrate from OpenClaw

$ roboticus migrate import /path/to/openclaw --yes
$ roboticus check
$ roboticus serve

Diagnostics

$ roboticus status         # Agent status overview
$ roboticus logs --follow  # Tail live logs
$ roboticus mechanic       # Diagnostics + self-repair
$ roboticus circuit status # Circuit breaker states
←PreviousAPI Reference