Command Reference

Complete reference for all MultiClaw CLI and Console commands.

Global Options

multiclaw [OPTIONS] <command> [subcommand] [args]

Seed Commands

Manage HD wallet seeds (BIP-39 mnemonic phrases).

seed list

List all seeds in the wallet.

multiclaw seed list

seed create

Create a new seed with a randomly generated 12-word mnemonic.

multiclaw seed create [--label NAME]

seed import

Import an existing BIP-39 mnemonic phrase.

multiclaw seed import [--label NAME]

You will be prompted to enter the mnemonic phrase securely.

seed backup

Display the mnemonic phrase for backup purposes.

multiclaw seed backup <seed_id>

Warning: Never share your seed phrase. Anyone with access can control all derived addresses.

seed delete

Delete a seed and all its derived addresses.

multiclaw seed delete <seed_id>

Requires confirmation. This action is irreversible.

Address Commands

Manage wallet addresses derived from seeds or imported directly.

address list

List all addresses.

multiclaw address list

address derive

Derive a new address from an existing seed.

multiclaw address derive <seed_id> [OPTIONS]

Examples:

# Derive next address from seed
multiclaw address derive S001

# Derive with specific index
multiclaw address derive S001 --index 5

# Derive with custom path and label
multiclaw address derive S001 --path "m/44'/60'/0'/0/10" --label "Cold Storage"

address import

Import a private key directly (not derived from seed).

multiclaw address import [--label NAME]

address label

Set or update the label for an address.

multiclaw address label <address_id> <label>

address balance

Check USDC balance for addresses.

multiclaw address balance [address_id] [--network NETWORK]

address delete

Delete an address from the wallet.

multiclaw address delete <address_id>

Requires confirmation. Any agents using this address will be decommissioned.

Agent Commands

Register and manage AI agents that can request payment signatures.

Note: Agent names are unique and can be used instead of codes. Names are case-insensitive.

agent list

List all registered agents.

multiclaw agent list

agent register

Register a new agent.

multiclaw agent register <name> [--auth MODE]

Example output:

✓ Agent registered successfully

  Code: XK7M2P
  Auth Key: sk_live_abc123...

  Configure your agent with:
    MULTICLAW_URL=http://localhost:9402
    MULTICLAW_AUTH_KEY=sk_live_abc123...

agent commission

Activate an agent with a policy and funding address.

multiclaw agent commission <agent> <policy> <address>

agent show

Display detailed agent information.

multiclaw agent show <agent_id>

agent spending

View agent spending statistics.

multiclaw agent spending [agent_id]

agent suspend

Temporarily suspend an agent. Suspended agents cannot make payment requests.

multiclaw agent suspend <agent_id>

agent resume

Resume a suspended agent.

multiclaw agent resume <agent_id>

agent delete

Delete an agent permanently.

multiclaw agent delete <agent_id>

Requires confirmation. Transaction history is preserved.

Policy Commands

Create and manage spending policies that control agent behavior.

Note: Policy names are unique and case-insensitive.

policy list

List all policies.

multiclaw policy list

policy create

Create a new spending policy.

multiclaw policy create <name> [OPTIONS]

Examples:

# Basic policy with limits
multiclaw policy create "standard" --daily-limit 100 --per-request-max 10 --auto-approve-below 1

# Policy with domain restrictions
multiclaw policy create "api-only" --daily-limit 50 --allowed-domains api.openai.com api.anthropic.com

# Strict policy requiring manual approval
multiclaw policy create "manual" --daily-limit 1000 --auto-approve-below 0

policy show

Display policy details.

multiclaw policy show <policy_id>

policy edit

Modify an existing policy.

multiclaw policy edit <policy_id> [OPTIONS]

policy delete

Delete a policy.

multiclaw policy delete <policy_id>

Requires confirmation. Agents using this policy will be decommissioned.

Server Commands

serve

Start the payment server in headless (CLI) mode.

multiclaw serve [OPTIONS]

The server runs interactively, prompting for approval when payments exceed the auto-approve threshold. Press Ctrl+C to stop.

Notes:

• Cannot run if GUI server is already running on the same port
• Warns if GUI instance is running (data may not sync)

History Commands

View and export transaction history.

history list

List recent transactions.

multiclaw history list [OPTIONS]

history export

Export transactions to file.

multiclaw history export [OPTIONS]

history receipt

Display AP2 receipt for a transaction.

multiclaw history receipt <tx_id>

Output: Full AP2 receipt in JSON format including intent, authorization, payment, and settlement details.

Config Commands

Manage application settings.

config show

Display current configuration.

multiclaw config show

config set

Set a configuration value.

multiclaw config set <key> <value>

Available keys:

config reset

Reset all settings to defaults.

multiclaw config reset

Console Commands

The GUI Console (File → Console) provides full access to all MultiClaw functionality via text commands.

Console Controls

Wallet Commands

Approval Commands

Server Commands (Console)

Console Features:

• Command history — Use ↑/↓ arrows to navigate previous commands
• Secure password input — Passwords are masked when entering
• Live events — Approval requests and activity appear in real-time
• No popups — All confirmations happen inline via y/n prompts

Common Workflows

Initial Setup

# 1. Create a wallet seed
multiclaw seed create --label "Main"

# 2. Derive an address
multiclaw address derive S001 --label "Agent Funding"

# 3. Create a spending policy
multiclaw policy create "standard" \
  --daily-limit 100 \
  --per-request-max 10 \
  --auto-approve-below 1

# 4. Register an agent
multiclaw agent register "My AI Agent"

# 5. Commission the agent
multiclaw agent commission XK7M2P P001 A001

# 6. Start the server
multiclaw serve

Headless Server Deployment

# Run server in background with strict verification
multiclaw serve --port 9402 --verify

# Or use separate wallet file
multiclaw -w /path/to/production.json serve --port 9402 --verify

Scripting with JSON Output

# Get agent list as JSON
multiclaw --json agent list

# Parse in shell script
AGENTS=$(multiclaw --json agent list | jq -r '.[].code')

Exit Codes