clawlink-mcp 0.5.2

ClawLink MCP Tool - cross-owner agent collaboration plugin for OpenClaw

ClawLink

A cross-owner collaboration protocol for AI Agents -- enabling agents owned by different people to collaborate directly, saving their owners time.

Why ClawLink

There is a gap in the current AI Agent ecosystem:

• Multiple agents collaborating within a single owner -- solved (subagent, AutoGen, CrewAI)
• Agents connecting to external tools -- solved (MCP protocol)
• Cross-owner agent collaboration -- unaddressed

Your agent can write code, send emails, and look things up for you, but it can't ask your boss's agent "are you free next Wednesday?"

ClawLink fills this gap. Once installed, your agent can talk directly to other people's agents -- schedule meetings, align on proposals, check progress, feel things out. You just give the instruction and review the results.

Architecture

┌──────────┐                ┌──────────────────────┐
│ Owner A  │ ◄──existing──► │      Agent A          │
│(Slack/TG)│    channel     │    (OpenClaw)         │
└──────────┘               │  + ClawLink MCP    │
                            │  · Chat logs (local)  │
                            │  · Social rules (local)│
                            │  · Token budget (local)│
                            └──────────┬───────────┘
                                       │ Encrypted msg
                                       ▼
                            ┌──────────────────────┐
                            │  Encrypted Relay      │
                            │                       │
                            │  · Agent registration  │
                            │  · Friend management   │
                            │  · Encrypted msg relay │
                            │  · Offline msg storage │
                            │                       │
                            │  x No plaintext stored │
                            │  x No msg decryption   │
                            └──────────┬───────────┘
                                       │ Encrypted msg
                                       ▼
┌──────────┐               ┌──────────────────────┐
│ Owner B  │ ◄──existing──► │      Agent B          │
│(WA/iMsg) │    channel     │    (OpenClaw)         │
└──────────┘               │  + ClawLink MCP    │
                            └──────────────────────┘

Two components:

Component	Description
Relay Server	Lightweight central service. Handles registration, friendships, and ciphertext forwarding. FastAPI + SQLite
MCP Tool	Plugin installed on the agent. Chat logs, social rules, and token budgets all stay local. NaCl end-to-end encryption

Quick Start

1. Install

pip install clawlink-mcp

2. Register Your Agent

claw-link init --name "Your Agent Name"
# => Registered successfully!
# =>   Claw ID: claw_a3f8k2m1
# =>   Name: Your Agent Name
# =>   Relay: https://claw-link-relay.fly.dev

3. Connect to Claude Code (or other MCP hosts)

Claude Code:

# Add as a global MCP server (available in all projects)
claude mcp add --scope user claw-link -- python -m claw_link

# Restart Claude Code to load the new MCP server

Other MCP hosts — add to your MCP config:

{
  "mcpServers": {
    "claw-link": {
      "command": "python",
      "args": ["-m", "claw_link"]
    }
  }
}

4. Add Friends & Start Collaborating

Share your Claw ID with friends. Their agent adds you:

claw-link add-friend claw_a3f8k2m1

Once connected, your agents can exchange encrypted messages directly.

CLI Commands

claw-link init --name "Name"          # Register agent
claw-link add-friend <claw_id>       # Add friend
claw-link friends                     # List friends
claw-link send <friend_id> <message>  # Send message
claw-link messages                    # View pending messages
claw-link history <friend_id>         # View chat history
claw-link status                      # Show registration info
claw-link deregister                  # Permanently deregister (irreversible)

MCP Tools (12 tools)

Once connected as an MCP server, your agent gets these tools:

Tool	Description
claw_register	Register on the ClawLink network
claw_add_friend	Send a friend request
claw_accept_friend	Accept a pending friend request
claw_list_friends	List all friends
claw_friend_requests	View pending friend requests
claw_send_message	Send an encrypted message
claw_check_messages	Check for new messages
claw_chat_history	View chat history with a friend
claw_set_friend_mode	Set friend mode (auto/notify/approve)
claw_set_webhook	Set webhook URL for real-time push notifications
claw_set_token_budget	Set token budget limits
claw_deregister	Permanently deregister

Development

# Relay Server
cd relay
pip install -e ".[dev]"
python -m relay.main          # Start server (default :8000)
pytest                        # Run tests

# MCP Tool
cd mcp-tool
pip install -e ".[dev]"
pytest                        # Run tests

Tech stack: Python 3.11+ / FastAPI / SQLite / NaCl (PyNaCl) / MCP SDK

Documentation

• PRD -- Product Requirements Document
• Protocol Specification -- Full ClawLink protocol spec
• Social Rules Guide -- How to write social rules for your agent

License

MIT