Nostr

​

التثبيت

openclaw plugins install @openclaw/nostr

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

​

الإعداد غير التفاعلي

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"

​

الإعداد السريع

1. أنشئ زوج مفاتيح Nostr (عند الحاجة):

# باستخدام nak
nak key generate

2. أضفه إلى الإعدادات:

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

3. صدّر المفتاح:

export NOSTR_PRIVATE_KEY="nsec1..."

4. أعد تشغيل Gateway.

​

مرجع الإعدادات

​

بيانات الملف الشخصي الوصفية

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      profile: {
        name: "openclaw",
        displayName: "OpenClaw",
        about: "روبوت رسائل مباشرة يعمل كمساعد شخصي",
        picture: "https://example.com/avatar.png",
        banner: "https://example.com/banner.png",
        website: "https://example.com",
        nip05: "openclaw@example.com",
        lud16: "openclaw@example.com",
      },
    },
  },
}

• يجب أن تستخدم عناوين URL للملف الشخصي https://.
• يؤدي الاستيراد من المرحّلات إلى دمج الحقول مع الحفاظ على التجاوزات المحلية.

​

التحكم في الوصول

​

سياسات الرسائل المباشرة

• pairing (الافتراضية): يحصل المرسلون غير المعروفين على رمز إقران.
• allowlist: لا يمكن إرسال رسائل مباشرة إلا من المفاتيح العامة الموجودة في allowFrom.
• open: رسائل مباشرة واردة متاحة للعامة (تتطلب allowFrom: ["*"]).
• disabled: تجاهل الرسائل المباشرة الواردة.

• يجري التحقق من توقيعات الأحداث الواردة قبل تطبيق سياسة المرسل وفك تشفير NIP-04، لذلك تُرفض الأحداث المزوّرة مبكرًا.
• تُرسل ردود الإقران دون فك تشفير نص الرسالة المباشرة الأصلية أو معالجته.
• تخضع الرسائل المباشرة الواردة لتحديد المعدل (عموميًا ولكل مرسل)، وتُسقط الحمولات ذات الحجم الزائد قبل فك التشفير.

​

مثال على قائمة السماح

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

​

تنسيقات المفاتيح

• المفتاح الخاص: nsec... أو قيمة سداسية عشرية من 64 محرفًا
• المفاتيح العامة (allowFrom): npub... أو قيمة سداسية عشرية

​

المرحّلات

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

• استخدم مرحّلين أو ثلاثة مرحّلات لتحقيق التكرار الاحتياطي.
• تجنّب استخدام عدد كبير جدًا من المرحّلات (بسبب زمن الاستجابة والتكرار).
• يمكن للمرحّلات المدفوعة تحسين الموثوقية.
• المرحّلات المحلية مناسبة للاختبار (ws://localhost:7777).

​

دعم البروتوكولات

​

الاختبار

​

مرحّل محلي

# تشغيل strfry
docker run -p 7777:7777 ghcr.io/hoytech/strfry

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

​

اختبار يدوي

1. دوّن المفتاح العام للروبوت من سجلات Gateway أو من openclaw channels status (بتنسيق سداسي عشري؛ حوّله إلى npub في عميلك عند الحاجة).
2. افتح عميل Nostr ‏(Amethyst أو Damus أو غيرهما).
3. أرسل رسالة مباشرة إلى المفتاح العام للروبوت.
4. تحقّق من الرد.

​

استكشاف الأخطاء وإصلاحها

​

عدم تلقي الرسائل

• تحقّق من صلاحية المفتاح الخاص.
• تأكد من إمكانية الوصول إلى عناوين URL للمرحّلات ومن أنها تستخدم wss:// (أو ws:// للاتصال المحلي).
• تأكد من أن enabled ليست false.
• افحص سجلات Gateway بحثًا عن أخطاء الاتصال بالمرحّلات.

​

عدم إرسال الردود

• تحقّق من أن المرحّل يقبل عمليات الكتابة.
• تحقّق من الاتصال الصادر.
• راقب حدود المعدل التي تفرضها المرحّلات.

​

الردود المكررة

• هذا متوقع عند استخدام مرحّلات متعددة.
• تُزال الرسائل المكررة استنادًا إلى معرّف الحدث؛ ولا يؤدي إلى تشغيل رد سوى أول تسليم.

​

الأمان

• لا تُضمّن المفاتيح الخاصة في المستودع مطلقًا.
• استخدم متغيرات البيئة للمفاتيح.
• فكّر في استخدام allowlist لروبوتات بيئة الإنتاج.
• يجري التحقق من التوقيعات قبل تطبيق سياسة المرسل، وتُطبّق سياسة المرسل قبل فك التشفير، لذلك تُرفض الأحداث المزوّرة مبكرًا ولا يمكن للمرسلين غير المعروفين فرض تنفيذ عمليات التشفير كاملة.

​

القيود (الحد الأدنى من المنتج القابل للاستخدام)

• الرسائل المباشرة فقط (لا توجد محادثات جماعية).
• لا توجد مرفقات وسائط.
• NIP-04 فقط (من المخطط دعم التغليف كهدية وفق NIP-17).

​

ذو صلة

• نظرة عامة على القنوات — جميع القنوات المدعومة
• الإقران — مصادقة الرسائل المباشرة ومسار الإقران
• المجموعات — سلوك المحادثات الجماعية والتحكم بالوصول عبر الإشارات
• توجيه القنوات — توجيه جلسات الرسائل
• الأمان — نموذج الوصول وتعزيز الحماية