Overview
Getting Started
Core Concepts
Runtimes
Agents
Infrastructure
OpenClaw Plugin
Documentation
Runtime CLI reference
Reference for the main ClawControl runtime commands, options, and config keys.
Command structure
After installation, the runtime package provides the clawcontrol CLI. Most
setup and operating commands live under the runtime command group, while
plugin operations live under the top-level plugin command.
Onboarding and setup commands
| Command | What it does | Common options |
|---|---|---|
clawcontrol runtime onboard | Guided first-run flow for pairing, configuration, and startup | --json |
clawcontrol runtime configure | Opens the configuration wizard | --json |
clawcontrol runtime pair [PAIRING_CODE] | Pairs the host to a ClawControl workspace and can prompt for the code interactively | --name <name>, --json |
clawcontrol doctor | Runs diagnostics across service, readiness, and linkage and recommends next steps | --json |
Runtime control commands
| Command | What it does | Common options |
|---|---|---|
clawcontrol runtime run | Runs the runtime in the foreground | --supervised |
clawcontrol runtime start | Starts the installed background service | --json |
clawcontrol runtime stop | Stops the installed background service | --json |
clawcontrol runtime restart | Restarts the installed background service | --json |
clawcontrol runtime status | Shows runtime, service, readiness, and linkage status | --json |
Service management commands
| Command | What it does | Common options |
|---|---|---|
clawcontrol runtime service install | Installs the background service | --force, --no-start, --json |
clawcontrol runtime service repair | Repairs the service definition if it has drifted | --restart, --json |
clawcontrol runtime service uninstall | Removes the background service | --json |
Logs and plugin commands
| Command | What it does | Common options |
|---|---|---|
clawcontrol runtime logs | Shows recent runtime logs | --follow, --lines <n>, `--source auto |
clawcontrol plugin install | Installs or updates the Mission Control plugin from the runtime-matched package version | [spec], --json |
clawcontrol plugin uninstall | Removes the Mission Control plugin | --json |
If you pass a [spec] to clawcontrol plugin install, it can be an npm spec
such as @clawcontrol/clawcontrol-mc@1.2.3 or a local filesystem path to a
plugin build.
Config commands
| Command | What it does |
|---|---|
clawcontrol config get | Prints the full runtime config with sensitive values masked |
clawcontrol config get <key> | Prints a single config key |
clawcontrol config set <key> <value> | Updates a mutable config value |
clawcontrol config path | Prints the resolved config file path |
Config keys you can set
The following keys can be updated with clawcontrol config set:
| Key | What it controls |
|---|---|
gatewayUrl | OpenClaw gateway URL the runtime should connect to |
gatewayBootstrapToken | Bootstrap token used for first-time or recovery gateway access |
openclawDir | OpenClaw home directory |
openclawStateDir | Explicit OpenClaw state directory |
openclawCliPath | Explicit path to the OpenClaw CLI |
authBaseAgentId | Local agent id used to locate shared auth profiles |
authBaseProfilePath | Explicit path to the auth profiles file |
telemetryEnabled | Enables or disables runtime telemetry |
commandMaxSkewMs | Allowed clock skew for signed command validation |
replayCacheTtlMs | How long replay-protection entries are retained |
Most useful options explained
| Option | Meaning |
|---|---|
--name <name> | Gives the runtime a clearer label in ClawControl |
--no-start | Installs the service without starting it immediately |
--force | Reinstalls the service even if it already exists |
--restart | Repairs the service and restarts it in one command |
--follow | Streams logs live instead of showing a fixed number of lines |
--lines <n> | Changes how many lines are returned in non-follow log mode |
| `--source auto | systemd |
--json | Returns machine-readable output for scripts and automation |
Good commands to remember
clawcontrol runtime onboard
clawcontrol doctor
clawcontrol runtime status
clawcontrol runtime logs --follow
clawcontrol runtime service repair --restart