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 đi kèm

​

Bản cài đặt cũ/tùy chỉnh

• Onboarding (openclaw onboard) và openclaw channels add vẫn hiển thị Nostr từ danh mục kênh dùng chung.
• Nếu bản dựng của bạn loại trừ Nostr đi kèm, hãy cài đặt gói npm hiện tại khi gói đó được phát hành.

openclaw plugins install @openclaw/nostr

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

​

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 cặp khóa Nostr (nếu cần):

# Using 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 chiếu cấu hình

​

Siêu dữ liệu hồ sơ

{
  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 hồ sơ phải dùng https://.
• Nhập từ relay sẽ hợp nhất các trường và giữ nguyên 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 được mã ghép nối.
• allowlist: chỉ các pubkey trong allowFrom mới có thể gửi DM.
• open: DM đến công khai (yêu cầu allowFrom: ["*"]).
• disabled: bỏ qua DM đến.

• Chữ ký sự kiện đến được xác minh trước chính sách người gửi và giải mã NIP-04, nên sự kiện giả mạo bị từ chối sớm.
• Phản hồi ghép nối được gửi mà không xử lý nội dung DM ban đầu.
• DM đến bị giới hạn tốc độ và payload quá lớn bị loại bỏ trước khi giải mã.

​

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 hex 64 ký tự
• Pubkey (allowFrom): npub... hoặc hex

​

Relay

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

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

​

Hỗ trợ giao thức

​

Kiểm thử

​

Relay cục bộ

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

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

​

Kiểm thử thủ công

1. Ghi lại pubkey bot (npub) từ nhật ký.
2. Mở một client Nostr (Damus, Amethyst, v.v.).
3. Gửi DM đến 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à dùng wss:// (hoặc ws:// cho cục bộ).
• Xác nhận enabled không phải là false.
• Kiểm tra nhật ký Gateway để tìm lỗi kết nối relay.

​

Không gửi được phản hồi

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

​

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

• Đây là điều có thể xảy ra khi dùng nhiều relay.
• Tin nhắn được loại trùng theo ID sự kiện; chỉ lần phân phố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.
• Dùng biến môi trường cho khóa.
• Cân nhắc allowlist cho bot production.
• Chữ ký được xác minh trước chính sách người gửi, và chính sách người gửi được thực thi trước khi giải mã, nên sự kiện giả mạo bị từ chối sớm và người gửi không xác định không thể buộc thực hiện đầy đủ công việc mã hóa.

​

Giới hạn (MVP)

• Chỉ tin nhắn trực tiếp (không có trò chuyện nhóm).
• Không có tệp đính kèm phương tiện.
• Chỉ NIP-04 (đã lên kế hoạch gift-wrap NIP-17).

​

Liên quan

• Tổng quan kênh — tất cả kênh được hỗ trợ
• Ghép nối — xác thực DM và luồng ghép nối
• Nhóm — hành vi trò chuyện nhóm và cổng kiểm soát lượt nhắc
• Định tuyến kênh — định tuyến phiên cho tin nhắn
• Bảo mật — mô hình truy cập và gia cố