Nostr

​

Installeren

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):

# Met nak
nak key generate

2. Voeg dit toe aan de configuratie:

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

3. Exporteer de sleutel:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Start de Gateway opnieuw.

​

Configuratiereferentie

​

Profielmetadata

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      profile: {
        name: "openclaw",
        displayName: "OpenClaw",
        about: "Persoonlijke assistent voor DM's",
        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.
• Bij importeren vanuit relays worden velden samengevoegd en lokale overschrijvingen behouden.

​

Toegangsbeheer

​

DM-beleid

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

• Handtekeningen van inkomende events worden vóór het afzenderbeleid en de NIP-04-ontsleuteling geverifieerd, zodat vervalste events vroegtijdig worden geweigerd.
• Koppelingsantwoorden worden verzonden zonder de inhoud van de oorspronkelijke DM te ontsleutelen of te verwerken.
• Voor inkomende DM’s gelden frequentielimieten (globaal en per afzender) en te grote payloads worden vóór ontsleuteling verwijderd.

​

Voorbeeld van een toelatingslijst

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

​

Sleutelindelingen

• Privésleutel: nsec... of hex van 64 tekens
• Publieke sleutels (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 tests (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 publieke sleutel van de bot uit de Gateway-logboeken of openclaw channels status (hex; converteer indien nodig naar npub in je client).
2. Open een Nostr-client (Amethyst, Damus enzovoort).
3. Stuur een DM naar de publieke sleutel van de bot.
4. Controleer het antwoord.

​

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 gebruik).
• Controleer of enabled niet false is.
• Controleer de Gateway-logboeken op verbindingsfouten met relays.

​

Geen antwoorden verzenden

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

​

Dubbele antwoorden

• Dit is te verwachten bij gebruik van meerdere relays.
• Berichten worden op event-ID gededupliceerd; alleen de eerste aflevering activeert een antwoord.

​

Beveiliging

• Commit privésleutels nooit.
• Gebruik omgevingsvariabelen voor sleutels.
• Overweeg allowlist voor productiebots.
• Handtekeningen worden vóór het afzenderbeleid geverifieerd en het afzenderbeleid wordt vóór ontsleuteling gehandhaafd, zodat vervalste events vroegtijdig 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-cadeauverpakking gepland).

​

Gerelateerd

• Overzicht van kanalen — alle ondersteunde kanalen
• Koppelen — DM-authenticatie en koppelingsflow
• Groepen — gedrag van groepschats en beperking op basis van vermeldingen
• Kanaalroutering — sessieroutering voor berichten
• Beveiliging — toegangsmodel en beveiliging aanscherpen