npm install -g @openmail/cli

export OPENMAIL_API_KEY=om_xxx

openmail <command> [subcommand] [flags]
openmail help <command>

# One-command setup (OpenClaw integration: skill, env files, systemd on Linux by default)
openmail setup [--mode websocket|webhook]

# Create a new inbox (interactive prompts, or pass flags)
openmail init [--mailbox-name john] [--display-name "John Smith"]

# Manage inboxes
openmail inbox list --limit 10
openmail inbox create [--mailbox-name <name>] [--display-name <sender name>]
openmail inbox get --id inb_xxx
openmail inbox delete --id inb_xxx

# Send email (uses default inbox from setup/init, or pass --inbox-id)
openmail send --to hello@example.com --subject "Hi" --body "Hello"

# Send with a custom Reply-To
# (free plan: must be an inbox you own; Pro+: any address)
openmail send --to hello@example.com --subject "Hi" --body "Hello" \
  --reply-to support@yourdomain.com

# List messages and threads
openmail messages list [--direction inbound|outbound]
openmail threads list
openmail threads get --thread-id thr_xxx

# Runtime status
openmail status

# WebSocket bridge (forwards events to OpenClaw hook)
openmail ws bridge [--hook-url <url>] [--hook-token <token>]

openmail doctor