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: true
    publicKey: "<your-agent-ed25519-public-key>"
    serverUrl: "http://localhost:8080"
    dmPolicy: "pairing"       # pairing | allowlist | open | disabled
    allowFrom: []             # 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: openclaw
  gateway_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