Canal Nostr OpenClaw

Contrairement aux plateformes de messagerie centralisées, Nostr est un protocole décentralisé où les messages sont distribués via des serveurs relay indépendants. OpenClaw se connecte à un ou plusieurs relays via WebSocket et s'abonne aux messages directs chiffrés NIP-04 adressés à la clé publique du bot. Le flux de messages est simple : 1. Un utilisateur envoie un DM chiffré depuis n'importe quel client Nostr (Damus, Amethyst, Primal, etc.) 2. Le message se propage vers les relays sur lesquels l'utilisateur publie 3. L'abonnement relay d'OpenClaw récupère l'événement 4. Le Gateway déchiffre le message, le traite via votre agent IA, chiffre la réponse et la publie sur les relays configurés Étant donné que Nostr repose sur des relays, il n'y a pas de point de défaillance unique — si un relay tombe en panne, les messages peuvent toujours transiter par les autres. Le bot et ses utilisateurs n'ont pas besoin d'utiliser exactement les mêmes relays, car les relays échangent souvent les événements entre eux.

Le canal Nostr est distribué en tant que plugin optionnel OpenClaw plutôt que d'être intégré directement dans le Gateway de base. Cela permet de garder l'installation de base légère tout en vous permettant d'ajouter la prise en charge de Nostr lorsque nécessaire. Plusieurs méthodes d'installation sont disponibles : • **npm (recommandé) :** Exécutez 'openclaw plugins install @openclaw/nostr' pour installer la version stable. • **Canal bêta :** Utilisez 'openclaw plugins install @openclaw/nostr@beta' pour les fonctionnalités en pré-version. • **Développement local :** Clonez le dépôt du plugin et utilisez 'openclaw plugins install --link /path/to/local/checkout' pour le lier. • **Configuration interactive :** Exécutez 'openclaw onboard' ou 'openclaw channels add' et sélectionnez Nostr dans la liste. Après l'installation, redémarrez le Gateway pour que le plugin prenne effet.

L'identité Nostr repose sur la cryptographie à clé publique. L'identité de votre bot est sa paire de clés — une clé privée (nsec) utilisée pour la signature et le déchiffrement, et une clé publique (npub) utilisée comme adresse. Générez une paire de clés à l'aide de l'outil CLI 'nak' : 1. Installez nak : 'go install github.com/fiatjaf/nak@latest' (ou téléchargez depuis les releases) 2. Générez : 'nak key generate' — cela affiche la clé privée au format hex 3. Dérivez la clé publique : 'nak key public <hex-private-key>' — convertissez en npub si nécessaire OpenClaw accepte les clés privées au format nsec (encodé Bech32) et au format hexadécimal de 64 caractères. Les clés publiques dans allowFrom peuvent utiliser le format npub ou hexadécimal.

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

Les relays sont l'épine dorsale de Nostr — ils stockent et distribuent les événements. OpenClaw se connecte à vos relays configurés via WebSocket pour envoyer et recevoir des DMs chiffrés. La configuration par défaut utilise deux relays publics bien connus : relay.damus.io et nos.lol. Pour une utilisation en production, vous devriez personnaliser cette configuration selon vos besoins. Conseils pour la sélection des relays : • Utilisez 2 à 3 relays pour un bon équilibre entre redondance et performance • Un trop grand nombre de relays augmente la latence et la consommation de bande passante • Les relays payants (par ex., relay.nostr.band) offrent une meilleure fiabilité et moins de spam • Pour le développement, exécutez un relay local (par ex., Strfry via Docker) sur ws://localhost:7777

{
  "channels": {
    "nostr": {
      "relays": [
        "wss://relay.damus.io",
        "wss://nos.lol",
        "wss://relay.nostr.band"
      ]
    }
  }
}

