Nostr

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Meegeleverde Plugin

​

Oudere/aangepaste installaties

• Onboarding (openclaw onboard) en openclaw channels add tonen Nostr nog steeds vanuit de gedeelde kanaalcatalogus.
• Als je build de meegeleverde Nostr uitsluit, installeer dan een actueel npm-pakket wanneer er een is gepubliceerd.

openclaw plugins install @openclaw/nostr

openclaw plugins install --link <path-to-local-nostr-plugin>

​

Niet-interactieve configuratie

openclaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY"
openclaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY" --relay-urls "wss://relay.damus.io,wss://relay.primal.net"

​

Snelle configuratie

1. Genereer een Nostr-sleutelpaar (indien nodig):

# Using nak
nak key generate

2. Voeg toe aan de configuratie:

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
    },
  },
}

3. Exporteer de sleutel:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Herstart de Gateway.

​

Configuratiereferentie

​

Profielmetadata

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      profile: {
        name: "openclaw",
        displayName: "OpenClaw",
        about: "Personal assistant DM bot",
        picture: "https://example.com/avatar.png",
        banner: "https://example.com/banner.png",
        website: "https://example.com",
        nip05: "openclaw@example.com",
        lud16: "openclaw@example.com",
      },
    },
  },
}

• Profiel-URL’s moeten https:// gebruiken.
• Importeren vanuit relays voegt velden samen en behoudt lokale overschrijvingen.

​

Toegangscontrole

​

DM-beleid

• pairing (standaard): onbekende afzenders krijgen een koppelingscode.
• allowlist: alleen pubkeys in allowFrom kunnen DM’en.
• open: openbare inkomende DM’s (vereist allowFrom: ["*"]).
• disabled: inkomende DM’s negeren.

• Handtekeningen van inkomende events worden geverifieerd vóór het afzenderbeleid en NIP-04-decryptie, zodat vervalste events vroeg worden geweigerd.
• Koppelingsantwoorden worden verzonden zonder de oorspronkelijke DM-body te verwerken.
• Inkomende DM’s worden rate-limited en te grote payloads worden vóór decryptie geweigerd.

​

Allowlist-voorbeeld

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      dmPolicy: "allowlist",
      allowFrom: ["npub1abc...", "npub1xyz..."],
    },
  },
}

​

Sleutelindelingen

• Privésleutel: nsec... of 64-tekens hex
• Pubkeys (allowFrom): npub... of hex

​

Relays

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      relays: ["wss://relay.damus.io", "wss://relay.primal.net", "wss://nostr.wine"],
    },
  },
}

• Gebruik 2-3 relays voor redundantie.
• Vermijd te veel relays (latentie, duplicatie).
• Betaalde relays kunnen de betrouwbaarheid verbeteren.
• Lokale relays zijn geschikt voor testen (ws://localhost:7777).

​

Protocolondersteuning

​

Testen

​

Lokale relay

# Start strfry
docker run -p 7777:7777 ghcr.io/hoytech/strfry

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      relays: ["ws://localhost:7777"],
    },
  },
}

​

Handmatige test

1. Noteer de bot-pubkey (npub) uit de logs.
2. Open een Nostr-client (Damus, Amethyst, enz.).
3. DM de bot-pubkey.
4. Controleer de reactie.

​

Probleemoplossing

​

Geen berichten ontvangen

• Controleer of de privésleutel geldig is.
• Zorg dat relay-URL’s bereikbaar zijn en wss:// gebruiken (of ws:// voor lokaal).
• Bevestig dat enabled niet false is.
• Controleer Gateway-logs op relay-verbindingsfouten.

​

Geen reacties verzenden

• Controleer of de relay schrijfbewerkingen accepteert.
• Controleer uitgaande connectiviteit.
• Let op rate limits van relays.

​

Dubbele reacties

• Verwacht bij gebruik van meerdere relays.
• Berichten worden ontdubbeld op event-ID; alleen de eerste levering triggert een reactie.

​

Beveiliging

• Commit nooit privésleutels.
• Gebruik omgevingsvariabelen voor sleutels.
• Overweeg allowlist voor productiebots.
• Handtekeningen worden geverifieerd vóór het afzenderbeleid, en het afzenderbeleid wordt gehandhaafd vóór decryptie, zodat vervalste events vroeg worden geweigerd en onbekende afzenders geen volledige cryptografische verwerking kunnen afdwingen.

​

Beperkingen (MVP)

• Alleen directe berichten (geen groepschats).
• Geen mediabijlagen.
• Alleen NIP-04 (NIP-17 gift-wrap gepland).

​

Gerelateerd

• Kanalenoverzicht — alle ondersteunde kanalen
• Koppelen — DM-authenticatie en koppelingsflow
• Groepen — gedrag van groepschats en mention-gating
• Kanaalroutering — sessieroutering voor berichten
• Beveiliging — toegangsmodel en hardening