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

Docs

The documentation lives in the repository. This site does not copy it, so there is one source of truth.

Read these

Commands

This list is taken from src/cli.ts and the bin entries in package.json at version 2.0.0-alpha.5 (the repository, not yet on npm). The published 2.0.0-alpha.3 does not have the Slack and Discord commands. Run starclaw --help for the authoritative list on your install.

Most commands also accept --policy, --state-dir, --workspace, --sandbox auto|container|process and --require-container.

CommandWhat it does
starclaw run <goal>Run one goal and exit. Options: --non-interactive (nothing is approved, so everything the policy does not auto-allow is denied), --json.
starclawInteractive session (the default). In-session commands: /new (fresh session, clears taint), /status, exit.
starclaw policy init [file]Write the conservative default policy (default file starclaw.policy.json). Refuses to overwrite.
starclaw policy check [file]Validate a policy file. Exit code 1 if invalid.
starclaw doctorProbe the isolation layers on this machine and report what is blocked, which layer is active and why. Also reports model, search, browser and channel configuration (names and set / NOT set only).
starclaw audit verify <file>Check an audit log offline: hash chain, signatures and head checkpoint. Options: --pubkey, --pubkey-file, --allow-missing-head, --json. Pin the public key; without it the key inside the log is trusted.
starclaw sandbox build | status | cleanBuild the Docker sandbox image, show Docker and image state, or remove leftover sandbox containers (only those labelled starclaw.sandbox=1).
starclaw shell build | status | cleanSame three actions for the governed shell container used by tools.shell.
starclaw schedule add | list | remove | pause | resumeManage unattended jobs. add <name> <schedule> <goal> takes a 5-field cron expression or @every 30m; options --heartbeat and --notify. Jobs run only while the daemon runs.
starclaw daemonLong-running process: Telegram gateway, Slack and Discord webhook channels when enabled in the policy, and the scheduler. --no-telegram runs without Telegram.
starclaw slack statusCheck the Slack policy block and environment. Prints variable names and set / NOT set, never values.
starclaw discord statusSame check for Discord.
starclaw discord register [--guild <id>]Register the /starclaw slash command with Discord, globally or in one server.
starclaw-telegramTelegram front end. Needs TELEGRAM_BOT_TOKEN and a numeric TELEGRAM_OWNER_ID; fails closed without them.
starclaw-serverHTTP API and small web console on 127.0.0.1:3000. Needs STARCLAW_API_KEY (16+ characters). No TLS.

Development

npm run build && npm test && npm run typecheck

The tests use a fake model and a fake payment rail. Nothing in the suite calls a real provider.