OpenClaw Agents

OpenClaw agents can interact with SeRSSly through the REST API using a pre-configured API key.

Setup

Provide your SeRSSly API key as an environment variable for your agent:

SERSSLY_API_KEY=your-api-key-here
SERSSLY_BASE_URL=https://serssly.com

Agent tools

Give your agent these tool definitions to interact with SeRSSly:

# List email addresses
GET  /api/v1/email_addresses
  → Returns paginated list of addresses with RSS URLs

# Create email address
POST /api/v1/email_addresses  {"name": "..."}
  → Returns new address with email and RSS URL

# List emails for an address
GET  /api/v1/email_addresses/:id/emails
  → Returns paginated list of received emails

# Get RSS feed (no auth needed)
GET  /e/:token.rss
  → Returns RSS XML with full email content

# Check account status
GET  /api/v1/account
  → Returns plan, storage usage, limits

Example agent workflow

A typical agent interaction might look like:

1. User: "Subscribe me to the Hacker Newsletter and summarize each issue weekly."
2. Agent creates an address: POST /api/v1/email_addresses {"name": "Hacker Newsletter"}
3. Agent responds: "I've created an address. Subscribe at hackernewsletter.com using nR4tYw2k@serssly.com."
4. On a weekly schedule, agent fetches: GET /e/nR4tYw2k.rss
5. Agent summarizes the latest items and reports to the user.

OpenAPI spec

For full tool discovery, point your agent at the OpenAPI specification:

GET https://serssly.com/openapi.yaml