Nostr

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Plugin ที่บันเดิลมา

​

การติดตั้งรุ่นเก่าหรือแบบกำหนดเอง

• Onboarding (openclaw onboard) และ openclaw channels add ยังคงแสดง Nostr จากแคตตาล็อกช่องทางที่ใช้ร่วมกัน
• หากบิลด์ของคุณไม่รวม Nostr ที่บันเดิลมา ให้ติดตั้งแพ็กเกจ npm โดยตรง

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 (หากจำเป็น):

# Using nak
nak key generate

2. เพิ่มลงใน config:

{
  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: "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",
      },
    },
  },
}

• URL โปรไฟล์ต้องใช้ https://
• การนำเข้าจากรีเลย์จะผสานฟิลด์และคงการแทนที่ในเครื่องไว้

​

การควบคุมการเข้าถึง

​

นโยบาย DM

• pairing (ค่าเริ่มต้น): ผู้ส่งที่ไม่รู้จักจะได้รับโค้ดจับคู่
• allowlist: เฉพาะ pubkey ใน allowFrom เท่านั้นที่ส่ง DM ได้
• open: DM ขาเข้าสาธารณะ (ต้องใช้ allowFrom: ["*"])
• disabled: ไม่สนใจ DM ขาเข้า

• ลายเซ็นอีเวนต์ขาเข้าจะถูกตรวจสอบก่อนนโยบายผู้ส่งและการถอดรหัส NIP-04 ดังนั้นอีเวนต์ปลอมจะถูกปฏิเสธตั้งแต่ต้น
• การตอบกลับการจับคู่จะถูกส่งโดยไม่ประมวลผลเนื้อหา DM เดิม
• DM ขาเข้าถูกจำกัดอัตรา และเพย์โหลดที่มีขนาดใหญ่เกินไปจะถูกทิ้งก่อนถอดรหัส

​

ตัวอย่าง allowlist

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

​

รูปแบบคีย์

• คีย์ส่วนตัว: nsec... หรือ hex 64 อักขระ
• Pubkeys (allowFrom): npub... หรือ hex

​

รีเลย์

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

• ใช้รีเลย์ 2-3 รายการเพื่อความซ้ำซ้อน
• หลีกเลี่ยงการใช้รีเลย์มากเกินไป (เวลาแฝง, การซ้ำซ้อน)
• รีเลย์แบบชำระเงินสามารถเพิ่มความน่าเชื่อถือได้
• รีเลย์ในเครื่องใช้ทดสอบได้ (ws://localhost:7777)

​

การรองรับโปรโตคอล

​

การทดสอบ

​

รีเลย์ในเครื่อง

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

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

​

การทดสอบด้วยตนเอง

1. จด pubkey (npub) ของบอทจากบันทึก
2. เปิดไคลเอนต์ Nostr (Damus, Amethyst ฯลฯ)
3. ส่ง DM ไปยัง pubkey ของบอท
4. ตรวจสอบการตอบกลับ

​

การแก้ไขปัญหา

​

ไม่ได้รับข้อความ

• ตรวจสอบว่าคีย์ส่วนตัวถูกต้อง
• ตรวจสอบให้แน่ใจว่า URL รีเลย์เข้าถึงได้และใช้ wss:// (หรือ ws:// สำหรับในเครื่อง)
• ยืนยันว่า enabled ไม่ใช่ false
• ตรวจสอบบันทึก Gateway สำหรับข้อผิดพลาดการเชื่อมต่อรีเลย์

​

ไม่ส่งการตอบกลับ

• ตรวจสอบว่ารีเลย์ยอมรับการเขียน
• ตรวจสอบการเชื่อมต่อขาออก
• เฝ้าดูขีดจำกัดอัตราของรีเลย์

​

การตอบกลับซ้ำ

• เป็นสิ่งที่คาดได้เมื่อใช้รีเลย์หลายรายการ
• ข้อความจะถูกขจัดรายการซ้ำด้วย ID อีเวนต์ เฉพาะการส่งมอบครั้งแรกเท่านั้นที่กระตุ้นการตอบกลับ

​

ความปลอดภัย

• อย่า commit คีย์ส่วนตัว
• ใช้ตัวแปรสภาพแวดล้อมสำหรับคีย์
• พิจารณาใช้ allowlist สำหรับบอทในการใช้งานจริง
• ลายเซ็นจะถูกตรวจสอบก่อนนโยบายผู้ส่ง และนโยบายผู้ส่งจะถูกบังคับใช้ก่อนถอดรหัส ดังนั้นอีเวนต์ปลอมจะถูกปฏิเสธตั้งแต่ต้น และผู้ส่งที่ไม่รู้จักไม่สามารถบังคับให้ทำงานเข้ารหัสเต็มรูปแบบได้

​

ข้อจำกัด (MVP)

• เฉพาะข้อความโดยตรงเท่านั้น (ไม่มีแชทกลุ่ม)
• ไม่มีไฟล์แนบสื่อ
• เฉพาะ NIP-04 เท่านั้น (วางแผน NIP-17 gift-wrap ไว้)

​

ที่เกี่ยวข้อง

• ภาพรวมช่องทาง — ช่องทางที่รองรับทั้งหมด
• การจับคู่ — การยืนยันตัวตน DM และโฟลว์การจับคู่
• กลุ่ม — พฤติกรรมแชทกลุ่มและการควบคุมด้วยการกล่าวถึง
• การกำหนดเส้นทางช่องทาง — การกำหนดเส้นทางเซสชันสำหรับข้อความ
• ความปลอดภัย — โมเดลการเข้าถึงและการเสริมความแข็งแกร่ง