OpenClaw Nostr Kanal

Im Gegensatz zu zentralisierten Messaging-Plattformen ist Nostr ein dezentrales Protokoll, bei dem Nachrichten über unabhängige Relay-Server verteilt werden. OpenClaw verbindet sich über WebSocket mit einem oder mehreren Relays und abonniert NIP-04-verschlüsselte Direktnachrichten, die an den öffentlichen Schlüssel des Bots adressiert sind. Der Nachrichtenfluss ist unkompliziert: 1. Ein Benutzer sendet eine verschlüsselte DM von einem beliebigen Nostr-Client (Damus, Amethyst, Primal usw.) 2. Die Nachricht wird an die Relays verbreitet, an die der Benutzer veröffentlicht 3. Das Relay-Abonnement von OpenClaw erfasst das Ereignis 4. Das Gateway entschlüsselt die Nachricht, verarbeitet sie durch Ihren KI-Agenten, verschlüsselt die Antwort und veröffentlicht sie über die konfigurierten Relays zurück Da Nostr relay-basiert ist, gibt es keinen einzelnen Ausfallpunkt — wenn ein Relay ausfällt, können Nachrichten weiterhin über andere fließen. Der Bot und seine Benutzer müssen nicht exakt dieselben Relays verwenden, da Relays häufig Ereignisse untereinander austauschen.

Der Nostr-Kanal wird als optionales OpenClaw-Plugin ausgeliefert und ist nicht in das Kern-Gateway integriert. Dies hält die Basisinstallation schlank und ermöglicht es Ihnen, Nostr-Unterstützung bei Bedarf hinzuzufügen. Es gibt mehrere Installationsmethoden: • **npm (empfohlen):** Führen Sie 'openclaw plugins install @openclaw/nostr' aus, um die stabile Version zu installieren. • **Beta-Kanal:** Verwenden Sie 'openclaw plugins install @openclaw/nostr@beta' für Vorabversionen mit neuen Funktionen. • **Lokale Entwicklung:** Klonen Sie das Plugin-Repository und verwenden Sie 'openclaw plugins install --link /path/to/local/checkout', um es zu verlinken. • **Interaktive Einrichtung:** Führen Sie 'openclaw onboard' oder 'openclaw channels add' aus und wählen Sie Nostr aus der Liste. Nach der Installation starten Sie das Gateway neu, damit das Plugin wirksam wird.

Die Nostr-Identität basiert auf Public-Key-Kryptografie. Die Identität Ihres Bots ist sein Schlüsselpaar — ein privater Schlüssel (nsec), der zum Signieren und Entschlüsseln verwendet wird, und ein öffentlicher Schlüssel (npub), der als Adresse dient. Generieren Sie ein Schlüsselpaar mit dem 'nak'-CLI-Tool: 1. nak installieren: 'go install github.com/fiatjaf/nak@latest' (oder von den Releases herunterladen) 2. Generieren: 'nak key generate' — dies gibt den privaten Schlüssel im Hex-Format aus 3. Öffentlichen Schlüssel ableiten: 'nak key public <hex-private-key>' — bei Bedarf in npub konvertieren OpenClaw akzeptiert private Schlüssel sowohl im nsec-Format (Bech32-kodiert) als auch im 64-Zeichen-Hex-Format. Öffentliche Schlüssel in allowFrom können im npub- oder Hex-Format angegeben werden.

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

Relays sind das Rückgrat von Nostr — sie speichern und verteilen Ereignisse. OpenClaw verbindet sich über WebSocket mit Ihren konfigurierten Relays, um verschlüsselte DMs zu senden und zu empfangen. Die Standardkonfiguration verwendet zwei bekannte öffentliche Relays: relay.damus.io und nos.lol. Für den Produktionseinsatz sollten Sie dies an Ihre Bedürfnisse anpassen. Tipps zur Relay-Auswahl: • Verwenden Sie 2–3 Relays für eine gute Balance zwischen Redundanz und Leistung • Zu viele Relays erhöhen Latenz und Bandbreitenverbrauch • Kostenpflichtige Relays (z.B. relay.nostr.band) bieten bessere Zuverlässigkeit und weniger Spam • Für die Entwicklung können Sie einen lokalen Relay betreiben (z.B. Strfry via Docker) auf ws://localhost:7777

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

