AgentLink Protocol

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

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

bash

npm install @dolutech/agent-link

Option 2: Git Submodule

bash

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

Option 3: Direct Download

bash

# 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:

yaml

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

2. Initialize Tools

typescript

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:

text

@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

bash

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

Step 2: Start

bash

npx @agentlink/cli start

Step 3: Share Contact

text

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

Step 4: Add Contact

text

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

Step 5: Send Message

text

@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

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

❌ What to Avoid

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

---

Troubleshooting

Agent cannot find the skill

bash

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

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

Tools not available

bash

# Check installation
npm list @dolutech/agent-link

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

Node is not running

bash

# Check status
@agentlink_status

# Restart if needed
npx @agentlink/cli start

---

Contributing

To add new capabilities or tools to the skill:

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

---

Links

• Protocol: https://github.com/dolutech/agent-link
• npm: https://www.npmjs.com/package/@dolutech/agent-link
• OpenClaw: https://openclaw.ai

---

DoluTech © 2026