English | 中文

@peerclaw/openclaw-plugin

OpenClaw channel plugin for PeerClaw — a P2P agent identity and trust platform.

This plugin registers PeerClaw as a native communication channel in OpenClaw, enabling:

• Bidirectional messaging — P2P messages appear as OpenClaw conversations; AI responses are sent back via PeerClaw
• Notification forwarding — Server notifications are injected into OpenClaw conversations
• Identity binding — OpenClaw instances are linked to PeerClaw Ed25519 agent identities

Architecture

PeerClaw Agent (Go) OpenClaw Gateway
agent/platform/openclaw/ ws://localhost:18789
│ │
├─── WebSocket connect ─────────►│
├─── chat.send (P2P msg) ──────►│──► AI processing
│◄── chat event (AI reply) ─────│
├─── chat.inject (notification)►│──► conversation display
│ │
▼ ▼
P2P Network OpenClaw Conversations

The PeerClaw Go agent connects to the OpenClaw gateway via WebSocket. This TypeScript plugin registers PeerClaw as a recognized channel so conversations are displayed and managed correctly.

Installation

npm install @peerclaw/openclaw-plugin

Or add to your OpenClaw configuration:

{
"plugins": ["@peerclaw/openclaw-plugin"]
}

Configuration

Add to your OpenClaw config.yaml:

channels:
peerclaw:
enabled: truepublicKey: "<your-agent-ed25519-public-key>"serverUrl: "http://localhost:8080"dmPolicy: "pairing"# pairing | allowlist | open | disabledallowFrom: [] # list of allowed agent IDs

Configuration Options

Option	Type	Default	Description
enabled	boolean	true	Enable/disable the PeerClaw channel
name	string	—	Display name for this account
publicKey	string	required	Ed25519 public key identifying this agent
serverUrl	string	—	PeerClaw server URL
dmPolicy	string	"pairing"	DM access policy
allowFrom	string[]	[]	Allowed sender agent IDs

Agent-Side Setup

On the PeerClaw agent side, configure the OpenClaw platform adapter in your peerclaw.yaml:

platform:
type: openclawgateway_url: "ws://localhost:18789"auth_token: ""

Development

git clone https://github.com/peerclaw/openclaw-plugin.git
cd openclaw-plugin
npm install

License

Apache-2.0