Nostr

​

Instalacja

openclaw plugins install @openclaw/nostr

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

​

Konfiguracja nieinteraktywna

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"

​

Szybka konfiguracja

1. Wygeneruj parę kluczy Nostr (jeśli jest potrzebna):

# Przy użyciu nak
nak key generate

2. Dodaj do konfiguracji:

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

3. Wyeksportuj klucz:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Uruchom ponownie Gateway.

​

Dokumentacja konfiguracji

​

Metadane profilu

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      profile: {
        name: "openclaw",
        displayName: "OpenClaw",
        about: "Bot wiadomości bezpośrednich pełniący funkcję osobistego asystenta",
        picture: "https://example.com/avatar.png",
        banner: "https://example.com/banner.png",
        website: "https://example.com",
        nip05: "openclaw@example.com",
        lud16: "openclaw@example.com",
      },
    },
  },
}

• Adresy URL profilu muszą używać protokołu https://.
• Importowanie z przekaźników scala pola i zachowuje lokalne nadpisania.

​

Kontrola dostępu

​

Zasady wiadomości bezpośrednich

• pairing (domyślnie): nieznani nadawcy otrzymują kod parowania.
• allowlist: wiadomości bezpośrednie mogą wysyłać tylko klucze publiczne wymienione w allowFrom.
• open: publicznie dostępne przychodzące wiadomości bezpośrednie (wymaga allowFrom: ["*"]).
• disabled: ignorowanie przychodzących wiadomości bezpośrednich.

• Podpisy zdarzeń przychodzących są weryfikowane przed zastosowaniem zasad nadawcy i odszyfrowaniem NIP-04, dlatego sfałszowane zdarzenia są wcześnie odrzucane.
• Odpowiedzi dotyczące parowania są wysyłane bez odszyfrowywania ani przetwarzania treści pierwotnej wiadomości bezpośredniej.
• Przychodzące wiadomości bezpośrednie podlegają ograniczeniom częstotliwości (globalnie i dla każdego nadawcy), a zbyt duże ładunki są odrzucane przed odszyfrowaniem.

​

Przykład listy dozwolonych

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

​

Formaty kluczy

• Klucz prywatny: nsec... lub 64-znakowy zapis szesnastkowy
• Klucze publiczne (allowFrom): npub... lub zapis szesnastkowy

​

Przekaźniki

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

• Używaj 2–3 przekaźników, aby zapewnić nadmiarowość.
• Unikaj zbyt wielu przekaźników (opóźnienia, duplikowanie).
• Płatne przekaźniki mogą zwiększyć niezawodność.
• Lokalne przekaźniki dobrze nadają się do testowania (ws://localhost:7777).

​

Obsługa protokołów

​

Testowanie

​

Lokalny przekaźnik

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

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

​

Test ręczny

1. Zanotuj klucz publiczny bota z dzienników Gateway lub polecenia openclaw channels status (zapis szesnastkowy; w razie potrzeby przekonwertuj go na npub w swoim kliencie).
2. Otwórz klienta Nostr (Amethyst, Damus itp.).
3. Wyślij wiadomość bezpośrednią na klucz publiczny bota.
4. Sprawdź odpowiedź.

​

Rozwiązywanie problemów

​

Brak odbieranych wiadomości

• Sprawdź, czy klucz prywatny jest prawidłowy.
• Upewnij się, że adresy URL przekaźników są osiągalne i używają protokołu wss:// (lub ws:// lokalnie).
• Potwierdź, że enabled nie ma wartości false.
• Sprawdź dzienniki Gateway pod kątem błędów połączenia z przekaźnikami.

​

Brak wysyłanych odpowiedzi

• Sprawdź, czy przekaźnik akceptuje zapisy.
• Sprawdź łączność wychodzącą.
• Zwróć uwagę na ograniczenia częstotliwości przekaźnika.

​

Zduplikowane odpowiedzi

• Jest to oczekiwane podczas korzystania z wielu przekaźników.
• Wiadomości są deduplikowane według identyfikatora zdarzenia; tylko pierwsze dostarczenie wywołuje odpowiedź.

​

Bezpieczeństwo

• Nigdy nie zatwierdzaj kluczy prywatnych w repozytorium.
• Używaj zmiennych środowiskowych do przechowywania kluczy.
• Rozważ użycie allowlist dla botów produkcyjnych.
• Podpisy są weryfikowane przed zastosowaniem zasad nadawcy, a zasady nadawcy są egzekwowane przed odszyfrowaniem, dlatego sfałszowane zdarzenia są wcześnie odrzucane, a nieznani nadawcy nie mogą wymusić wykonania pełnych operacji kryptograficznych.

​

Ograniczenia (MVP)

• Tylko wiadomości bezpośrednie (bez czatów grupowych).
• Brak załączników multimedialnych.
• Tylko NIP-04 (planowana obsługa opakowania prezentowego NIP-17).

​

Powiązane materiały

• Przegląd kanałów — wszystkie obsługiwane kanały
• Parowanie — uwierzytelnianie wiadomości bezpośrednich i przebieg parowania
• Grupy — działanie czatów grupowych i ograniczanie na podstawie wzmianek
• Trasowanie kanałów — trasowanie sesji dla wiadomości
• Bezpieczeństwo — model dostępu i wzmacnianie zabezpieczeń