Nostr

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Gebündeltes Plugin

​

Ältere/benutzerdefinierte Installationen

• Onboarding (openclaw onboard) und openclaw channels add zeigen Nostr weiterhin aus dem gemeinsamen Kanalkatalog an.
• Wenn Ihr Build gebündeltes Nostr ausschließt, installieren Sie das npm-Paket direkt.

openclaw plugins install @openclaw/nostr

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

​

Nicht interaktive Einrichtung

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"

​

Schnelle Einrichtung

1. Generieren Sie bei Bedarf ein Nostr-Schlüsselpaar:

# Using nak
nak key generate

2. Zur Konfiguration hinzufügen:

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

3. Exportieren Sie den Schlüssel:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Starten Sie den Gateway neu.

​

Konfigurationsreferenz

​

Profilmetadaten

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

• Profil-URLs müssen https:// verwenden.
• Beim Importieren von Relays werden Felder zusammengeführt und lokale Überschreibungen beibehalten.

​

Zugriffskontrolle

​

DM-Richtlinien

• pairing (Standard): Unbekannte Sender erhalten einen Pairing-Code.
• allowlist: Nur pubkeys in allowFrom können DMs senden.
• open: Öffentliche eingehende DMs (erfordert allowFrom: ["*"]).
• disabled: Eingehende DMs ignorieren.

• Signaturen eingehender Events werden vor der Senderrichtlinie und NIP-04-Entschlüsselung geprüft, sodass gefälschte Events früh abgelehnt werden.
• Pairing-Antworten werden gesendet, ohne den ursprünglichen DM-Text zu verarbeiten.
• Eingehende DMs werden ratenbegrenzt, und übergroße Payloads werden vor der Entschlüsselung verworfen.

​

Allowlist-Beispiel

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

​

Schlüsselformate

• Privater Schlüssel: nsec... oder 64-Zeichen-Hex
• Pubkeys (allowFrom): npub... oder Hex

​

Relays

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

• Verwenden Sie 2-3 Relays für Redundanz.
• Vermeiden Sie zu viele Relays (Latenz, Duplikate).
• Bezahlte Relays können die Zuverlässigkeit verbessern.
• Lokale Relays eignen sich gut zum Testen (ws://localhost:7777).

​

Protokollunterstützung

​

Testen

​

Lokales Relay

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

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

​

Manueller Test

1. Notieren Sie den Bot-pubkey (npub) aus den Logs.
2. Öffnen Sie einen Nostr-Client (Damus, Amethyst usw.).
3. Senden Sie dem Bot-pubkey eine DM.
4. Prüfen Sie die Antwort.

​

Fehlerbehebung

​

Nachrichten werden nicht empfangen

• Prüfen Sie, ob der private Schlüssel gültig ist.
• Stellen Sie sicher, dass Relay-URLs erreichbar sind und wss:// verwenden (oder ws:// für lokale Relays).
• Bestätigen Sie, dass enabled nicht false ist.
• Prüfen Sie die Gateway-Logs auf Relay-Verbindungsfehler.

​

Antworten werden nicht gesendet

• Prüfen Sie, ob das Relay Schreibvorgänge akzeptiert.
• Prüfen Sie die ausgehende Konnektivität.
• Achten Sie auf Relay-Rate-Limits.

​

Doppelte Antworten

• Erwartet, wenn mehrere Relays verwendet werden.
• Nachrichten werden anhand der Event-ID dedupliziert; nur die erste Zustellung löst eine Antwort aus.

​

Sicherheit

• Committen Sie niemals private Schlüssel.
• Verwenden Sie Umgebungsvariablen für Schlüssel.
• Ziehen Sie allowlist für Produktions-Bots in Betracht.
• Signaturen werden vor der Senderrichtlinie geprüft, und die Senderrichtlinie wird vor der Entschlüsselung durchgesetzt, sodass gefälschte Events früh abgelehnt werden und unbekannte Sender keine vollständige Kryptografiearbeit erzwingen können.

​

Einschränkungen (MVP)

• Nur Direktnachrichten (keine Gruppenchats).
• Keine Medienanhänge.
• Nur NIP-04 (NIP-17-Gift-Wrap geplant).

​

Verwandte Themen

• Kanalübersicht — alle unterstützten Kanäle
• Pairing — DM-Authentifizierung und Pairing-Ablauf
• Gruppen — Gruppenchateverhalten und Erwähnungs-Gating
• Kanal-Routing — Sitzungs-Routing für Nachrichten
• Sicherheit — Zugriffsmodell und Härtung