Command Reference

Complete reference for all MultiClaw CLI and Console commands.

Running MultiClaw

# GUI mode (double-click or:)
multiclaw --gui

# CLI interactive REPL
multiclaw

# CLI single command
multiclaw agent list

# Headless daemon
multiclaw --headless

Scriptable / Automation Mode

Global flags suppress interactive prompts in single-command mode:

MULTICLAW_PASSWORD env var is equivalent to --password and avoids the password appearing in the process list.

Note: --password suppresses the password prompt for explicit wallet commands. It does not auto-unlock the wallet before unrelated commands — see the daemon pattern below.

# Create wallet without prompts
multiclaw wallet create mywallet --password "secret"

# Open wallet without prompt
multiclaw wallet open mywallet --password "secret"

# Delete without confirmation
multiclaw policy delete old-policy --yes

Multi-Command Automation (Daemon Pattern)

Each CLI invocation is a separate process. Wallet unlock state does not persist between invocations. For multi-step automation, use the headless daemon:

# Start daemon and unlock wallet in one command
MultiClaw.exe --headless --wallet mywallet --password "secret"

# All subsequent CLI invocations connect to the running daemon
# and see the unlocked wallet
multiclaw seed list
multiclaw agent register "My Bot"
multiclaw agent commission XK7M2P standard A001
multiclaw server start

Or unlock interactively after starting the daemon:

MultiClaw.exe --headless
multiclaw wallet open mywallet --password "secret"
multiclaw agent list

The GUI can also serve as the daemon — unlock the wallet there and all CLI commands connect automatically.

Basic Commands

Wallet Commands

Manage the encrypted wallet file.

wallet status

Show wallet lock state and address count.

wallet create <name>

Create a new wallet file. You will be prompted for a password (optional).

wallet create mywallet

On success, displays the 12-word recovery phrase. Back this up securely!

Standalone mode only. Cannot create a new wallet while a GUI or daemon is running — stop it first.

wallet open <name>

Open and unlock a wallet file.

wallet open mywallet

wallet lock

Lock the wallet, clearing sensitive data from memory.

wallet detach

Unload the wallet without deleting the file. Useful for switching wallets.

Standalone mode only. Cannot detach while a GUI or daemon is running.

wallet delete

Delete the current wallet file. Requires confirmation.

Standalone mode only. Cannot delete while a GUI or daemon is running.

Seed Commands

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

seed list

List all seeds in the wallet.

seed create [--words 12|24]

Create a new seed with a randomly generated mnemonic.

seed create
seed create --words 24

The seed phrase will be displayed once. Back it up securely!

seed import [phrase]

Import an existing BIP-39 mnemonic phrase.

seed import "abandon abandon abandon ... about"

If no phrase is provided, you will be prompted to enter it.

seed delete <seed>

Delete a seed and all its derived addresses.

seed delete S002

Requires YES confirmation. Agents using affected addresses will be decommissioned.

Address Commands

Manage wallet addresses. Requires unlocked wallet.

address list

List all addresses in the wallet.

address create [seed] [index] [name]

Derive a new address from an existing seed.

# Derive next address from first seed
address create

# Derive from specific seed at index 5
address create S001 5

# Derive with custom name
address create S001 3 "My Agent Address"

Each seed/index combination must be unique. Specifying an index already in use returns an error.

address import <key> [name]

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

address import 0xabc123... "Imported Key"

address rename <address> <name>

Rename an address.

address rename A001 "Primary Funding"

address delete <address>

Delete an address from the wallet.

address delete A002

Requires YES confirmation. Agents using this address will be decommissioned.

address export <address>

Export the private key for an address.

address export A001

Requires YES confirmation. Handle private keys with extreme care!

Standalone mode only. Key export is blocked when a GUI or daemon is running — stop it first, then run the command directly.

address balance [address] [--network N]

Check on-chain balance for addresses.

# Check all addresses
address balance

# Check specific address
address balance A001

# Check on specific network
address balance A001 --network 8453

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.

agent show <agent>

Display detailed agent information.

agent show my-agent
agent show XK7M2P

agent register <name> [--auth hmac|bearer]

Register a new agent.

agent register my-claude-agent
agent register api-bot --auth bearer

Returns environment variables for agent configuration:

MULTICLAW_AGENT_ID=XK7M2P
MULTICLAW_AGENT_TOKEN=AT_...
MULTICLAW_AUTH_MODE=hmac
MULTICLAW_URL=http://localhost:9402

agent commission <agent> <policy> <address> [--mandate] [--upload]

Activate an agent with a policy and funding address.

agent commission my-agent standard A001
agent commission my-agent standard A001 --mandate
agent commission my-agent standard A001 --mandate --upload