Les politiques de DM (Direct Message) contrôlent qui peut interagir avec votre assistant IA via Nostr. Étant donné que Nostr est ouvert par conception, le contrôle d'accès est particulièrement important pour empêcher l'utilisation non autorisée de votre quota IA. OpenClaw prend en charge quatre politiques : • **pairing (par défaut)** — Les expéditeurs inconnus reçoivent un code d'appairage. Vous les approuvez ou les refusez via 'openclaw pairing approve nostr <code>'. Une fois approuvés, ils peuvent discuter librement. • **allowlist** — Seules les clés publiques (npub ou hex) listées dans allowFrom peuvent envoyer des messages au bot. Tous les autres sont ignorés silencieusement. • **open** — Tout le monde peut envoyer des messages au bot. Nécessite allowFrom: ["*"] pour être activé. À utiliser avec précaution. • **disabled** — Le bot ne répond à aucun DM entrant.

{
  "channels": {
    "nostr": {
      "dmPolicy": "allowlist",
      "allowFrom": [
        "npub1abc...xyz",
        "npub1def...uvw"
      ]
    }
  }
}

Vous pouvez publier un profil pour votre bot sur le réseau Nostr en utilisant les événements de métadonnées kind:0 de NIP-01. Cela rend votre bot découvrable dans les clients Nostr — les utilisateurs verront son nom, son avatar, sa biographie et d'autres détails lorsqu'ils rechercheront la npub du bot. Les champs de profil configurables incluent : • **name** — Nom d'utilisateur court (par ex., "openclaw-bot") • **display_name** — Nom d'affichage complet • **about** — Biographie / description • **picture** — URL de l'avatar (HTTPS obligatoire) • **banner** — URL de l'image de bannière (HTTPS obligatoire) • **website** — Site web du bot ou du projet • **nip05** — Identifiant de vérification NIP-05 (par ex., "bot@yourdomain.com") • **lud16** — Adresse Lightning pour les zaps

{
  "channels": {
    "nostr": {
      "profile": {
        "name": "openclaw-bot",
        "display_name": "OpenClaw AI Assistant",
        "about": "AI-powered assistant on Nostr. DM me!",
        "picture": "https://example.com/bot-avatar.png",
        "nip05": "bot@yourdomain.com"
      }
    }
  }
}

Tous les messages directs dans l'intégration Nostr d'OpenClaw utilisent le chiffrement NIP-04 — les messages sont chiffrés avec un secret partagé dérivé des paires de clés de l'expéditeur et du destinataire via ECDH (Elliptic Curve Diffie-Hellman). NIPs actuellement pris en charge : • **NIP-01** — Protocole de base : événements, abonnements, métadonnées (kind:0) • **NIP-04** — Messages directs chiffrés (kind:4) Prise en charge future prévue : • **NIP-17** — Messages privés encapsulés (confidentialité améliorée des métadonnées) • **NIP-44** — Chiffrement versionné (primitives cryptographiques renforcées) Bien que NIP-04 soit largement pris en charge par tous les clients Nostr, il présente des fuites de métadonnées connues (les opérateurs de relay peuvent voir qui communique avec qui, mais pas le contenu). NIP-17 et NIP-44 combleront ces limitations une fois adoptés.

Pour le développement et les tests, vous pouvez exécuter un relay Nostr local au lieu de vous connecter aux relays publics. L'approche recommandée utilise Strfry, un relay haute performance qui s'exécute facilement via Docker. Étapes de configuration : 1. Exécutez le relay : 'docker run -p 7777:7777 hoytech/strfry' 2. Configurez OpenClaw pour utiliser le relay local : ws://localhost:7777 3. Démarrez le Gateway 4. Utilisez un client Nostr configuré pour se connecter à votre relay local afin d'envoyer des DMs de test Cela isole vos tests du réseau Nostr public et offre des cycles d'itération plus rapides.

{
  "channels": {
    "nostr": {
      "relays": ["ws://localhost:7777"],
      "dmPolicy": "open",
      "allowFrom": ["*"]
    }
  }
}