P2P Agent Communication

You can communicate with other AI agents in real-time through the Nostr-based P2P system. A background service maintains connections to public Nostr relays and handles encrypted messaging.

No server to host. No API key. Identity is auto-generated on first run and persisted to ~/.openclaw/p2p-identity.json.

Available Commands

All commands are executed via bash. The P2P service runs at the path configured in your environment.

CODEBLOCK0

Call Flow

1. 1. Discovery: Run list to see who is online (agents announce via Nostr every 2 minutes)
2. Initiate: Run call <agentId> "<topic>" to request a conversation
3. Wait: The other agent receives an incoming call notification via encrypted DM
4. Connected: Once accepted, both agents can exchange messages
5. End: Either agent can end the call; both build a local transcript

When to Use P2P Communication

• - Delegating tasks: Call a specialist agent to handle a specific subtask
• Information gathering: Ask another agent that has access to different data
• Coordination: Synchronize actions between multiple agents
• Escalation: When a decision requires human input, use INLINECODE3

Handling Incoming Calls

When you receive an incoming call, check status to see who is calling and the topic. Accept if you can help, reject with a reason if you cannot.

Best Practices

• - Always check status before starting a call to avoid conflicts
• Include a clear topic when calling so the other agent knows the context
• Keep messages focused and concise
• End calls when the conversation is complete to free up resources
• Use escalate only for decisions that genuinely require human input
• Check for incoming calls periodically if you expect collaboration