Reply.io CLI (reply-cli)

This skill provides a command-line interface to interact with Reply.io via the official reply-cli tool. It allows you to manage outreach sequences, view statistics, manage contacts, and check connected email accounts directly from your terminal.

Prerequisites & Setup

1. The tool requires Node.js >= 20.
2. It can be run on the fly via npx reply-cli without global installation.
3. You need a Reply.io API Key to authenticate. Get it from Reply.io Settings > API.

Providing Credentials

The skill requires REPLY_API_KEY to be set in the environment. Configure it in your OpenClaw config (openclaw.json) under the agent's env block:

{
  "agents": {
    "defaults": {
      "env": {
        "REPLY_API_KEY": "your-api-key"
      }
    }
  }
}

Alternatively, add it to your ~/.openclaw/.env file, or provide it as a Docker secret at /run/secrets/reply_key.

Quick Reference / Commands

Use npx reply-cli (or just reply if installed globally) to execute commands. All commands support --json for easy machine parsing.

1. Sequences (Campaigns)

# List all sequences and basic stats
npx reply-cli sequences list --json

# Get details and email steps for a specific sequence
npx reply-cli sequences get <id> --json

# Start or Pause a sequence
npx reply-cli sequences start <id>
npx reply-cli sequences pause <id>

# View detailed per-step stats for a sequence
npx reply-cli sequences stats <id> --json

# Top 3 sequences by reply rate
npx reply-cli sequences stats --top

2. Contacts & Enrollment

# Search for a contact by email
npx reply-cli contacts search --email john@example.com --json

# Create a new contact
npx reply-cli contacts create --email john@example.com --first-name John --company Acme

# View campaign history and email activity for a contact
npx reply-cli contacts stats john@example.com --json

# Add contact to a sequence
npx reply-cli sequence-contacts add --contact john@example.com --sequence 12345

# Create and enroll in one step
npx reply-cli sequence-contacts add-new --contact jane@example.com --first-name Jane --sequence 12345

# Remove from a sequence
npx reply-cli sequence-contacts remove --contact john@example.com --sequence 12345

3. Accounts & Schedules

# List all connected email accounts
npx reply-cli accounts list --json

# List sending schedules
npx reply-cli schedules list --json

Usage Guidelines for the Agent

1. Always use --json or --pretty when you need to parse the data for the user.
2. Never hardcode or log the API key. Suggest the user store it in their .env file or provide it securely via Docker Secrets.
3. If a user asks for performance or stats, use sequences list and sequences stats <id> to give them a detailed breakdown of opens, replies, bounces, and clicks.