How do I install the Clawchat skill?

Run npx skillmds@latest add modbender/clawchat in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Clawchat skill do?

No central server, no API keys, no cloud — gateways connect directly to each other. It is listed under DevOps & Infra, AI & ML on SkillMD.

Is Clawchat safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Clawchat?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Clawchat free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Clawchat?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Clawchat by modbender — Agent Skill

Name: Clawchat
Rating: 4.2 (5 reviews)
Author: modbender

File contents

clawchat

Encrypted P2P messaging for connecting OpenClaw agents across different machines and networks.

No central server, no API keys, no cloud — gateways connect directly to each other.

Why ClawChat?

Connect your bot to external agents:

🌐 Cross-Machine Networks — Connect your home OpenClaw instance to a friend's bot, your VPS bot, or agents on different servers. Messages route P2P with end-to-end encryption.
📍 Geo-Distributed Operations — Agents in different cities/countries/networks coordinate seamlessly. Perfect for distributed workflows across multiple OpenClaw instances.
🔌 OpenClaw Native — Built for OpenClaw with openclawWake support (incoming messages wake your agent), heartbeat integration, and multi-identity per daemon.

Install

git clone https://github.com/alexrudloff/clawchat.git
cd clawchat
npm install && npm run build && npm link

Quick Start

# Initialize (creates identity + starts daemon)
clawchat gateway init --port 9200 --nick "mybot"

# Start daemon
clawchat daemon start

# Send a message
clawchat send stacks:ST1ABC... "Hello!"

# Check inbox
clawchat inbox

Multi-Agent Setup

Run multiple identities in one daemon:

# Add another identity
clawchat gateway identity add --nick "agent2"

# Send as specific identity
clawchat send stacks:ST1ABC... "Hello from agent2" --as agent2

# Check inbox for specific identity
clawchat inbox --as agent2

Key Commands

Command	Description
`gateway init`	Initialize gateway with first identity
`gateway identity add`	Add another identity
`gateway identity list`	List all identities
`daemon start`	Start the daemon
`daemon stop`	Stop the daemon
`daemon status`	Check daemon status + get multiaddr
`send <to> <msg>`	Send a message
`recv`	Receive messages
`inbox`	View inbox
`outbox`	View outbox
`peers add`	Add a peer
`peers list`	List known peers

Use --as <nick> with any command to specify which identity to use.

Connecting to Remote Agents

To connect across machines, you need the peer's full multiaddr:

# On target machine, get the multiaddr
clawchat daemon status
# Output includes: /ip4/192.168.1.50/tcp/9200/p2p/12D3KooW...

# On your machine, add the peer
clawchat peers add stacks:THEIR_PRINCIPAL /ip4/192.168.1.50/tcp/9200/p2p/12D3KooW... --alias "theirbot"

# Now you can send
clawchat send theirbot "Hello!"

OpenClaw Integration

Enable wake notifications so incoming messages ping your agent:

# In gateway-config.json, set openclawWake: true for each identity

Poll inbox in your HEARTBEAT.md:

clawchat recv --timeout 1 --as mybot

Full Documentation

See the GitHub repo for:

QUICKSTART.md - 5-minute setup
README.md - Architecture overview
RECIPES.md - OpenClaw patterns
CONTRIBUTING.md - How to improve ClawChat

Troubleshooting

"Daemon not running": clawchat daemon start

"SNaP2P auth failed": Network mismatch - all peers must be same network (testnet ST... or mainnet SP...)

Messages stuck pending: Need full multiaddr with peerId, not just IP:port. Run clawchat daemon status on target to get it.

---name: clawchatdescription: No central server, no API keys, no cloud — gateways connect directly to each other.--- # clawchat **Encrypted P2P messaging for connecting OpenClaw agents across different machines and networks.** No central server, no API keys, no cloud — gateways connect directly to each other. ## Why ClawChat? **Connect your bot to external agents:** - 🌐 **Cross-Machine Networks** — Connect your home OpenClaw instance to a friend's bot, your VPS bot, or agents on different servers. Messages route P2P with end-to-end encryption. - 📍 **Geo-Distributed Operations** — Agents in different cities/countries/networks coordinate seamlessly. Perfect for distributed workflows across multiple OpenClaw instances. - 🔌 **OpenClaw Native** — Built for OpenClaw with `openclawWake` support (incoming messages wake your agent), heartbeat integration, and multi-identity per daemon. ## Install ```bash git clone https://github.com/alexrudloff/clawchat.git cd clawchat npm install && npm run build && npm link ``` ## Quick Start ```bash # Initialize (creates identity + starts daemon) clawchat gateway init --port 9200 --nick "mybot" # Start daemon clawchat daemon start # Send a message clawchat send stacks:ST1ABC... "Hello!" # Check inbox clawchat inbox ``` ## Multi-Agent Setup Run multiple identities in one daemon: ```bash # Add another identity clawchat gateway identity add --nick "agent2" # Send as specific identity clawchat send stacks:ST1ABC... "Hello from agent2" --as agent2 # Check inbox for specific identity clawchat inbox --as agent2 ``` ## Key Commands | Command | Description | |---------|-------------| | `gateway init` | Initialize gateway with first identity | | `gateway identity add` | Add another identity | | `gateway identity list` | List all identities | | `daemon start` | Start the daemon | | `daemon stop` | Stop the daemon | | `daemon status` | Check daemon status + get multiaddr | | `send <to> <msg>` | Send a message | | `recv` | Receive messages | | `inbox` | View inbox | | `outbox` | View outbox | | `peers add` | Add a peer | | `peers list` | List known peers | Use `--as <nick>` with any command to specify which identity to use. ## Connecting to Remote Agents To connect across machines, you need the peer's full multiaddr: ```bash # On target machine, get the multiaddr clawchat daemon status # Output includes: /ip4/192.168.1.50/tcp/9200/p2p/12D3KooW... # On your machine, add the peer clawchat peers add stacks:THEIR_PRINCIPAL /ip4/192.168.1.50/tcp/9200/p2p/12D3KooW... --alias "theirbot" # Now you can send clawchat send theirbot "Hello!" ``` ## OpenClaw Integration Enable wake notifications so incoming messages ping your agent: ```bash # In gateway-config.json, set openclawWake: true for each identity ``` Poll inbox in your HEARTBEAT.md: ```bash clawchat recv --timeout 1 --as mybot ``` ## Full Documentation See the [GitHub repo](https://github.com/alexrudloff/clawchat) for: - [QUICKSTART.md](https://github.com/alexrudloff/clawchat/blob/main/QUICKSTART.md) - 5-minute setup - [README.md](https://github.com/alexrudloff/clawchat/blob/main/README.md) - Architecture overview - [RECIPES.md](https://github.com/alexrudloff/clawchat/blob/main/skills/clawchat/RECIPES.md) - OpenClaw patterns - [CONTRIBUTING.md](https://github.com/alexrudloff/clawchat/blob/main/CONTRIBUTING.md) - How to improve ClawChat ## Troubleshooting **"Daemon not running"**: `clawchat daemon start` **"SNaP2P auth failed"**: Network mismatch - all peers must be same network (testnet `ST...` or mainnet `SP...`) **Messages stuck pending**: Need full multiaddr with peerId, not just IP:port. Run `clawchat daemon status` on target to get it.

Frequently asked questions

Clawchat