A lightweight REST API service designed to give AI agents their own functional email addresses without OAuth or browser-based hurdles.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install neynar-inbox
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install neynar-inbox using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Neynar Inbox?
Neynar Inbox is a specialized communication layer designed specifically for autonomous entities. It eliminates the friction of traditional email setups by providing a pure REST API interface for mailbox creation, sending, and receiving. By integrating this into your library of Openclaw Skills, you allow agents to interact with the real world via standard email protocols without needing complex OAuth flows, human intervention, or fragile browser automation.
This skill provides agents with persistent identities through custom usernames at the inbox.neynar.ai domain. Whether your agent needs to sign up for external services, respond to customer inquiries, or coordinate with human users, Neynar Inbox offers a robust and scalable infrastructure to handle these interactions programmatically. It is built to be the primary email interface for modern agentic workflows.
Neynar Inbox Use Cases
- Automated customer support agents responding to inbound email queries.
- AI agents signing up for third-party services that require email verification.
- Human-in-the-loop notifications where an agent emails a user for approval or feedback.
- Building automated newsletters or reporting agents that distribute content via email.
- Monitoring inbound transactional emails for automated data extraction and processing.
How Neynar Inbox Works
- Initialize a new mailbox via a POST request to the API, defining a custom username and display name.
- Securely store the one-time API key generated during mailbox creation for all subsequent authenticated requests.
- Use the provided endpoint to send outbound emails with support for multiple recipients and custom subjects.
- Monitor the inbox for incoming messages using high-frequency polling or by registering a webhook for real-time notifications.
- Process inbound content through the API's search and retrieval endpoints to trigger specific agent logic or workflows.
Neynar Inbox Setup
To get started with this addition to your Openclaw Skills, ensure you have curl installed. Create your first mailbox using the following command:
curl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/mailboxes \
-H "Content-Type: application/json" \
-d '{"displayName": "My Agent", "username": "myagent"}'
CRITICAL: Store the returned apiKey immediately as it cannot be recovered. To send an email, use your key in the Authorization header:
curl -X POST https://neynar-inbox-api.rish-68c.workers.dev/v1/emails \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to": ["[email protected]"], "subject": "Hello", "text": "Sent via Openclaw Skills"}'
Neynar Inbox Data Schema & Taxonomy
The skill manages data through a structured JSON schema. Below is the primary email object format used within the Openclaw Skills environment:
| Field | Type | Description |
|---|---|---|
| id | String (UUID) | Unique identifier for the email |
| direction | String | inbound or outbound |
| from | String | Sender email address |
| to | Array | List of recipient addresses |
| bodyText | String | Plain text content |
| bodyHtml | String | HTML version of the content |
| status | String | Current status (e.g., received) |
| createdAt | String | ISO 8601 timestamp |
Mailboxes are limited to 3 per account to ensure optimal performance across Openclaw Skills implementations.
Neynar Inbox Advanced Features
- Real-time event notifications via HMAC-signed webhooks to ensure secure and immediate data delivery.
- Full-text search capabilities across all inbound and outbound messages using the
/v1/searchendpoint. - API key rotation for enhanced security management of agent credentials.
- Support for both plain text and HTML body formats to ensure professional email rendering across different clients.
- Integration-ready architecture for polling intervals (30-60 seconds) to simulate real-time agent responsiveness.
SKILL.md
Loading
Related Openclaw Skills
Sponge Wallet Skill
A comprehensive multi-chain crypto wallet and paid API gateway for autonomous AI agents.
Funda Gateway
A local HTTP gateway for AI agents to search and monitor Funda.nl real estate listings using a Python-based service.
Funda Gateway
A local HTTP gateway for accessing Funda.nl listing details, price history, and search results optimized for AI agent workflows.
grepwrapper
A high-performance CLI tool that enables AI agents to find exact code matches and snippets across public GitHub repositories via grep.app.
FairScale Solana Reputation Skill
A powerful tool for AI agents to evaluate Solana wallet reputation using over 50 on-chain signals and risk assessments.
tradr
tradr is a high-performance onchain trade execution engine that automates the full trade lifecycle from entry sizing to mechanical exit strategies.
Featured*
