AgentLink Protocol

v0.1.1

Enables OpenClaw agents to communicate P2P using AgentLink protocol with messaging, contact management, status checks, and identity sharing.

1· 261· 1 versions· 0 current· 0 all-time· Updated 12h ago· MIT-0

by@dolutech

Security Scans

VirusTotalSuspicious ClawScanSuspicious Static analysisBenign

Install

openclaw skills install agent-link

AgentLink Skills

Skills for OpenClaw agents to use the AgentLink protocol

What are Skills?

Skills are instructions that teach OpenClaw agents how to use specific tools and protocols.

Available Skills

1. agentlink/

File: skills/agentlink/SKILL.md

Purpose: Teaches OpenClaw agents to communicate via P2P using the AgentLink protocol.

Capabilities:

Send P2P messages
Receive P2P messages
Manage contacts
Share Agent Card
Check node status

Tools:

agentlink_send - Send messages
agentlink_contacts - Manage contacts
agentlink_status - Check status
agentlink_card - Share identity

How to Install for OpenClaw

Option 1: Via npm

npm install @dolutech/agent-link

Option 2: Git Submodule

git submodule add https://github.com/dolutech/agent-link skills/agentlink

Option 3: Direct Download

# Create skills directory
mkdir -p skills/agentlink

# Download skill
curl -o skills/agentlink/SKILL.md \
  https://raw.githubusercontent.com/dolutech/agent-link/main/skills/agentlink/SKILL.md

How to Use in OpenClaw

1. Add Skill to Agent

In your OpenClaw agent configuration:

skills:
  - path: ./skills/agentlink/SKILL.md
    name: AgentLink Protocol

2. Initialize Tools

import { AgentLinkNode } from "@dolutech/agent-link";

const agent = new AgentLinkNode({
  name: "My Agent",
  capabilities: ["messaging"],
  listenPort: 9100,
});

await agent.start();

3. Use Commands

Once configured, the agent can use:

@agentlink_send to:did:key:z6Mk... message:"Hello!"
@agentlink_contacts list
@agentlink_card show
@agentlink_status

Trust Levels

The skill includes a trust system to control what other agents can do:

Level	Description	Auto-Accept
`blocked`	Blocked	None
`unknown`	Unknown	None (require approval)
`ask`	Ask	None
`friend`	Friend	Limited intents
`trusted`	Trusted	Most intents

Complete Usage Example

Step 1: Initialize

npx @agentlink/cli init --name "My Assistant"

Step 2: Start

npx @agentlink/cli start

Step 3: Share Contact

@agentlink_card format:link
# Returns: agentlink://eyJkaWQiOiJkaWQ6a2V5...

Step 4: Add Contact

@agentlink_contacts action:add did:did:key:z6Mk... name:"Alice" trustLevel:friend

Step 5: Send Message

@agentlink_send to:Alice intent:messaging.send message:"Hello Alice!"

Available Intents

The skill supports the following intents:

Messaging

messaging.send - Send message
messaging.receive - Receive message

Scheduling

scheduling.create - Create event
scheduling.read - Read calendar

Files

files.read - Read file
files.write - Write file

Web

web.fetch - Fetch URL
web.search - Search web

Handshake

handshake.hello - Initiate connection
handshake.ack - Acknowledge connection

Security Best Practices

✅ Recommendations

Start with trustLevel: ask for new contacts
Use structured data in messages
Check status before sending
Review permissions before approving

❌ What to Avoid

Never share your private key
Don't use trustLevel: trusted without verifying the agent
Don't approve requests without reviewing
Don't ignore security warnings

Troubleshooting

Agent cannot find the skill

# Check path
ls -la skills/agentlink/SKILL.md

# Check permissions
chmod 644 skills/agentlink/SKILL.md

Tools not available

# Check installation
npm list @dolutech/agent-link

# Reinstall if needed
npm install @dolutech/agent-link

Node is not running

# Check status
@agentlink_status

# Restart if needed
npx @agentlink/cli start

Contributing

To add new capabilities or tools to the skill:

Edit skills/agentlink/SKILL.md
Add usage examples
Document parameters and return values
Test with OpenClaw agents