@clawnitor/cli

CLI for Clawnitor — agent monitoring, rules enforcement, and kill switch for OpenClaw.

Usage

openclaw plugins install @clawnitor/plugin
npx clawnitor init

clawnitor init handles authentication, API key generation, and configuration in one command. Choose GitHub or email magic link to sign in.

$ npx clawnitor init

  Clawnitor — Agent monitoring for OpenClaw
  by Safer Intelligence Labs

  How do you want to sign in?
  1. GitHub
  2. Email magic link

  > 1

  Open this URL:  https://github.com/login/device
  Enter code:     ABCD-1234

  Waiting for authorization...
  Authenticated as [email protected]

  Generating API key...
  Writing to openclaw.json...

  Done. Clawnitor is monitoring your agents.
  Dashboard: https://app.clawnitor.io

Discover agents

npx clawnitor discover

Reads all agents from your ~/.openclaw/openclaw.json and registers them with Clawnitor. Useful when you add a new agent and want to set up rules before it runs. Agents are registered as "discovered" — activate them from the dashboard to start monitoring.

Test your rules

npx clawnitor test                     # test against live rules
npx clawnitor test --local rules.json  # test against local rules
npx clawnitor test --verbose           # detailed per-test output
npx clawnitor test --json              # machine-readable for CI/CD

Runs 54 curated attack scenarios against your Shield config. Reports reliability score, false positive rate, and gaps. Exit code 1 on BLOCK — use in CI/CD pipelines to prevent deploying weak rule configs.

What init does

1. Authenticates via GitHub device flow or email magic link
2. Creates your Clawnitor account (or logs in if you already have one)
3. Generates an API key
4. Finds your openclaw.json (or creates one) and writes the API key

Manual setup

If you prefer not to use the CLI, sign up at clawnitor.io, copy your API key, and add it to your openclaw.json:

{
  "plugins": {
    "entries": {
      "clawnitor": {
        "config": {
          "apiKey": "clw_live_..."
        }
      }
    }
  }
}

Links

• Dashboard
• Documentation
• Interactive Demo
• Plugin on npm