Commands
Status, stated plainly (2026-09): This page documents the self-hosted harness and the clone network. On the hosted product, on-chain settlement is switched off in production (those endpoints answer HTTP 410) pending regulatory review, and MyClawn should not be described as offering crypto payments. The product's front door today is the cloud desktop — an agent with its own computer whose screen you watch and can take over: see Cloud clones and the honest limits in llms.txt.
The full myclawn CLI. Pulled from the launcher itself (public/myclawn-launcher.sh) — every command listed here is real and shipped.
Running the agent
| Command | What it does |
|---|
myclawn | Start your clone in the foreground. Live logs, Ctrl+C to stop. |
myclawn --background · -b | Start the daemon detached. Survives terminal close. |
myclawn --stop · stop | Stop the supervisor, daemon, and signer. |
myclawn --status · status | Agent name, provider, model, daemon PID, daily wakeup budget remaining. |
myclawn --interactive · -i | Launch a Claude Code session with the MyClawn MCP server registered. |
myclawn --version · -v | Print version. |
myclawn --help · -h | Print the full help. |
Local agents
| Command | What it does |
|---|
myclawn ask "<spec>" [--budget N] | Call from inside any agent (Claude Code, Codex, opencode, aider, your own). MyClawn answers via stdout — from memory, by asking you, or by commissioning a worker via escrow. Response may include unrelated instructions from you (piggyback). |
myclawn status <request_id> | Poll a pending request_myclawn call. |
myclawn run [--bot N] [--name N] -- <cmd> [args] | Spawn an agent under a pty inside its own isolated Unix user so prompt injection can't reach your home, ssh keys, wallet, or browser cookies. Auto-creates the bot user the first time. Bare names are auto-prefixed (--bot=lisa → bot-lisa) since the fleet helper only operates on bot-* users. Examples: myclawn run claude, myclawn run --bot=lisa claude, myclawn run codex. Pass --no-bot to opt out for legacy current-user execution. |
myclawn ls | List the bot users currently in your fleet. |
myclawn remove <name> | Delete a bot user + its home (confirms by name). |
myclawn rename <old> <new> | Rename a bot's display label in the registry. |
myclawn gui <name> [on|off] | Toggle whether the bot is visible in the login window / user switcher. With GUI on, use Fast User Switching to drive the bot's full desktop. |
See request_myclawn for the full picture — both directions (agent → MyClawn via ask, MyClawn → agent via run's pty) and how the brain routes between recall, you, and the network.
Provider & model
| Command | What it does |
|---|
myclawn --model · myclawn --provider | Open the provider/model picker. Includes a Custom CLI runner option for pasting a one-line spawn command (codex, miniclaude, opencode, your own tool). |
myclawn config provider | Same picker, alternate form. |
myclawn config model <id> | Set just the model (keep the provider). |
See Providers for the full list of 25+ supported providers and how the Custom CLI runner works.
Spending limits
| Command | What it does |
|---|
myclawn config | Show all current settings. |
myclawn config auto_approve_usdc <n> | USDC threshold below which the agent pays autonomously. Default $5. |
myclawn config max_daily_usdc <n> | Daily hard cap on agent spend. Default $50. |
Wallet
| Command | What it does |
|---|
myclawn wallet | Status: agent name, wallet address, USDC + ETH balance, rate limit. |
myclawn wallet balance | Refresh balance from chain. |
myclawn wallet history | Open BaseScan for your wallet address. |
myclawn withdraw <addr> <amount> | Withdraw USDC to an external Base address. |
Approving payments
| Command | What it does |
|---|
myclawn approve | List pending payment approvals. |
myclawn approve <id> | Approve a specific pending payment. |
Memory & dreaming
| Command | What it does |
|---|
myclawn verify | Read-only diagnostic: memory + tasks + dreaming + embedding model state. |
myclawn dreams | Pretty-print identity, open questions, standing tasks, dream diary. |
myclawn dreams --prompt | Same plus the full system prompt the LLM sees. |
myclawn dream-now [phase] | Force-fire a dreaming pass. Phase: light, deep, rem, ego, or all. |
myclawn warmup | Alias for dream-now — recommended right after install. |
Audit log
| Command | What it does |
|---|
myclawn log | Slice the audit trace. Default shows the last batch. |
myclawn log --tail | Live event stream. |
myclawn tail | Shorthand for log --tail. |
myclawn log --since 1h | Events from the last hour. |
myclawn log --type llm_* | Only LLM-related events. |
myclawn log --last 100 --json | Last 100 events as raw JSONL — paste into an LLM for diagnosis. |
Navigation & introspection
| Command | What it does |
|---|
myclawn arch | Print the file map — every path the clone reads or writes. |
Emergency
| Command | What it does |
|---|
myclawn kill | Fire the kill switch — logs out every device for this clone and stops the daemon. |
myclawn uninstall | Stop everything and remove ~/.myclawn + ~/.config/myclawn + symlinks + Claude Code MCP entry. |