@ross/openclaw-channel-agentmail (1.0.0-alpha.3)

Published 2026-05-12 03:42:40 +00:00 by ross

Setup this registry in your project .npmrc file:

@ross:registry=

To install the package using npm, run the following command:

npm install @ross/openclaw-channel-agentmail@1.0.0-alpha.3

or add it to the package.json file:

"@ross/openclaw-channel-agentmail": "1.0.0-alpha.3"

For more information on the npm registry, see the documentation.

AgentMail Channel

🦊 OpenClaw channel plugin for AgentMail — turn email inboxes into OpenClaw chat conversations.

This plugin lets your OpenClaw agent send and receive emails through AgentMail's API, treating each email thread as a conversation channel. Built on OpenClaw's channel plugin SDK.

Features

Inbox as channel — Each AgentMail inbox becomes a messaging channel
Threaded conversations — AgentMail threads map to OpenClaw session threads
Two-way email — Send and receive emails directly from OpenClaw
DM security — Configurable sender allowlists and pairing flows
Webhook-ready — Supports AgentMail webhooks for real-time inbound email

Installation

openclaw plugins install @ross/openclaw-channel-agentmail

Or for development:

git clone https://git.reslate.solutions/ross/agentmail-channel.git
cd agentmail-channel
npm install
npm run build

Configuration

Get an API key from the AgentMail Console
Set up the channel in your OpenClaw config:

{
  "channels": {
    "agentmail": {
      "accounts": {
        "default": {
          "apiKey": "your-api-key",
          "inboxId": "your-inbox-id"
        }
      }
    }
  }
}

Or via environment variable:

export AGENTMAIL_API_KEY="your-api-key"

Development

npm install        # Install dependencies
npm run build      # Compile TypeScript
npm run dev        # Watch mode
npm test           # Run tests
npm run lint       # Lint code
npm run format     # Format code

Commit Convention

This project uses Conventional Commits with commitlint enforcement.

feat: add outbound email sending
fix: resolve inboxId parsing for multi-tenant pods
docs: update README with setup instructions

Release Workflow

Automated via semantic-release on push to main:

Analyzes commits for version bump (fix → patch, feat → minor, BREAKING → major)
Generates CHANGELOG
Publishes to git.reslate.solutions npm registry

Project Structure

src/
├── index.ts              # Plugin entry point
├── channel-plugin.ts     # Channel plugin definition
├── config.ts             # Config resolution
├── outbound.ts           # Outbound messaging (send email)
├── session-grammar.ts    # Conversation/thread mapping
└── types.ts              # Public type exports
tests/
└── unit/                 # Unit tests

License

MIT — see LICENSE

Development dependencies

ID	Version
@commitlint/cli	^19.0.0
@commitlint/config-conventional	^19.0.0
@semantic-release/changelog	^6.0.3
@semantic-release/commit-analyzer	^13.0.0
@semantic-release/exec	^7.1.0
@semantic-release/git	^10.0.1
@semantic-release/npm	^12.0.0
@semantic-release/release-notes-generator	^14.0.0
@types/node	^22.0.0
conventional-changelog-conventionalcommits	^8.0.0
eslint	^9.0.0
eslint-config-prettier	^10.1.8
husky	^9.0.0
prettier	^3.0.0
semantic-release	^25.0.0
typescript	^5.5.0
typescript-eslint	^8.59.2
vitest	^3.0.0