Nostr

Nostr adalah plugin saluran yang dapat diunduh (@openclaw/nostr) yang memungkinkan OpenClaw menerima dan menjawab pesan langsung terenkripsi NIP-04 melalui relai Nostr. Satu akun per Gateway; hanya pesan langsung.

Instalasi

openclaw plugins install @openclaw/nostr

Gunakan spesifikasi paket tanpa versi untuk mengikuti tag rilis resmi saat ini. Sematkan versi persis hanya jika Anda memerlukan instalasi yang dapat direproduksi.

Dari checkout lokal (alur kerja pengembangan):

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

Mulai ulang Gateway setelah memasang atau mengaktifkan plugin. Orientasi awal (openclaw onboard) dan openclaw channels add menampilkan Nostr dari katalog saluran bersama setelah plugin dipasang.

Penyiapan noninteraktif

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 lingkungan alih-alih menyimpan kunci dalam konfigurasi (hanya akun bawaan).

Penyiapan cepat

1. Buat pasangan kunci Nostr (jika diperlukan):

# Menggunakan naknak key generate

2. Tambahkan ke konfigurasi:

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

3. Ekspor kunci:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Mulai ulang Gateway.

Referensi konfigurasi

Metadata profil

Data profil dipublikasikan sebagai peristiwa NIP-01 kind:0. Anda dapat mengelolanya dari UI Kontrol (Channels -> Nostr -> Profile) atau mengaturnya langsung dalam konfigurasi.

Contoh:

{  channels: {    nostr: {      privateKey: "${NOSTR_PRIVATE_KEY}",      profile: {        name: "openclaw",        displayName: "OpenClaw",        about: "Bot pesan langsung asisten pribadi",        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://.
• Pengimporan dari relai menggabungkan bidang dan mempertahankan penggantian lokal.

Kontrol akses

Kebijakan pesan langsung

• pairing (bawaan): pengirim yang tidak dikenal mendapatkan kode pemasangan.
• allowlist: hanya kunci publik dalam allowFrom yang dapat mengirim pesan langsung.
• open: pesan langsung masuk terbuka untuk publik (memerlukan allowFrom: ["*"]).
• disabled: abaikan pesan langsung masuk.

Catatan penegakan:

• Tanda tangan peristiwa masuk diverifikasi sebelum kebijakan pengirim dan dekripsi NIP-04, sehingga peristiwa palsu ditolak sejak awal.
• Balasan pemasangan dikirim tanpa mendekripsi atau memproses isi pesan langsung asli.
• Pesan langsung masuk dibatasi lajunya (secara global dan per pengirim), dan muatan yang terlalu besar dibuang sebelum dekripsi.

Contoh daftar izin

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

Format kunci

Format yang diterima:

• Kunci privat: nsec... atau hex 64 karakter
• Kunci publik (allowFrom): npub... atau hex

Relai

Bawaan: relay.damus.io dan nos.lol.

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

Kiat:

• Gunakan 2–3 relai untuk redundansi.
• Hindari terlalu banyak relai (latensi, duplikasi).
• Relai berbayar dapat meningkatkan keandalan.
• Relai lokal cocok untuk pengujian (ws://localhost:7777).

Dukungan protokol

Pengujian

Relai lokal

# Jalankan strfrydocker run -p 7777:7777 ghcr.io/hoytech/strfry

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

Pengujian manual

1. Catat kunci publik bot dari log Gateway atau openclaw channels status (hex; konversikan ke npub di klien Anda jika diperlukan).
2. Buka klien Nostr (Amethyst, Damus, dan sebagainya).
3. Kirim pesan langsung ke kunci publik bot.
4. Verifikasi responsnya.

Pemecahan masalah

Tidak menerima pesan

• Verifikasi bahwa kunci privat valid.
• Pastikan URL relai dapat dijangkau dan menggunakan wss:// (atau ws:// untuk lokal).
• Pastikan enabled bukan false.
• Periksa log Gateway untuk menemukan kesalahan koneksi relai.

Tidak mengirim respons

• Periksa apakah relai menerima penulisan.
• Verifikasi konektivitas keluar.
• Waspadai batas laju relai.

Respons duplikat

• Hal ini wajar saat menggunakan beberapa relai.
• Pesan dideduplikasi berdasarkan ID peristiwa; hanya pengiriman pertama yang memicu respons.

Keamanan

• Jangan pernah memasukkan kunci privat ke dalam commit.
• Gunakan variabel lingkungan untuk kunci.
• Pertimbangkan allowlist untuk bot produksi.
• Tanda tangan diverifikasi sebelum kebijakan pengirim, dan kebijakan pengirim diberlakukan sebelum dekripsi, sehingga peristiwa palsu ditolak sejak awal dan pengirim yang tidak dikenal tidak dapat memaksa pemrosesan kriptografi penuh.

Keterbatasan (MVP)

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

Terkait

• Ikhtisar Saluran — semua saluran yang didukung
• Pemasangan — autentikasi pesan langsung dan alur pemasangan
• Grup — perilaku obrolan grup dan pembatasan berdasarkan sebutan
• Perutean Saluran — perutean sesi untuk pesan
• Keamanan — model akses dan penguatan