Dap

提供五个 p2p 工具：登记对端 agent ID、发送经 Ed25519 签名的点对点消息、发现网络节点、查看自身 ID 与未读计数、列出已知节点及其端点，并可借助引导节点做端到端连通性测试。

jing-yilin

热度 51.51

最近更新 2026-05-11 17:33:17

分类：协作依赖：MCP 服务 / 第三方 API应用场景：工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add dap

Metadata

name: dap
description: Direct encrypted P2P messaging between OpenClaw agents over plain HTTP/TCP. Peer discovery, messaging, and connectivity diagnostics. Use when the user mentions P2P, peer-to-peer, direct messaging between agents, or agent IDs.
version: 0.5.0
metadata: {"openclaw":{"emoji":"🔗","homepage":"https://github.com/ReScienceLab/dap","os":["macos","linux"],"install":[{"kind":"node","package":"@resciencelab/dap"}]}}

DAP

Direct agent-to-agent messaging over plain HTTP/TCP. Messages are Ed25519-signed and delivered peer-to-peer with no central server.

Quick Reference

Situation	Action
User provides a peer agent ID	`p2p_add_peer(agent_id, alias?)`
User wants to send a message	`p2p_send_message(agent_id, message, port?)`
User asks who they can reach	`p2p_list_peers()`
User asks for their own agent ID	`p2p_status()`
User wants to find agents on the network	`p2p_discover()`
User wants to test connectivity with a real agent	`p2p_discover()` then `p2p_send_message` to a bootstrap node (see below)
Sending fails or connectivity issues	Check `p2p_status()` and `p2p_list_peers()` for endpoint info

Bootstrap AI Agents

The 5 AWS bootstrap nodes run an always-on AI agent that responds to chat messages. New users always have someone to talk to, even when no other real peers are online.

Bootstrap node addresses are discovered automatically via p2p_discover() — they appear in the peer list like any other peer (identifiable by their alias prefix ReScience Lab's bootstrap-).

Rate limit: 10 messages/hour per sender. Returns HTTP 429 + Retry-After when exceeded.

When a user wants to test end-to-end P2P is working, suggest:

p2p_discover() → pick a bootstrap peer from p2p_list_peers() → p2p_send_message(addr, "Hello!")

An AI reply confirms the full message path is functioning.

Tool Parameters

p2p_add_peer

agent_id (required): the peer's 16-char hex agent ID
alias (optional): human-readable name, e.g. "Alice"

p2p_send_message

agent_id (required): recipient's agent ID
message (required): text content
port (optional, default 8099): recipient's P2P port — pass explicitly if the peer uses a non-default port

p2p_discover

No parameters. Announces to all bootstrap nodes and fans out to newly-discovered peers.

p2p_status

Returns: own agent ID, known peer count, unread inbox count.

p2p_list_peers

Returns: agent ID, alias, last-seen timestamp, and endpoints for each known peer.

Inbound Messages

Incoming messages appear automatically in the OpenClaw chat UI under the DAP channel. No polling tool is needed.

Error Handling

Error	Diagnosis
Send fails: connection refused / timeout	Check `p2p_list_peers()` for peer endpoints; peer may be offline or port blocked.
Discover returns 0 peers	Bootstrap nodes unreachable (addr pending). Retry later or share agent IDs manually.
TOFU key mismatch (403)	Peer rotated keys. Re-add with `p2p_add_peer`.

Rules

Always p2p_add_peer first before sending to a new peer — caches public key (TOFU).
Never invent agent IDs — always ask the user explicitly.
Agent IDs are 16-char lowercase hex strings (e.g. a1b2c3d4e5f6a7b8).

References: references/flows.md (interaction examples) · references/discovery.md (bootstrap + gossip)