agent edit <agent> [--policy P] [--address A]

Modify an agent's policy or address without full re-commissioning.

agent edit my-agent --policy strict
agent edit my-agent --address A002
agent edit my-agent --policy premium --address A003

agent mandate <agent> [--upload]

Generate an intent mandate for a commissioned agent.

agent mandate my-agent
agent mandate my-agent --upload

The mandate documents the user's authorization for the agent to make payments. Use --upload to publish to the AP2 registry.

agent suspend <agent>

Temporarily suspend a commissioned agent. Suspended agents cannot make payment requests. Only commissioned agents can be suspended.

agent activate <agent>

Re-enable a suspended agent. Agent must be commissioned (have a policy and address assigned).

agent delete <agent>

Delete an agent permanently.

agent delete my-agent

Requires YES 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.

policy show <policy>

Display policy details.

policy create <name> [--day N] [--txn N] [--auto N] [--networks N,N,...]

Create a new spending policy.

# Basic policy
policy create standard

# Policy with custom limits
policy create premium --day 500 --txn 50 --auto 5

# Strict policy requiring manual approval
policy create manual --day 1000 --auto 0

# Policy restricted to specific networks
policy create testnet-only --networks 84532,324705682

policy edit <policy> [--day N] [--txn N] [--auto N] [--networks N,N,...]

Modify an existing policy. Only specified options will be changed.

policy edit standard --day 200 --auto 10
policy edit premium --networks 8453,84532

policy delete <policy>

Delete a policy.

policy delete old-policy

Requires YES confirmation. Agents using this policy will be decommissioned.

Server Commands

Control the agent HTTP server that handles x402 payment requests.

server status

Show server status and port.

server start [port]

Start the agent server.

server start
server start 9403

Default port is 9402. Requires an unlocked wallet.

server stop

Stop the server.

Approval Commands

Manage pending payment requests that require manual approval.

pending

List pending approval requests.

approve <id>

Approve a pending request.

approve req001

reject <id> [reason]

Reject a pending request with optional reason.

reject req001 insufficient_funds

History Commands

View transaction history.

history [limit]

List recent transactions.

history
history 50

Default limit is 20.

history show <tx_id>

Display detailed transaction information.

history show tx001abc

The tx_id can be a prefix (e.g., first 8 characters).

history export [filename]

Export transactions to CSV file.

history export
history export ~/payments.csv
history export /full/path/to/report.csv

When no filename is given, saves to the current directory with a timestamp: transactions_20260325_143022.csv. The full path is always shown in the output.

history verify <tx_id>

Verify a transaction exists on-chain.

history verify tx001abc

history receipt <tx_id>

Get AP2-formatted receipt for a transaction.

history receipt tx001abc

Returns the receipt in JSON format for verification or record-keeping.

history clear

Clear all transaction history.

Requires YES confirmation. This cannot be undone.

Config Commands

Manage application settings. Settings persist across sessions.

config show

Display all current settings.

config get <setting>

Get a specific setting value.

config get verify-settlements
config get replay-window
config get network 8453

config set verify-settlements on|off

Enable or disable settlement verification.

config set replay-window <seconds>

Set maximum request age for replay protection (minimum 30 seconds).

config set replay-window 300

config set network <chain_id> on|off

Enable or disable a specific network.

config set network 8453 on
config set network 84532 off

config set default-port <port>

Set the default server port.

config set default-port 9403

config set allow-lan on|off

Allow or block LAN connections to the server.

config set default-network <chain_id>

Set the default network for display.

config set default-network 8453

config set rpc <chain_id> <url|default>

Set a custom RPC endpoint for a network.

config set rpc 8453 https://my-custom-rpc.com
config set rpc 8453 default

Common Workflows

Initial Setup

# 1. Create a wallet
wallet create mywallet

# 2. Create a spending policy
policy create standard --day 100 --txn 10 --auto 1

# 3. Register an agent
agent register my-ai-agent --auth bearer

# 4. Commission the agent
agent commission my-ai-agent standard A001

# 5. Start the server
server start

Importing an Existing Seed

# 1. Create empty wallet
wallet create recovery-wallet

# 2. Import your seed phrase
seed import "your twelve word phrase here ..."

# 3. Derive addresses
address create S002 0 "Primary"
address create S002 1 "Secondary"

Managing Multiple Agents

# Different policies for different trust levels
policy create low-trust --day 10 --txn 1 --auto 0
policy create high-trust --day 1000 --txn 100 --auto 50

# Register and commission agents
agent register untrusted-bot
agent commission untrusted-bot low-trust A001

agent register trusted-bot
agent commission trusted-bot high-trust A002

Exit Codes