Installation

CireilClaw is distributed as a self-contained Linux x64 executable from a verified release.

Requirements

A 64-bit Linux host is required.

The exec tool runs commands through a sandbox; the default Bubblewrap backend requires a working bwrap binary on the host.

Install

1. Download the release archive and its accompanying .sha256 checksum for the version you are installing.
2. Verify the checksum matches the archive.
3. Unpack the archive.
4. Place the cireilclaw executable on the host path.
5. Run cireilclaw --help to confirm the executable runs.

Initialize the runtime

Run cireilclaw init to create the runtime root plus its global config/ and agents/ directories.

Scaffold a first agent with cireilclaw init --agent my-agent; pass --provider, --api-base, and --model to control the generated provider configuration.

The default runtime root is ~/.cireilclaw; every command accepts --root <PATH> when the runtime should live elsewhere.

First run

Edit the generated agent configuration, then run cireilclaw dry-run to validate it without starting the host.

Start the runtime with cireilclaw or cireilclaw run.

Secrets

Do not place provider tokens, Discord tokens, or OAuth credentials in source control.