git clone https://github.com/sigridjineth/claw-nk-captcha.git
open claw-nk-captcha/demo/index.html

npm install nk-captcha-react

import NkCaptcha from 'nk-captcha-react';

function App() {
  return (
    <NkCaptcha
      locale="both"
      timeout={60}
      theme="dark"
      onVerify={(result) => {
        if (result.pass) {
          console.log('Verified!', result.code);
          console.log('They said:', result.transcript);
          console.log('Match:', Math.round(result.similarity * 100) + '%');
          // result.audioBlob has the recording for server-side verification
        } else {
          console.log('FAILED — potential DPRK operative');
        }
      }}
    />
  );
}

interface NkCaptchaResult {
  pass: boolean;           // true if verified
  challengeId: string;     // which phrase was used
  transcript: string;      // what the user said (via Web Speech API)
  similarity: number;      // 0-1 match score
  code: string | null;     // verification code (e.g. "NKCAP-M3X7K-A9B2C")
  audioBlob: Blob | null;  // raw recording for server-side re-verification
  durationMs: number;      // recording length in ms
}

<script src="https://cdn.jsdelivr.net/gh/sigridjineth/claw-nk-captcha@main/dist/nk-captcha.js"></script>
<nk-captcha></nk-captcha>

<nk-captcha on-verify="handleResult" theme="dark"></nk-captcha>
<script>
  function handleResult(result) {
    if (result.pass) {
      document.getElementById('protected-content').style.display = 'block';
    }
  }
</script>

document.querySelector('nk-captcha')
  .addEventListener('nk-captcha-verified', (e) => {
    console.log(e.detail); // {pass, challengeId, similarity, code}
  });

# From ClawHub (recommended)
openclaw plugins install clawhub:openclaw-nk-captcha
openclaw gateway restart

# From GitHub
git clone https://github.com/sigridjineth/claw-nk-captcha.git
openclaw plugins install ./claw-nk-captcha
openclaw gateway restart

{
  plugins: {
    entries: {
      "nk-captcha": {
        enabled: true,
        config: {
          locale: "both",
          timeoutSeconds: 60,
          challengeCount: 1,
          enableMediaRecording: true,
          minRecordingDurationMs: 1500,

          // Required for voice verification via uploaded audio files
          sttApiKey: "sk-your-openai-api-key",
          sttEndpoint: "https://api.openai.com/v1/audio/transcriptions",
          sttModel: "whisper-1"
        }
      }
    }
  }
}

{
  "nk-captcha": {
    config: {
      sttApiKey: "sk-proj-your-key-here"
    }
  }
}

# Example with faster-whisper
pip install faster-whisper
# Start a Whisper API server on port 8080

{
  sttEndpoint: "http://localhost:8080/v1/audio/transcriptions",
  sttApiKey: "local",
  sttModel: "large-v3"
}

📥 @new-hire joined the server

🤖 Bot:  Welcome! Before you can access this server, you must
         complete NK CAPTCHA verification.

         Your challenge phrase:
         ┌─────────────────────────────────────────┐
         │  🇰🇷  김정은은 뚱뚱한 분홍 돼지다             │
         │  🇺🇸  Kim Jong-un is a fat pink pig        │
         └─────────────────────────────────────────┘

         🎙️ Upload a voice recording of yourself saying it

👤 new-hire:  [📎 voice-message.ogg]

🤖 Bot:  🎧 Analyzing your recording...
         Transcript: "김정은은 뚱뚱한 분홍 돼지다"
         ✅ VERIFIED (95% match via Whisper STT)
         You are NOT a DPRK operative.
         Role "Verified" granted!

👤 suspect:  [📎 silence.ogg]

🤖 Bot:  🚫 VERIFICATION FAILED
         Speech does not match challenge phrase (12% similarity).
         POTENTIAL DPRK OPERATIVE detected.
         Access denied.

User joins → AI calls nk_captcha_challenge → random phrase
                              ↓
         ┌────────────────────┴────────────────────┐
         │                                         │
    User types text                      User uploads audio
         │                                         │
  nk_captcha_verify                  nk_captcha_verify_audio_url
  (Levenshtein 90%+)         (download → Whisper → Levenshtein 90%+)
         │                                         │
         └────────────────────┬────────────────────┘
                              ↓
                   PASS → grant access
                   FAIL → flag user

{
  "challengeId": "pink-pig-1",
  "audioUrl": "https://cdn.discordapp.com/attachments/.../voice-message.ogg"
}

{
  "status": "VERIFIED",
  "transcript": "김정은은 뚱뚱한 분홍 돼지다",
  "similarity": 0.95,
  "sttSource": "whisper"
}

claw-nk-captcha/
├── package.json              # OpenClaw plugin metadata
├── openclaw.plugin.json      # Plugin manifest + config schema
├── index.ts                  # Plugin entry — 7 tools + HTTP route + Whisper STT
├── src/
│   ├── challenges.ts         # 18 bilingual challenge phrases + Levenshtein verification
│   └── captcha-ui.ts         # Full HTML/CSS/JS captcha page (Web Speech API + MediaRecorder)
├── react/
│   ├── package.json          # npm: nk-captcha-react
│   ├── index.js              # React voice recording component
│   └── index.d.ts            # TypeScript types
├── dist/
│   └── nk-captcha.js         # Embeddable Web Component (<nk-captcha>)
├── demo/
│   ├── index.html            # Full-featured demo (text + voice)
│   └── embed.html            # Web Component embed demo
└── assets/
    └── screenshot-*.png      # Documentation screenshots