​

Nostr

​

Plugin groupé

​

Installations anciennes/personnalisées

• L’onboarding (openclaw onboard) et openclaw channels add affichent toujours Nostr à partir du catalogue de canaux partagé.
• Si votre build exclut le plugin groupé Nostr, installez-le manuellement.

openclaw plugins install @openclaw/nostr

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

​

Configuration non interactive

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"

​

Configuration rapide

1. Générez une paire de clés Nostr (si nécessaire) :

# Using nak
nak key generate

2. Ajoutez-la à la configuration :

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

3. Exportez la clé :

export NOSTR_PRIVATE_KEY="nsec1..."

4. Redémarrez la passerelle.

​

Référence de configuration

​

Métadonnées de profil

{
  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",
      },
    },
  },
}

• Les URL de profil doivent utiliser https://.
• L’importation depuis les relais fusionne les champs et préserve les remplacements locaux.

​

Contrôle d’accès

​

Politiques DM

• pairing (par défaut) : les expéditeurs inconnus reçoivent un code de pairage.
• allowlist : seules les clés publiques dans allowFrom peuvent envoyer des DMs.
• open : DMs publics entrants (nécessite allowFrom: ["*"]).
• disabled : ignore les DMs entrants.

• Les signatures des événements entrants sont vérifiées avant la politique d’expéditeur et le déchiffrement NIP-04, donc les événements falsifiés sont rejetés tôt.
• Les réponses de pairage sont envoyées sans traiter le corps du DM d’origine.
• Les DMs entrants sont limités en débit et les charges utiles surdimensionnées sont abandonnées avant le déchiffrement.

​

Exemple de liste d’autorisation

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

​

Formats de clé

• Clé privée : nsec... ou hexadécimal de 64 caractères
• Clés publiques (allowFrom) : npub... ou hexadécimal

​

Relais

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

• Utilisez 2 à 3 relais pour la redondance.
• Évitez d’utiliser trop de relais (latence, duplication).
• Les relais payants peuvent améliorer la fiabilité.
• Les relais locaux conviennent pour les tests (ws://localhost:7777).

​

Prise en charge du protocole

​

Tests

​

Relais local

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

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

​

Test manuel

1. Notez la clé publique du bot (npub) dans les journaux.
2. Ouvrez un client Nostr (Damus, Amethyst, etc.).
3. Envoyez un DM à la clé publique du bot.
4. Vérifiez la réponse.

​

Dépannage

​

Ne reçoit pas de messages

• Vérifiez que la clé privée est valide.
• Assurez-vous que les URL des relais sont accessibles et utilisent wss:// (ou ws:// en local).
• Confirmez que enabled n’est pas défini sur false.
• Vérifiez les journaux de la passerelle pour les erreurs de connexion aux relais.

​

N’envoie pas de réponses

• Vérifiez que le relais accepte les écritures.
• Vérifiez la connectivité sortante.
• Surveillez les limites de débit des relais.

​

Réponses en double

• Attendu lors de l’utilisation de plusieurs relais.
• Les messages sont dédupliqués par ID d’événement ; seule la première livraison déclenche une réponse.

​

Sécurité

• Ne validez jamais de clés privées dans le dépôt.
• Utilisez des variables d’environnement pour les clés.
• Envisagez allowlist pour les bots de production.
• Les signatures sont vérifiées avant la politique d’expéditeur, et la politique d’expéditeur est appliquée avant le déchiffrement, donc les événements falsifiés sont rejetés tôt et les expéditeurs inconnus ne peuvent pas forcer un travail cryptographique complet.

​

Limitations (MVP)

• Messages directs uniquement (pas de discussions de groupe).
• Pas de pièces jointes multimédias.
• NIP-04 uniquement (enveloppe-cadeau NIP-17 prévue).

​

Lié

• Vue d’ensemble des canaux — tous les canaux pris en charge
• Pairing — flux d’authentification et de pairage des DMs
• Groups — comportement des discussions de groupe et contrôle par mention
• Channel Routing — routage des sessions pour les messages
• Security — modèle d’accès et durcissement