Alpha software. StarClaw 2.x is an alpha and is not recommended for customers, production use or anyone who needs a guarantee.
StarClaw alpha

An AI agent that has to ask first

StarClaw is an open-source AI agent that writes and runs its own code, but every action it takes is checked against a policy you control, risky ones are put to a human, and everything is written to a signed log.

Status: alpha. The latest version on npm is 2.0.0-alpha.3. The source on GitHub is a little ahead (2.0.0-alpha.5, unreleased). It is tested on Windows 11 with Node.js 25.9.0 only. It does not stop prompt injection. Read the security page before you try it.

Who it is for

Developers who are comfortable with a command line and Node.js, and who want to try an agent that is built around limits and records. It is not a finished product for customers. The project itself says it is "not yet recommended for customers".

Quick start

Three steps, taken from the project README. You need Node.js 25.9.0 or newer.

  1. Install the alpha and set a model key. The bundled model backend is Groq; the model is an interface, so you can bring your own.
    npm install starclaw@next
    export GROQ_API_KEY=...
    Plain npm install starclaw gives the old 1.0.0 package, which is deprecated and broken. Do not use it.
  2. Write the default policy. It is conservative.
    npx starclaw policy init
  3. Give it a goal.
    npx starclaw run "summarise the headlines on https://example.com"

With the default policy, StarClaw asks you before it runs code, writes a file, uses the network, saves memory, saves a skill or spends money. The only thing it does silently is read files inside ./workspace. If nobody can answer (no terminal, or --non-interactive), anything that needs approval is denied.

Optional but recommended: npx starclaw sandbox build builds the Docker sandbox image (needs Docker), and npx starclaw doctor tests each isolation layer on your machine and tells you which one is active and why.

See it work in two minutes, offline

git clone https://github.com/mnemopay/starclaw && cd starclaw && npm install && npm run build
node dist/cli.js sandbox build    # needs Docker
npm run demo                      # no API key, no network, no real money

A scripted model plays an agent that obeys instructions hidden in a web page. You watch StarClaw stop it from leaking data and from paying an attacker, even though the policy allows web access and spending. Then the demo checks the signed log, edits one record, and shows the check fail.

What is real: the sandbox, the policy engine (the Governor), taint tracking, the approval flow and the audit log. What is fake: the language model (a script) and the payment rail (a counter). So the demo does not prove that a real model cannot be steered. It can. Without Docker the demo still runs, using only the Node permission layer.

What it does

More detail, including what each piece does not cover, is on the security page and in the docs.