Mailbox CLI (OpenClaw Skill)

Use the mailbox CLI as a tool to read and manage email. OpenClaw handles channel delivery and scheduling. The mailbox CLI returns structured JSON outputs and optional text summaries.

Requirements

• mailbox CLI installed (npm install -g mailbox-cli)

• Credentials in ~/.config/mailbox/auth.json

Commands (examples)

• mailbox account list --json

• mailbox email list --limit 20 --json

• mailbox email show <email_uid> --account-id <account_id> --json

• mailbox email show <email_uid> --account-id <account_id> --preview --no-html --json

• mailbox email show <email_uid> --account-id <account_id> --preview --no-html --strip-urls --json

• mailbox email delete <email_uid> --account-id <account_id> --folder INBOX --confirm --json

• mailbox digest run --json

• mailbox monitor run --json

• mailbox inbox --limit 15 --text

Safety rules

• Always use --json for automation and check success.

• Include --account-id for destructive operations.

• Destructive operations default to dry-run unless --confirm is provided.

• Prefer --dry-run before mutating when available.

Output contract

• JSON response includes success and error fields.

• error is an object with { code, message, detail? }.

• Exit codes: 0 success, 1 operation failed, 2 invalid usage.