⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v0.1.0

amtp

amtp-protocol@amtp-protocol⭐ 6 stars· last commit 9mo ago· 0 open issues

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.

β€”/10

// RATINGS

⭐GitHub Stars
⭐ 6 on GitHubGitHub β†—

New / niche

🟒ProSkills Score
β€”
πŸ“

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.

VariableDescriptionRequired
AMTP_GATEWAY_URLAgentry gateway URLYes
AMTP_ADMIN_KEYAdmin API key (for setup/unregister)For setup only
AMTP_AGENT_NAMEOverride agent nameNo
AMTP_API_KEYOverride agent API keyNo

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

CommandDescription
setup --name <name>Register as an AMTP agent
send --to <addr> --subject <s> [--text <t> | --payload <json>]Send a message
inboxCheck inbox for messages
ack <message-id>Acknowledge/remove a message
discover [domain]List agents on the network
status <message-id>Check delivery status
unregisterRemove agent from gateway
whoamiShow current config
helpShow 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

// REPO STATS

6 stars
0 open issues
Last commit: 9mo ago