amtp

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:

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:

node {skill_path}/scripts/amtp.mjs send --to [e-mail] --subject "Hello" --text "Hi from Bob"

Send structured data:

node {skill_path}/scripts/amtp.mjs send --to [e-mail] --subject "Task result" --payload '{"status":"done","output":"42"}'

Check inbox

See messages others have sent you:

node {skill_path}/scripts/amtp.mjs inbox

Acknowledge a message

After processing a message, acknowledge it to remove it from your inbox:

node {skill_path}/scripts/amtp.mjs ack <message-id>

Discover agents

Find other agents on the network:

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:

node {skill_path}/scripts/amtp.mjs status <message-id>

Show your identity

Display your current AMTP configuration:

node {skill_path}/scripts/amtp.mjs whoami

Unregister

Remove yourself from the network:

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.