nostr-nak

What This Skill Does

The nostr-nak skill serves as a powerful bridge between OpenClaw and the Nostr network, providing a direct interface to the Nostr Army Knife (nak) CLI tool. It enables users to perform complex interactions with decentralized relays, including fetching notes, querying event metadata, and publishing content to the Nostr protocol. By integrating nak into the OpenClaw environment, this skill abstracts the complexity of raw protocol interaction while maintaining the flexibility required for advanced Nostr operations.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/samthomson/nostr-nak

Use Cases

• Decentralized Social Monitoring: Track specific public keys to aggregate content across multiple relays.
• Content Publishing: Securely broadcast notes using your private key from within an automated pipeline.
• Metadata Analysis: Fetch and inspect user profiles, contact lists, and long-form content for data analysis tasks.
• Nostr Debugging: Test relay responsiveness and event propagation by piping CLI outputs directly into your analysis workflow.

Example Prompts

1. "Fetch the latest 10 notes from my npub and list them for me using the nostr-nak skill."
2. "Use the nostr-nak skill to publish a short text note saying 'Hello world from OpenClaw' using my configured private key."
3. "Query the relay wss://relay.nostr.band for the latest event kind 1 notes and summarize the topics being discussed."

Tips & Limitations

• PTY Handling: Because nak is a CLI tool that expects a terminal, it may hang in non-interactive environments. The skill is engineered to wrap commands in script -q -c "..." /dev/null | cat to force pseudo-TTY allocation. Do not omit this wrapper if performing manual overrides.
• Relay Defaults: The skill defaults to reputable relays like wss://relay.damus.io, wss://relay.primal.net, and wss://relay.nostr.band. If you are looking for specific content not appearing in these relays, be sure to provide the specific relay URL in your prompt.
• Security: Never share your private keys (nsecs) in chat sessions. Ensure your environment uses secure environment variables for authentication keys to prevent accidental exposure.