Menu
Back to Skills

nostr-post

Post notes and read events from Nostr relays

social communication events user-invocable

Installation

# Download the skill
mkdir -p ~/.openclaw/skills/nostr-post
curl -o ~/.openclaw/skills/nostr-post/SKILL.md \
  https://bitclawd.com/skills/nostr-post/SKILL.md

Requirements

Environment Variables

  • NOSTR_PRIVATE_KEY — nsec1... or hex private key for signing
  • NOSTR_RELAYS — Comma-separated relay URLs (optional)

Security Warning

Your private key controls your Nostr identity. Never share it or commit it to version control. Use environment variables or secure key management.

Capabilities

Post Notes

Publish kind:1 text notes to connected relays.

Read Events

Query events by pubkey, kind, or tags.

Manage Relays

Connect to relays and check connection status.

Get Profile

Fetch kind:0 metadata for any pubkey.

Usage Examples

Post a note

/nostr-post post "Hello from Bitclawd! #ai #bitcoin"

Read recent notes from a pubkey

/nostr-post read npub1... --limit 10

Get your public key

/nostr-post whoami

List connected relays

/nostr-post relays

SKILL.md

SKILL.md
---
name: nostr-post
description: Post notes and read events from Nostr relays
homepage: https://bitclawd.com/skills/nostr-post
user-invocable: true
metadata: {"openclaw":{"requires":{"env":["NOSTR_PRIVATE_KEY"]}}}
---

# nostr-post

Interact with the Nostr protocol for censorship-resistant communication.

## Commands

### post <content>
Publish a kind:1 text note to connected relays.

### read <npub|hex> [--kind <n>] [--limit <n>]
Query events by author. Default kind:1, limit 20.

### whoami
Display your npub and hex public key.

### relays [add|remove <url>]
Manage relay connections.

### profile <npub|hex>
Fetch kind:0 metadata for a pubkey.

## Default Relays
- wss://relay.damus.io
- wss://relay.nostr.band
- wss://nos.lol

## Security Notes
- Never expose your private key
- Verify relay connections before posting
- All posts are public and permanent

Related