​

Nostr

​

Cài đặt (khi cần)

​

Hướng dẫn cài đặt (khuyến nghị)

• Khi onboard (openclaw onboard) và openclaw channels add sẽ liệt kê các plugin kênh tùy chọn.
• Chọn Nostr sẽ yêu cầu cài đặt plugin khi cần.

• Kênh Dev + git checkout có sẵn: sử dụng đường dẫn plugin cục bộ.
• Stable/Beta: tải về từ npm.

​

Cài đặt thủ công

openclaw plugins install @openclaw/nostr

openclaw plugins install --link <path-to-openclaw>/extensions/nostr

​

Thiết lập không tương tác

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"

​

Thiết lập nhanh

1. Tạo một cặp khóa Nostr (nếu cần):

# Sử dụng nak
nak key generate

2. Thêm vào cấu hình:

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

3. Xuất khóa:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Khởi động lại Gateway.

​

Tham khảo cấu hình

​

Metadata hồ sơ

{
  channels: {
    nostr: {
      privateKey: "${NOSTR_PRIVATE_KEY}",
      profile: {
        name: "openclaw",
        displayName: "OpenClaw",
        about: "Bot trợ lý cá nhân DM",
        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 hồ sơ phải sử dụng https://.
• Nhập từ relays sẽ hợp nhất các trường và giữ lại các ghi đè cục bộ.

​

Kiểm soát truy cập

​

Chính sách DM

• pairing (mặc định): người gửi không xác định nhận mã ghép đôi.
• allowlist: chỉ pubkey trong allowFrom có thể DM.
• open: DMs công khai (yêu cầu allowFrom: ["*"]).
• disabled: bỏ qua DMs đến.

​

Ví dụ Allowlist

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

​

Định dạng khóa

• Khóa riêng: nsec... hoặc 64 ký tự hex
• Pubkeys (allowFrom): npub... hoặc hex

​

Relays

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

• Sử dụng 2-3 relays để dự phòng.
• Tránh quá nhiều relays (độ trễ, trùng lặp).
• Relays trả phí có thể cải thiện độ tin cậy.
• Relays cục bộ phù hợp để thử nghiệm (ws://localhost:7777).

​

Hỗ trợ giao thức

​

Kiểm tra

​

Relay cục bộ

# Khởi động strfry
docker run -p 7777:7777 ghcr.io/hoytech/strfry

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

​

Kiểm tra thủ công

1. Ghi lại pubkey bot (npub) từ logs.
2. Mở một client Nostr (Damus, Amethyst, v.v.).
3. DM pubkey bot.
4. Xác minh phản hồi.

​

Khắc phục sự cố

​

Không nhận được tin nhắn

• Xác minh khóa riêng hợp lệ.
• Đảm bảo URL relay có thể truy cập và sử dụng wss:// (hoặc ws:// cho cục bộ).
• Xác nhận enabled không phải là false.
• Kiểm tra logs Gateway để tìm lỗi kết nối relay.

​

Không gửi phản hồi

• Kiểm tra relay chấp nhận ghi.
• Xác minh kết nối ra ngoài.
• Theo dõi giới hạn tốc độ relay.

​

Phản hồi trùng lặp

• Dự kiến khi sử dụng nhiều relays.
• Tin nhắn được loại bỏ trùng lặp theo ID sự kiện; chỉ lần gửi đầu tiên kích hoạt phản hồi.

​

Bảo mật

• Không bao giờ commit khóa riêng.
• Sử dụng biến môi trường cho khóa.
• Cân nhắc allowlist cho bot sản xuất.

​

Giới hạn (MVP)

• Chỉ tin nhắn trực tiếp (không có chat nhóm).
• Không có tệp đính kèm media.
• Chỉ NIP-04 (NIP-17 gói quà dự kiến).