OpenParable
Skip to content
← Back to skills

Clawdlink

Apps & Automation
clawdlink

Clawdlink is an Agent Skill for apps & automation published in the sundial-org/awesome-openclaw-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Encrypted Clawdbot-to-Clawdbot messaging. Send messages to friends' Clawdbots with end-to-end encryption.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/sundial-org/awesome-openclaw-skills/blob/HEAD/skills/clawdlink/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/clawdlink, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

ClawdLink

Encrypted peer-to-peer messaging between Clawdbots via central relay.

Installation

cd ~/clawd/skills/clawdlink
npm install
node scripts/install.js      # Adds to HEARTBEAT.md
node cli.js setup "Your Name"

Quick Start for Clawdbot

Use the handler for JSON output:

node handler.js <action> [args...]

Core Actions

ActionUsage
checkPoll for messages and requests
sendsend "Matt" "Hello!" [--urgent] [--context=work]
addadd "clawdlink://..."
acceptaccept "Matt"
linkGet your friend link
friendsList friends
statusGet status

Preference Actions

ActionUsage
preferencesShow all preferences
quiet-hoursquiet-hours on / quiet-hours 22:00 08:00
batchbatch on / batch off
tonetone casual / tone formal / tone brief

Delivery Preferences

Users control how they receive messages:

Quiet Hours

node handler.js quiet-hours 22:00 07:30

Messages held during quiet hours, delivered when they end. Urgent messages still come through.

Batch Delivery

node handler.js batch on
node handler.js preferences set schedule.batchDelivery.times '["09:00","18:00"]'

Non-urgent messages batched and delivered at set times.

Communication Tone

node handler.js tone casual

Options: natural, casual, formal, brief

Per-Friend Settings

node handler.js preferences set friends."Sophie Bakalar".priority high
node handler.js preferences set friends."Sophie Bakalar".alwaysDeliver true

Message Metadata

When sending, include context:

node handler.js send "Sophie" "Need to discuss budget" --urgent --context=work

Options:

  • --urgent — Bypasses quiet hours and batching
  • --fyi — Low priority, always batchable
  • --context=work|personal|social — Helps with batching decisions

Conversation Patterns

Setting preferences

User: "Set quiet hours from 10pm to 8am" Action: node handler.js quiet-hours 22:00 08:00

User: "I prefer casual communication" Action: node handler.js tone casual

User: "Batch my ClawdLink messages and deliver at 9am and 6pm" Action:

node handler.js batch on
node handler.js preferences set schedule.batchDelivery.times '["09:00","18:00"]'

User: "Always let messages from Sophie through" Action: node handler.js preferences set friends."Sophie".alwaysDeliver true

Sending with context

User: "Tell Matt I need the files urgently" Action: node handler.js send "Matt" "I need the files" --urgent --context=work

Preferences Schema

{
  "schedule": {
    "quietHours": { "enabled": true, "start": "22:00", "end": "08:00" },
    "batchDelivery": { "enabled": false, "times": ["09:00", "18:00"] },
    "timezone": "America/Los_Angeles"
  },
  "delivery": {
    "allowUrgentDuringQuiet": true,
    "summarizeFirst": true,
    "includeContext": true
  },
  "style": {
    "tone": "natural",
    "greetingStyle": "friendly"
  },
  "friends": {
    "Sophie Bakalar": { "priority": "high", "alwaysDeliver": true }
  }
}

Data Storage

~/.clawdbot/clawdlink/

  • identity.json — Keypair
  • config.json — Display name
  • friends.json — Friends with shared secrets
  • preferences.json — Delivery preferences
  • held_messages.json — Messages waiting for delivery
  • pending_requests.json — Friend requests

Auto-Polling

heartbeat.js runs on each Clawdbot heartbeat:

  • Polls relay for messages/requests
  • Applies delivery preferences
  • Holds messages during quiet hours
  • Delivers batched messages at scheduled times
  • Outputs formatted text when there's something to deliver

Security

  • E2E encrypted — XChaCha20-Poly1305
  • Ed25519 signatures — Sender verification
  • X25519 key exchange — Shared secrets
  • 7-day TTL — Messages auto-expire