DM-Richtlinien (Direct Message) steuern, wer über Nostr mit Ihrem KI-Assistenten interagieren kann. Da Nostr von Natur aus offen ist, ist die Zugriffskontrolle besonders wichtig, um eine unbefugte Nutzung Ihres KI-Kontingents zu verhindern. OpenClaw unterstützt vier Richtlinien: • **pairing (Standard)** — Unbekannte Absender erhalten einen Pairing-Code. Sie genehmigen oder lehnen diese über 'openclaw pairing approve nostr <code>' ab. Nach der Genehmigung können sie frei chatten. • **allowlist** — Nur öffentliche Schlüssel (npub oder Hex), die in allowFrom aufgelistet sind, können dem Bot Nachrichten senden. Alle anderen werden stillschweigend ignoriert. • **open** — Jeder kann dem Bot Nachrichten senden. Erfordert allowFrom: ["*"] zur Aktivierung. Mit Vorsicht verwenden. • **disabled** — Der Bot antwortet auf keine eingehenden DMs.

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

Sie können ein Profil für Ihren Bot im Nostr-Netzwerk veröffentlichen, indem Sie NIP-01 kind:0 Metadaten-Ereignisse verwenden. Dadurch wird Ihr Bot in Nostr-Clients auffindbar — Benutzer sehen seinen Namen, Avatar, seine Biografie und weitere Details, wenn sie den npub des Bots nachschlagen. Konfigurierbare Profilfelder umfassen: • **name** — Kurzer Benutzername (z.B. "openclaw-bot") • **display_name** — Vollständiger Anzeigename • **about** — Biografie / Beschreibung • **picture** — Avatar-URL (HTTPS erforderlich) • **banner** — Banner-Bild-URL (HTTPS erforderlich) • **website** — Bot- oder Projekt-Website • **nip05** — NIP-05-Verifizierungskennung (z.B. "bot@yourdomain.com") • **lud16** — Lightning-Adresse für 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"
      }
    }
  }
}

Alle Direktnachrichten in der Nostr-Integration von OpenClaw verwenden NIP-04-Verschlüsselung — Nachrichten werden mit einem gemeinsamen Geheimnis verschlüsselt, das aus den Schlüsselpaaren von Absender und Empfänger mittels ECDH (Elliptic Curve Diffie-Hellman) abgeleitet wird. Derzeit unterstützte NIPs: • **NIP-01** — Basisprotokoll: Ereignisse, Abonnements, Metadaten (kind:0) • **NIP-04** — Verschlüsselte Direktnachrichten (kind:4) Geplante zukünftige Unterstützung: • **NIP-17** — Gift-wrapped private Nachrichten (verbesserter Metadatenschutz) • **NIP-44** — Versionierte Verschlüsselung (stärkere kryptografische Primitive) Während NIP-04 von allen Nostr-Clients weitgehend unterstützt wird, weist es bekannte Metadaten-Lecks auf (Relay-Betreiber können sehen, wer mit wem kommuniziert, jedoch nicht den Inhalt). NIP-17 und NIP-44 werden diese Einschränkungen beheben, sobald sie allgemein übernommen werden.

Für Entwicklung und Tests können Sie einen lokalen Nostr-Relay betreiben, anstatt sich mit öffentlichen Relays zu verbinden. Der empfohlene Ansatz verwendet Strfry, einen leistungsstarken Relay, der einfach über Docker betrieben werden kann. Einrichtungsschritte: 1. Relay starten: 'docker run -p 7777:7777 hoytech/strfry' 2. OpenClaw für den lokalen Relay konfigurieren: ws://localhost:7777 3. Gateway starten 4. Einen Nostr-Client verwenden, der mit Ihrem lokalen Relay verbunden ist, um Test-DMs zu senden Dies isoliert Ihre Tests vom öffentlichen Nostr-Netzwerk und ermöglicht schnellere Iterationszyklen.

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