🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › Sigil Nostr — P2P Encrypted Messaging for AI Agents
🦀 ClawHub

Sigil Nostr — P2P Encrypted Messaging for AI Agents

by @lmanchu

Nostr P2P messaging gateway for AI agents. Send and receive E2E encrypted messages via the Nostr protocol. Enables your agent to be reachable from Sigil Mess...

Versionv0.1.1
Downloads356
#security#legal
TERMINAL
clawhub install sigil-nostr

📖 About This Skill

name: sigil-nostr description: Nostr P2P messaging gateway for AI agents. Send and receive E2E encrypted messages via the Nostr protocol. Enables your agent to be reachable from Sigil Messenger, Damus, and any Nostr client. metadata: {"clawdbot": {"emoji": "⚡", "user-invocable": true}, "category": "messaging", "author": "lmanchu", "version": "0.1.0", "repository": "https://github.com/lmanchu/sigil"}

Sigil Nostr — P2P Encrypted Messaging for AI Agents

Give your AI agent a Nostr identity. Users can message your agent from Sigil Messenger, Damus, Primal, or any Nostr client — all E2E encrypted.

What This Does

  • Creates a persistent Nostr keypair for your agent (~/.sigil/.key)
  • Connects to Nostr relays and listens for NIP-04 encrypted DMs
  • Routes incoming messages to your agent, sends replies back via Nostr
  • Supports TUI components (buttons, cards, tables) for rich responses
  • Personal agent mode: only whitelisted npubs can interact

    • Quick Start

    1. Install Sigil CLI

    cargo install --git https://github.com/lmanchu/sigil sigil-cli

    2. Start as Agent Bridge

    The simplest way — pipe messages between Nostr and your agent:

    # Generate agent identity
sigil whoami
    Your agent's npub is shown — users can DM this to reach your agent
    

    Add your npub to the access whitelist:
    

    Edit ~/.sigil/.access.json → add npub to "authorized" array

    3. Use from OpenClaw / Hermes

    This skill works with both OpenClaw and Hermes agent frameworks.

    OpenClaw: Add to your openclaw.json channels config: 

    {
  "channels": {
    "nostr": {
      "enabled": true,
      "relay": "wss://relay.damus.io",
      "dmPolicy": "personal",
      "allowFrom": ["npub1yourownpubkey..."]
    }
  }
}

    Hermes: Install as a skill: 

    # Copy this skill directory to ~/.hermes/skills/sigil-nostr/
cp -r skills/sigil-nostr ~/.hermes/skills/

    Connect from Sigil Client

    Once your agent bridge is running, users connect from any of these clients:

    iPhone / iPad (Sigil Messenger)

    1. Download Sigil Messenger from the App Store 2. Tap Add Contact (person+ icon) 3. Choose Scan QR Code — scan the agent's QR, or 4. Choose Add Manually — paste the agent's npub 5. Start chatting — messages are E2E encrypted

    Terminal (sigil-cli)

    cargo install --git https://github.com/lmanchu/sigil sigil-cli
    Add your agent
    
sigil add sigil://agent?npub=&relay=wss://relay.damus.io&name=MyAgent
    Start chatting
    
sigil

    Mac (Catalyst)

    Same app as iOS — build from source with Xcode or install via sigil-cli. Link Mac to iPhone by scanning QR code (Mac shows QR, iPhone scans).

    Any Nostr Client (Damus, Primal, Amethyst)

    Your agent is a standard Nostr identity. Send a NIP-04 DM to the agent's npub from any Nostr client. TUI components (buttons, cards) only render in Sigil — other clients show raw JSON.

    Sharing Your Agent

    Every agent gets a shareable QR code and sigil:// URI: 
    sigil qr  # prints sigil://agent?npub=...&relay=...&name=...
    Share this URI or QR — anyone who scans it gets your agent added instantly.

    Architecture

    User (Sigil/Damus/Primal)
    ↓ NIP-04 Encrypted DM
Nostr Relay (relay.damus.io)
    ↓ WebSocket
Sigil Bridge (this skill)
    ↓ stdin/stdout or HTTP
Your Agent (OpenClaw / Hermes / Custom)

    Agent Bridge Script

    For standalone use, run the bridge directly:

    # Start the Nostr bridge for your agent
cd /path/to/sigil
cargo run --example hermes_bridge

    Or use the Node.js bridge for OpenClaw integration:

    node skills/sigil-nostr/bridge.js

    Security

  • Personal mode (default): only owner + authorized npubs can interact
  • Service mode: open to anyone (like a LINE official account)
  • Rate limiting: 10 messages/minute per sender
  • Event dedup: prevents relay replay attacks
  • Key encryption: sigil encrypt-key for passphrase protection

    • Configuration

    Config file: ~/.sigil/.access.json

    {
  "mode": "personal",
  "owner": "npub1...",
  "authorized": ["npub1friend1...", "npub1friend2..."],
  "reject_message": "This is a personal agent. Contact the owner for access."
}

    TUI Messages

    Your agent can send rich interactive messages:

    {"type": "buttons", "text": "What do you need?", "items": [
  {"id": "search", "label": "Search", "style": "primary"},
  {"id": "help", "label": "Help", "style": "secondary"}
]}

    Supported types: text, buttons, card, table

    When a user taps a button, your agent receives: sigil:callback:

    Links

  • Sigil GitHub
  • Landing Page
  • Sigil Messenger on App Store (pending review)
  • Agent Registry (kind:31990)

    • 💡 Examples

    1. Install Sigil CLI

    cargo install --git https://github.com/lmanchu/sigil sigil-cli

    2. Start as Agent Bridge

    The simplest way — pipe messages between Nostr and your agent:

    # Generate agent identity
sigil whoami
    Your agent's npub is shown — users can DM this to reach your agent
    

    Add your npub to the access whitelist:
    

    Edit ~/.sigil/.access.json → add npub to "authorized" array

    3. Use from OpenClaw / Hermes

    This skill works with both OpenClaw and Hermes agent frameworks.

    OpenClaw: Add to your openclaw.json channels config: 

    {
  "channels": {
    "nostr": {
      "enabled": true,
      "relay": "wss://relay.damus.io",
      "dmPolicy": "personal",
      "allowFrom": ["npub1yourownpubkey..."]
    }
  }
}

    Hermes: Install as a skill: 

    # Copy this skill directory to ~/.hermes/skills/sigil-nostr/
cp -r skills/sigil-nostr ~/.hermes/skills/

    ⚙️ Configuration

    Config file: ~/.sigil/.access.json

    {
  "mode": "personal",
  "owner": "npub1...",
  "authorized": ["npub1friend1...", "npub1friend2..."],
  "reject_message": "This is a personal agent. Contact the owner for access."
}