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:

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:

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