Nostr

​

Kurulum

openclaw plugins install @openclaw/nostr

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

​

Etkileşimsiz kurulum

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"

​

Hızlı kurulum

1. Bir Nostr anahtar çifti oluşturun (gerekirse):

# nak kullanarak
nak key generate

2. Yapılandırmaya ekleyin:

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

3. Anahtarı dışa aktarın:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Gateway’i yeniden başlatın.

​

Yapılandırma başvurusu

​

Profil meta verileri

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      profile: {
        name: "openclaw",
        displayName: "OpenClaw",
        about: "Kişisel asistan DM botu",
        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 URL’leri https:// kullanmalıdır.
• Aktarıcılardan içe aktarma, alanları birleştirir ve yerel geçersiz kılmaları korur.

​

Erişim denetimi

​

DM ilkeleri

• eşleştirme (varsayılan): bilinmeyen gönderenler bir eşleştirme kodu alır.
• izin listesi: yalnızca allowFrom içindeki açık anahtarlar DM gönderebilir.
• açık: herkese açık gelen DM’ler (allowFrom: ["*"] gerektirir).
• devre dışı: gelen DM’leri yok sayar.

• Gelen olay imzaları, gönderen ilkesi ve NIP-04 şifre çözme işleminden önce doğrulanır; böylece sahte olaylar erkenden reddedilir.
• Eşleştirme yanıtları, özgün DM gövdesinin şifresi çözülmeden veya gövde işlenmeden gönderilir.
• Gelen DM’lere hız sınırı uygulanır (genel olarak ve gönderen başına) ve aşırı büyük yükler şifre çözme işleminden önce bırakılır.

​

İzin listesi örneği

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

​

Anahtar biçimleri

• Özel anahtar: nsec... veya 64 karakterlik onaltılık değer
• Açık anahtarlar (allowFrom): npub... veya onaltılık değer

​

Aktarıcılar

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

• Yedeklilik için 2-3 aktarıcı kullanın.
• Çok fazla aktarıcı kullanmaktan kaçının (gecikme, yinelenme).
• Ücretli aktarıcılar güvenilirliği artırabilir.
• Yerel aktarıcılar test için uygundur (ws://localhost:7777).

​

Protokol desteği

​

Test

​

Yerel aktarıcı

# strfry'ı başlat
docker run -p 7777:7777 ghcr.io/hoytech/strfry

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

​

Manuel test

1. Botun açık anahtarını Gateway günlüklerinden veya openclaw channels status üzerinden not edin (onaltılık; gerekirse istemcinizde npub’a dönüştürün).
2. Bir Nostr istemcisi açın (Amethyst, Damus vb.).
3. Botun açık anahtarına DM gönderin.
4. Yanıtı doğrulayın.

​

Sorun giderme

​

Mesajlar alınmıyor

• Özel anahtarın geçerli olduğunu doğrulayın.
• Aktarıcı URL’lerine erişilebildiğinden ve wss:// (yerel için ws://) kullandıklarından emin olun.
• enabled değerinin false olmadığını doğrulayın.
• Aktarıcı bağlantı hataları için Gateway günlüklerini kontrol edin.

​

Yanıtlar gönderilmiyor

• Aktarıcının yazma işlemlerini kabul ettiğini kontrol edin.
• Giden bağlantıyı doğrulayın.
• Aktarıcı hız sınırlarını izleyin.

​

Yinelenen yanıtlar

• Birden fazla aktarıcı kullanılırken bu beklenen bir durumdur.
• Mesajların yinelenenleri olay kimliğine göre ayıklanır; yalnızca ilk teslimat bir yanıtı tetikler.

​

Güvenlik

• Özel anahtarları asla commit etmeyin.
• Anahtarlar için ortam değişkenlerini kullanın.
• Üretim botları için allowlist kullanmayı değerlendirin.
• İmzalar gönderen ilkesinden önce doğrulanır ve gönderen ilkesi şifre çözme işleminden önce uygulanır; böylece sahte olaylar erkenden reddedilir ve bilinmeyen gönderenler tüm kriptografik işlemlerin gerçekleştirilmesini zorlayamaz.

​

Sınırlamalar (MVP)

• Yalnızca doğrudan mesajlar (grup sohbeti yok).
• Medya eki yok.
• Yalnızca NIP-04 (NIP-17 hediye paketiyle sarmalama planlanıyor).

​

İlgili

• Kanallara Genel Bakış — desteklenen tüm kanallar
• Eşleştirme — DM kimlik doğrulaması ve eşleştirme akışı
• Gruplar — grup sohbeti davranışı ve bahsetme denetimi
• Kanal Yönlendirme — mesajlar için oturum yönlendirmesi
• Güvenlik — erişim modeli ve güçlendirme