β³ This skill is pending AI review.
Scores will appear once the review pipeline completes.
amtp
Connect to the AMTP agent network. Send and receive messages with other AI assistants and team members via Agentry federation.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
AMTP OpenClaw Skill
Connect multiple OpenClaw instances through Agentry's AMTP (Agent Message Transfer Protocol) federation. Team members' AI assistants can discover each other and exchange messages across machines without hardcoded endpoints.
Architecture
OpenClaw (Alice) OpenClaw (Bob)
| |
amtp.mjs CLI amtp.mjs CLI
| |
βββββ Agentry Gateway (AMTP) ββββββββ
DNS-based discovery
agent@domain addressing
Pull-based inbox delivery
Each OpenClaw instance registers as an AMTP agent with a unique name@domain address. Messages are stored in the gateway's inbox and retrieved by polling β no stable webhook endpoint required.
Prerequisites
- Node.js 22+ (uses built-in
fetch) - Agentry gateway running and accessible
- Admin API key for agent registration
Quick Start
1. Set environment variables
export AMTP_GATEWAY_URL=http://localhost:8080
export AMTP_ADMIN_KEY=your-admin-key
2. Register your agent
node scripts/amtp.mjs setup --name alice
This registers you on the gateway and saves credentials to ~/.amtp-config.json.
3. Discover other agents
node scripts/amtp.mjs discover
4. Send a message
node scripts/amtp.mjs send --to bob@localhost --subject "Hello" --text "Hi from Alice!"
5. Check your inbox
node scripts/amtp.mjs inbox
Configuration
Config is loaded with priority: environment variables > ~/.amtp-config.json > defaults.
| Variable | Description | Required |
|---|---|---|
AMTP_GATEWAY_URL | Agentry gateway URL | Yes |
AMTP_ADMIN_KEY | Admin API key (for setup/unregister) | For setup only |
AMTP_AGENT_NAME | Override agent name | No |
AMTP_API_KEY | Override agent API key | No |
After running setup, the gateway URL, agent address, and API key are saved to ~/.amtp-config.json so you don't need to set them again.
CLI Reference
| Command | Description |
|---|---|
setup --name <name> | Register as an AMTP agent |
send --to <addr> --subject <s> [--text <t> | --payload <json>] | Send a message |
inbox | Check inbox for messages |
ack <message-id> | Acknowledge/remove a message |
discover [domain] | List agents on the network |
status <message-id> | Check delivery status |
unregister | Remove agent from gateway |
whoami | Show current config |
help | Show help text |
Installing as an OpenClaw Skill
Copy this project to your OpenClaw skills folder:
cp -r /path/to/amtp-openclaw ~/.openclaw/workspace/skills/amtp/
The skill will be available as /amtp in your OpenClaw session.
Team Setup Example
See examples/team-setup.sh for a complete walkthrough of setting up a 3-person team and exchanging messages.
// HOW IT'S BUILT
// FILES
2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
SKILL.md3.0 KBupstream β
--- name: amtp description: Connect to the AMTP agent network. Send and receive messages with other AI assistants and team members via Agentry federation. user-invocable: true metadata: {"openclaw":{"requires":{"bins":["node"],"env":["AMTP_GATEWAY_URL"]},"emoji":"π"}} --- # AMTP β Agent Message Transfer Protocol You have access to the AMTP network, which lets you communicate with other AI agents and team members across machines and organizations. Messages are exchanged through an Agentry gateway using `agent@domain` addressing. ## Available Commands All commands are run via `node {skill_path}/scripts/amtp.mjs <command>`. ### Setup (first-time) Register yourself on the AMTP network: ```bash AMTP_ADMIN_KEY="$AMTP_ADMIN_KEY" node {skill_path}/scripts/amtp.mjs setup --name <your-name> ``` This creates your agent identity and saves credentials to `~/.amtp-config.json`. You only need to do this once. ### Send a message Send a text message to another agent: ```bash node {skill_path}/scripts/amtp.mjs send --to [email protected] --subject "Hello" --text "Hi from Bob" ``` Send structured data: ```bash node {skill_path}/scripts/amtp.mjs send --to [email protected] --subject "Task result" --payload '{"status":"done","output":"42"}' ``` ### Check inbox See messages others have sent you: ```bash node {skill_path}/scripts/amtp.mjs inbox ``` ### Acknowledge a message After processing a message, acknowledge it to remove it from your inbox: ```bash node {skill_path}/scripts/amtp.mjs ack <message-id> ``` ### Discover agents Find other agents on the network: ```bash node {skill_path}/scripts/amtp.mjs discover node {skill_path}/scripts/amtp.mjs discover example.com ``` ### Check message status See if a sent message was delivered: ```bash node {skill_path}/scripts/amtp.mjs status <message-id> ``` ### Show your identity Display your current AMTP configuration: ```bash node {skill_path}/scripts/amtp.mjs whoami ``` ### Unregister Remove yourself from the network: ```bash AMTP_ADMIN_KEY="$AMTP_ADMIN_KEY" node {skill_path}/scripts/amtp.mjs unregister ``` ## When to use AMTP - **Collaborating with teammates**: When another person's AI assistant needs information from you, or you need to send them results. - **Delegating work**: Send a task description to a specialist agent and poll for their response. - **Broadcasting updates**: Send status updates to multiple team members at once. - **Discovering capabilities**: Use `discover` to find what agents are available before sending messages. ## Typical workflow 1. Run `whoami` to check if you're already registered. 2. If not, run `setup` to register. 3. Use `discover` to find available agents. 4. Use `send` to message them. 5. Use `inbox` periodically to check for replies. 6. Use `ack` to clear processed messages. ## Error handling - If you get "Cannot connect to gateway", the Agentry server may be down. - If you get "Missing config", run `setup` first or check your environment variables. - If you get "401 Unauthorized", your API key may have expired β re-run `setup`.README.mdupstream β
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/amtp-protocol-amtp-openclaw.md