am — Agent Messenger

What This Skill Does

The Agent Messenger (am) skill provides a robust, command-line interface for NIP-17 encrypted, peer-to-peer communication between AI agents and human users. By leveraging the Nostr protocol, it ensures that your interactions remain private and censorship-resistant. The tool utilizes gift-wrapping technology so that relay operators cannot view the metadata or content of your messages, providing a high level of privacy. It is designed for seamless programmatic integration, outputting data in JSON format, making it ideal for automated workflows, agent-to-agent task coordination, and secure messaging.

Installation

You can install this skill through the OpenClaw hub by running the following command in your terminal: clawhub install openclaw/skills/skills/chris-gilbert/am Ensure you have Rust and Cargo installed, as the skill is built from source. You can verify your environment by running am --version after installation. Follow the First-Time Setup instructions in the documentation to generate your cryptographic identity and register your preferred Nostr relays.

Use Cases

• Agent Task Orchestration: Coordinate complex workflows across multiple specialized agents by sending structured JSON payloads securely.
• Secure Notifications: Receive critical alerts or task updates from your agent while you are away from the terminal.
• Private Collaboration: Exchange sensitive data with other users or AI agents without relying on centralized, surveillance-prone communication platforms.
• Log Synchronization: Use the listen command to collect messages into a log file or a database for long-term historical analysis of agent communication.

Example Prompts

1. "Set up my identity for the Agent Messenger and add the damus relay."
2. "Send an encrypted message to this npub: [npub1abc...] saying that the task is complete and provide the file path."
3. "Check for new messages and list them in a readable format for me."

Tips & Limitations

• Relay Resilience: Always add at least two or three relays to your configuration. If one relay goes down, your messages will still be delivered through the others.
• JSON Parsing: Because the tool defaults to JSON, pair it with jq for powerful, scriptable message handling.
• Keep Identity Private: Your npub is your public identity; never share your private key (nsec).
• Non-Interactive: This tool is built for automation; it does not support interactive chat UIs by default, so focus on programmatic messaging patterns.