Nostr Skill

Self-sovereign Nostr identity + ecash wallet. Complete bootstrap.

Capabilities Disclosure

This skill grants these capabilities to the agent:

• - Key generation — Creates Nostr keypair in INLINECODE0
• Wallet creation — Cashu wallet in ~/.cocod/ (mnemonic in config.json — user backs up)
• Nostr posting — Posts, DMs, zaps as the agent's identity

Agent runs wallet/identity setup with explicit user consent. User is directed to back up ~/.cocod/config.json (contains mnemonic). Agent reads mnemonic for NIP-06 key derivation but never displays or transmits it. Profile images use URLs only (no local file access).

On Install

When skill is installed (user pastes ClawHub link), run this flow:

Step 1: Secure Setup (User Consent Required)

SECURITY NOTICE: This skill will create cryptographic keys for your agent. This requires:

• - Creating Nostr identity keypair in INLINECODE3
• Creating Cashu wallet with backup seed in INLINECODE4
• User must explicitly backup the mnemonic seed phrase

CODEBLOCK0

Step 2: Report Results + Backup Warning

Reply to user:

---

⚡ Nostr identity ready!

npub: npub1...
Lightning address: npub1...@npubx.cash

---

⚠️ IMPORTANT: Back up your recovery phrase

Your 24-word mnemonic is stored in:
CODEBLOCK1

This phrase recovers both your Nostr identity AND ecash wallet. Back it up securely and protect this file.

Reply "done" when you've backed it up.

---

Step 3: Wait for "done"

Do not proceed until user confirms backup.

Step 4: Ask for Owner's npub

---

What's your Nostr npub?

I'll follow you so we stay connected.

(Paste your npub1... or NIP-05 like you@domain.com)

---

Then:
CODEBLOCK2

Step 5: Ask for Profile Images

---

Do you have profile images for me?

• - Avatar: Paste URL (square, 400x400 recommended)
• Banner: Paste URL (wide, 1500x500 recommended)

Or say "skip" and I'll generate unique ones automatically.

---

If URLs provided:
CODEBLOCK3

If skipped, use DiceBear (deterministic, unique per npub):
CODEBLOCK4

Step 6: First Post

---

Ready for your first post?

Tell me what to post, or say "skip".

Suggestion: "Hello Nostr! ⚡"

---

If user provides text (use stdin to avoid shell injection):
CODEBLOCK5

Step 7: Done

---

✅ All set!

• - Following you ✓
• First post live ✓ (if not skipped)

Try: "check my mentions" or "post "

---

Commands Reference

Posting

CODEBLOCK6

Reading

CODEBLOCK7

Connections

CODEBLOCK8

DMs

CODEBLOCK9

Zaps

CODEBLOCK10

Wallet

CODEBLOCK11

Profile

CODEBLOCK12

Bookmarks

CODEBLOCK13

Relays

CODEBLOCK14

Autoresponse (Heartbeat Integration)

CODEBLOCK15

State file: ~/.openclaw/workspace/memory/nostr-autoresponse-state.json
WoT source: Owner's follow list (defined in nostr.js as OWNER_PUBKEY)

User Phrases → Actions

User says	Action
"post X"	INLINECODE8
"reply to X with Y"

echo "Y" \| nostr.js reply <note> - | | "check mentions" | nostr.js mentions | | "my feed" | nostr.js feed | | "follow X" | Lookup if NIP-05 → nostr.js follow | | "DM X message" | echo "message" \| nostr.js dm <npub> - | | "zap X 100 sats" | nostr.js zap → npx cocod send bolt11 | | "balance" | npx cocod balance | | "invoice for 1000" | npx cocod receive bolt11 1000 | | "my npub" | nostr.js whoami | | "my lightning address" | npx cocod npc address |

Defaults

Setting	Value
Mint	INLINECODE20
Lightning domain

@npubx.cash | | Avatar fallback | https://api.dicebear.com/7.x/shapes/png?seed=<npub> | | Nostr key | ~/.nostr/secret.key | | Wallet data | ~/.cocod/ |

Integration

SOUL.md

• - Pull name/about from SOUL.md or IDENTITY.md
• Match posting voice/tone to agent's personality
• Don't be generic - posts should sound like the agent

HEARTBEAT.md

Add to heartbeat rotation (every 2-4 hours):

# Check Nostr activity
node {SKILL_DIR}/scripts/nostr.js mentions 10
node {SKILL_DIR}/scripts/nostr.js dms 5

If mentions from WoT or zaps received → notify user.

TOOLS.md

After setup, store for quick reference: CODEBLOCK17

Profile Sources

• - Name: IDENTITY.md or SOUL.md
• About: SOUL.md description
• Picture: User-provided URL, or DiceBear fallback
• Banner: User-provided URL, or DiceBear fallback
• lud16: From INLINECODE25