本網站為獨立社群專案,與 OpenClaw 官方無任何關聯。內容僅供參考。 了解更多

翻譯文件

本頁為社群翻譯版本,可能與官方最新內容有出入。 查看官方英文原文 →

Nostr

透過 NIP-04 加密私訊整合 OpenClaw 與去中心化 Nostr 協定。

Nostr 外掛程式讓 OpenClaw 能透過去中心化的 Nostr 協定,使用 NIP-04 標準加密來接收和回應加密私訊。

安裝

透過 onboarding 精靈安裝:

openclaw onboard

或使用 npm 手動安裝:

openclaw plugins install @openclaw/nostr

對於開發工作流程,也可改為連結本機的 checkout。

安裝後需重新啟動 Gateway。

核心設定

基本設定需要 Nostr keypair(透過 nak key generate 產生)和指定私鑰為環境變數的設定:

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

主要設定參數

參數說明
privateKey必填,nsec 或十六進位格式
relays預設為 Damus 和 nos.lol relay URL
dmPolicy控制訊息存取(pairing、allowlist、open 或 disabled)
allowFrom指定允許的傳送者公鑰

個人資料管理

使用者可以發布個人資料中繼資料為 NIP-01 kind:0 事件,包括顯示名稱、簡介、頭像 URL 和聯絡資訊。

提示: 個人資料 URL 必須使用 HTTPS。

存取控制

配對模式

配對策略會給予未知傳送者存取碼,傳送者需核准後才能互動。

允許清單模式

允許清單模式將訊息限制為已核准的公鑰。

開放模式

開放模式允許不受限制的傳入訊息。

Relay 設定

最佳實務建議使用 2-3 個 relay 以確保冗餘,同時避免過多 relay 連線造成延遲問題。本機 relay 可用於測試環境。

{
  channels: {
    nostr: {
      relays: [
        "wss://relay.damus.io",
        "wss://nos.lol"
      ],
    },
  },
}

協定支援

目前支援:

  • NIP-01(基本事件)
  • NIP-04(加密訊息)

計畫新增:

  • NIP-17 gift-wrapped 訊息
  • NIP-44 版本化加密

目前限制

  • MVP 版本僅處理私訊
  • 不支援媒體附件
  • 使用 NIP-04 加密而非較新的 gift-wrap 標準