Nostr

​

Installazione

openclaw plugins install @openclaw/nostr

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

​

Configurazione non interattiva

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"

​

Configurazione rapida

1. Genera una coppia di chiavi Nostr (se necessario):

# Utilizzando nak
nak key generate

2. Aggiungila alla configurazione:

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

3. Esporta la chiave:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Riavvia il Gateway.

​

Riferimento della configurazione

​

Metadati del profilo

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      profile: {
        name: "openclaw",
        displayName: "OpenClaw",
        about: "Bot assistente personale per messaggi diretti",
        picture: "https://example.com/avatar.png",
        banner: "https://example.com/banner.png",
        website: "https://example.com",
        nip05: "openclaw@example.com",
        lud16: "openclaw@example.com",
      },
    },
  },
}

• Gli URL del profilo devono usare https://.
• L’importazione dai relay unisce i campi e mantiene le sostituzioni locali.

​

Controllo degli accessi

​

Criteri per i messaggi diretti

• pairing (predefinito): i mittenti sconosciuti ricevono un codice di associazione.
• allowlist: solo le chiavi pubbliche in allowFrom possono inviare messaggi diretti.
• open: messaggi diretti pubblici in entrata (richiede allowFrom: ["*"]).
• disabled: ignora i messaggi diretti in entrata.

• Le firme degli eventi in entrata vengono verificate prima del criterio relativo al mittente e della decrittografia NIP-04, pertanto gli eventi contraffatti vengono rifiutati in anticipo.
• Le risposte di associazione vengono inviate senza decrittografare né elaborare il corpo del messaggio diretto originale.
• I messaggi diretti in entrata sono soggetti a limiti di frequenza (globalmente e per mittente) e i payload di dimensioni eccessive vengono scartati prima della decrittografia.

​

Esempio di elenco consentiti

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

​

Formati delle chiavi

• Chiave privata: nsec... o formato esadecimale di 64 caratteri
• Chiavi pubbliche (allowFrom): npub... o formato esadecimale

​

Relay

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

• Usa 2-3 relay per garantire ridondanza.
• Evita un numero eccessivo di relay (latenza, duplicazione).
• I relay a pagamento possono migliorare l’affidabilità.
• I relay locali sono adatti per i test (ws://localhost:7777).

​

Supporto del protocollo

​

Test

​

Relay locale

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

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

​

Test manuale

1. Prendi nota della chiave pubblica del bot dai log del Gateway o da openclaw channels status (formato esadecimale; convertila in npub nel tuo client, se necessario).
2. Apri un client Nostr (Amethyst, Damus, ecc.).
3. Invia un messaggio diretto alla chiave pubblica del bot.
4. Verifica la risposta.

​

Risoluzione dei problemi

​

Mancata ricezione dei messaggi

• Verifica che la chiave privata sia valida.
• Assicurati che gli URL dei relay siano raggiungibili e usino wss:// (o ws:// per quelli locali).
• Verifica che enabled non sia false.
• Controlla nei log del Gateway la presenza di errori di connessione ai relay.

​

Mancato invio delle risposte

• Verifica che il relay accetti le scritture.
• Verifica la connettività in uscita.
• Controlla eventuali limiti di frequenza imposti dal relay.

​

Risposte duplicate

• È un comportamento previsto quando si utilizzano più relay.
• I messaggi vengono deduplicati in base all’ID evento; solo la prima consegna attiva una risposta.

​

Sicurezza

• Non eseguire mai il commit delle chiavi private.
• Usa variabili d’ambiente per le chiavi.
• Valuta l’uso di allowlist per i bot in produzione.
• Le firme vengono verificate prima del criterio relativo al mittente e tale criterio viene applicato prima della decrittografia, pertanto gli eventi contraffatti vengono rifiutati in anticipo e i mittenti sconosciuti non possono imporre l’esecuzione dell’intera elaborazione crittografica.

​

Limitazioni (MVP)

• Solo messaggi diretti (nessuna chat di gruppo).
• Nessun allegato multimediale.
• Solo NIP-04 (è pianificato il supporto per le buste crittografiche NIP-17).

​

Contenuti correlati

• Panoramica dei canali — tutti i canali supportati
• Associazione — autenticazione dei messaggi diretti e flusso di associazione
• Gruppi — comportamento delle chat di gruppo e controllo tramite menzioni
• Instradamento dei canali — instradamento delle sessioni per i messaggi
• Sicurezza — modello di accesso e rafforzamento della sicurezza