Skip to main content

Introduction

Clawrium is a CLI to manage all your AI assistants. Point it at any machine on your network and deploy agents like OpenClaw with a single command.

Documentation · Issues · Roadmap · Discord

What is a Claw?​

A claw is a general-purpose AI assistant that runs on a machine in your network. Unlike coding-specific tools, claws are versatile assistants that can:

  • Answer questions via Discord, Slack, or CLI
  • Research topics and summarize findings
  • Help with writing, brainstorming, and planning
  • Connect to external services (GitHub, Jira, etc.)

Currently supported:

  • OpenClaw - Full-featured assistant with multi-provider and multi-channel support

Planned:

  • ZeroClaw - Lightweight assistant for resource-constrained devices
  • IronClaw - High-performance assistant for demanding workloads

Why Clawrium?​

You're running multiple AI agents across machines on your network. Without Clawrium, you SSH into each box, manage configs individually, and have no unified view of what's running where.

Clawrium gives you kubectl-style fleet control for AI agents:

  • One CLI, all hosts. Add machines to your fleet and deploy any agent type to any host.
  • Specialized agents. Run a fleet of purpose-built agents - a research agent, a support agent, an internal assistant - each with its own context and configuration.
  • Model flexibility. Use any provider: OpenAI, Anthropic, local Ollama, or self-hosted inference.
  • Lifecycle management. Upgrades, rollbacks, secrets rotation - handled from one place.
  • Local web dashboard. clawctl gui opens a visual fleet view on 127.0.0.1 — chat with agents, browse topology, manage providers. See the Web Dashboard guide.

How It Works​

Your Machine (clawctl CLI)
    │
    ├── Host A ──> openclaw instance (Discord bot)
    ├── Host B ──> openclaw instance (internal assistant)
    └── Host C ──> zeroclaw instance (lightweight helper)

Clawrium runs from your control machine and uses SSH + Ansible to manage remote hosts.

Quick Reference​

# Initialize Clawrium (check dependencies)
clawctl service init
✓ Configuration directory created at ~/.config/clawrium/
✓ Dependencies validated
# Register a host. First run generates the keypair and prints the
# manual xclm setup commands you need to run on the host (see the
# Host Setup guide). Re-run after pasting them to register the host.
clawctl host create 192.168.1.100 --user xclm --alias mybox
Generating SSH keypair for 192.168.1.100...
✓ Keypair created: ~/.config/clawrium/keys/192.168.1.100/
xclm SSH verification failed: Authentication failed - check SSH keys

Manual setup required. Log into the host with a sudo-capable user and
run the printed Linux or macOS block, then re-run this command.
# Add an initialized host to the fleet
clawctl host create 192.168.1.100 --alias homelab
Connecting to 192.168.1.100 as xclm...
✓ Connection successful
Detecting hardware capabilities...
  CPU: 4 cores (ARM64)
  Memory: 8 GB
  GPU: None
✓ Host 'homelab' added to fleet
# See your fleet status
clawctl agent get
HOST        AGENT          TYPE       PROVIDER   STATUS    UPTIME
──────────────────────────────────────────────────────────────────
homelab     oc-discord     openclaw   openai     running   3d 4h
nuc-01      oc-work        openclaw   anthropic  running   12h
# Install an agent on a host
clawctl agent create --type openclaw --host homelab --name my-assistant
Installing openclaw on homelab...
✓ Dependencies installed
✓ Agent user created
✓ Configuration deployed
✓ Agent 'my-assistant' installed successfully
# Open the local web dashboard
clawctl gui
Clawrium GUI starting on http://127.0.0.1:36000 — press Ctrl+C to stop

Key Concepts​

ConceptDescription
HostA machine in your network that runs one or more agents
ClawAn AI assistant instance (like OpenClaw or ZeroClaw)
AgentAn installed claw instance managed by Clawrium
RegistryAvailable claw types with versions, dependencies, and templates

What You'll Need​

Before you start, make sure you have:

RequirementDetails
Control machinemacOS or Linux with Python 3.10+
Target hostUbuntu 22.04/24.04 with SSH access
NetworkDirect connectivity between control machine and hosts
API keysAt least one LLM provider (OpenAI, Anthropic, etc.)

Architecture​

Clawrium architecture

Clawrium runs from your control machine and uses SSH + Ansible to manage remote hosts from one CLI.

FAQ​

What operating systems are supported?​

Clawrium is currently tested on Ubuntu control machines and Ubuntu 22.04/24.04 target hosts.

Which agents are supported today?​

OpenClaw is supported with full lifecycle management. ZeroClaw support is planned.

Is Claude subscription supported?​

No. API keys are required by design - Clawrium manages API credentials, not subscription accounts.

Which communication channels are supported?​

Discord, Slack, and CLI are supported today. Web interface is planned.

Do I need to be online?​

Yes. The agents connect to LLM providers via API. Local inference with Ollama reduces external dependencies but still requires the model to be served.

Why doesn't it support my favorite agent?​

Clawrium is built in spare time, so features are prioritized by maintainer use cases. Want support for a specific agent? Open an issue or send a PR.

User Data​

Clawrium stores configuration in ~/.config/clawrium/:

PathDescription
hosts.jsonRegistered hosts and metadata
keys/<hostname>/SSH keypairs for each host
secrets/<agent-name>/Encrypted secrets for agent instances

Next Steps​