​

Nostr

​

설치(필요할 때)

​

Onboarding (권장)

• onboarding wizard(openclaw onboard)와 openclaw channels add는 선택형 채널 plugin을 나열합니다.
• Nostr를 선택하면 필요할 때 plugin 설치를 진행합니다.

• Dev channel + git checkout 가능: 로컬 plugin path 사용
• Stable/Beta: npm에서 다운로드

​

수동 설치

openclaw plugins install @openclaw/nostr

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

​

빠른 설정

1. Nostr keypair가 없다면 생성:

# Using nak
nak key generate

2. config에 추가:

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

3. key를 export:

export NOSTR_PRIVATE_KEY="nsec1..."

4. Gateway를 재시작합니다.

​

Configuration reference

​

Profile metadata

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

• Profile URL은 https://를 사용해야 합니다.
• relay에서 가져온 profile을 import하면 field를 병합하고 local override를 유지합니다.

​

접근 제어

​

DM policy

• pairing (기본): 알 수 없는 sender는 pairing code를 받음
• allowlist: allowFrom의 pubkey만 DM 가능
• open: 공개 inbound DMs (allowFrom: ["*"] 필요)
• disabled: inbound DM 무시

​

Allowlist 예시

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

​

Key 형식

• Private key: nsec... 또는 64자 hex
• Pubkey (allowFrom): npub... 또는 hex

​

Relays

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

• 중복 대비를 위해 2-3개 relay를 사용하세요.
• relay가 너무 많으면 지연과 중복이 늘어납니다.
• 유료 relay는 신뢰성을 높일 수 있습니다.
• 테스트에는 local relay도 괜찮습니다(ws://localhost:7777).

​

Protocol support

​

Testing

​

Local relay

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

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

​

수동 테스트

1. logs에서 bot pubkey(npub)를 확인합니다.
2. Nostr client(Damus, Amethyst 등)를 엽니다.
3. bot pubkey에 DM을 보냅니다.
4. 응답을 확인합니다.

​

문제 해결

​

메시지를 받지 못할 때

• private key가 유효한지 확인
• relay URL이 도달 가능하고 wss://를 쓰는지 확인 (로컬은 ws:// 가능)
• enabled가 false가 아닌지 확인
• relay connection error가 있는지 Gateway logs 확인

​

응답을 보내지 못할 때

• relay가 write를 허용하는지 확인
• outbound connectivity 확인
• relay rate limit 확인

​

중복 응답

• 여러 relay를 쓸 때는 예상 가능한 현상입니다.
• 메시지는 event ID로 dedupe되며, 첫 번째 전달만 응답을 트리거합니다.

​

보안

• private key를 절대 커밋하지 마세요.
• key는 env var로 관리하세요.
• 운영 bot에는 allowlist를 고려하세요.

​

제한 사항(MVP)

• direct messages만 지원(group chat 없음)
• media attachment 없음
• NIP-04만 지원(NIP-17 gift-wrap은 예정)