Langsung ke konten utama

​
Nostr

Status: Plugin bawaan opsional (dinonaktifkan secara default sampai dikonfigurasi). Nostr adalah protokol terdesentralisasi untuk jejaring sosial. Channel ini memungkinkan OpenClaw menerima dan merespons pesan langsung terenkripsi (DM) melalui NIP-04.

​
Plugin bawaan

Rilis OpenClaw saat ini mengirimkan Nostr sebagai plugin bawaan, jadi build paket normal tidak memerlukan instalasi terpisah.

​
Instalasi lama/kustom

  • Onboarding (openclaw onboard) dan openclaw channels add tetap menampilkan Nostr dari katalog channel bersama.
  • Jika build Anda tidak menyertakan Nostr bawaan, instal secara manual.
openclaw plugins install @openclaw/nostr
Gunakan checkout lokal (workflow dev): 
openclaw plugins install --link <path-to-local-nostr-plugin>
Restart Gateway setelah menginstal atau mengaktifkan plugin.

​
Setup non-interaktif

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"
Gunakan --use-env agar NOSTR_PRIVATE_KEY tetap berada di environment alih-alih menyimpan key di config.

​
Setup cepat

  1. Buat keypair Nostr (jika perlu):
# Using nak
nak key generate
  1. Tambahkan ke config:
{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
    },
  },
}
  1. Ekspor key:
export NOSTR_PRIVATE_KEY="nsec1..."
  1. Restart Gateway.

​
Referensi konfigurasi

KeyTipeDefaultDeskripsi
privateKeystringwajibPrivate key dalam format nsec atau hex
relaysstring[]['wss://relay.damus.io', 'wss://nos.lol']URL relay (WebSocket)
dmPolicystringpairingKebijakan akses DM
allowFromstring[][]Pubkey pengirim yang diizinkan
enabledbooleantrueAktifkan/nonaktifkan channel
namestring-Nama tampilan
profileobject-Metadata profil NIP-01

​
Metadata profil

Data profil dipublikasikan sebagai peristiwa NIP-01 kind:0. Anda dapat mengelolanya dari UI Control (Channels -> Nostr -> Profile) atau menyetelnya langsung di config. Contoh: 
{
  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",
      },
    },
  },
}
Catatan:
  • URL profil harus menggunakan https://.
  • Mengimpor dari relay akan menggabungkan field dan mempertahankan override lokal.

​
Kontrol akses

​
Kebijakan DM

  • pairing (default): pengirim yang tidak dikenal mendapatkan kode pairing.
  • allowlist: hanya pubkey dalam allowFrom yang dapat mengirim DM.
  • open: DM masuk publik (memerlukan allowFrom: ["*"]).
  • disabled: abaikan DM masuk.
Catatan penegakan:
  • Tanda tangan peristiwa masuk diverifikasi sebelum kebijakan pengirim dan dekripsi NIP-04, sehingga peristiwa palsu ditolak lebih awal.
  • Balasan pairing dikirim tanpa memproses isi DM asli.
  • DM masuk dibatasi lajunya dan payload yang terlalu besar dibuang sebelum dekripsi.

​
Contoh allowlist

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

​
Format key

Format yang diterima:
  • Private key: nsec... atau hex 64 karakter
  • Pubkey (allowFrom): npub... atau hex

​
Relay

Default: relay.damus.io dan nos.lol. 
{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      relays: ["wss://relay.damus.io", "wss://relay.primal.net", "wss://nostr.wine"],
    },
  },
}
Tips:
  • Gunakan 2-3 relay untuk redundansi.
  • Hindari terlalu banyak relay (latensi, duplikasi).
  • Relay berbayar dapat meningkatkan keandalan.
  • Relay lokal cocok untuk pengujian (ws://localhost:7777).

​
Dukungan protokol

NIPStatusDeskripsi
NIP-01DidukungFormat peristiwa dasar + metadata profil
NIP-04DidukungDM terenkripsi (kind:4)
NIP-17DirencanakanDM gift-wrapped
NIP-44DirencanakanEnkripsi berversi

​
Pengujian

​
Relay lokal

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

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

​
Pengujian manual

  1. Catat pubkey bot (npub) dari log.
  2. Buka klien Nostr (Damus, Amethyst, dll.).
  3. Kirim DM ke pubkey bot.
  4. Verifikasi responsnya.

​
Pemecahan masalah

​
Tidak menerima pesan

  • Verifikasi bahwa private key valid.
  • Pastikan URL relay dapat dijangkau dan menggunakan wss:// (atau ws:// untuk lokal).
  • Konfirmasi enabled bukan false.
  • Periksa log Gateway untuk error koneksi relay.

​
Tidak mengirim respons

  • Periksa apakah relay menerima penulisan.
  • Verifikasi konektivitas keluar.
  • Perhatikan rate limit relay.

​
Respons duplikat

  • Ini normal saat menggunakan beberapa relay.
  • Pesan dideduplikasi berdasarkan ID peristiwa; hanya pengiriman pertama yang memicu respons.

​
Keamanan

  • Jangan pernah meng-commit private key.
  • Gunakan variabel environment untuk key.
  • Pertimbangkan allowlist untuk bot produksi.
  • Tanda tangan diverifikasi sebelum kebijakan pengirim, dan kebijakan pengirim diberlakukan sebelum dekripsi, sehingga peristiwa palsu ditolak lebih awal dan pengirim yang tidak dikenal tidak dapat memaksa kerja kripto penuh.

​
Keterbatasan (MVP)

  • Hanya pesan langsung (tanpa obrolan grup).
  • Tidak ada lampiran media.
  • Hanya NIP-04 (gift-wrap NIP-17 direncanakan).

​
Terkait