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:

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

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

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

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