Core
Configuration
Bootstrap env vars and database-backed runtime settings.
FastClaw uses two configuration layers:
- Bootstrap env vars: process-level settings read from
FASTCLAW_*at startup. - Runtime settings: providers, channels, tool policy, agent defaults, sandbox toggles, and plugin config stored in the database and edited through the dashboard or CLI.
There is no fastclaw.json.
Bootstrap Variables
| Variable | Default | Purpose |
|---|---|---|
FASTCLAW_HOME | ~/.fastclaw | Home directory for DB, skills, workspaces, logs |
FASTCLAW_PORT | 18953 | Gateway HTTP port |
FASTCLAW_BIND | loopback | loopback for 127.0.0.1, or all for 0.0.0.0 |
FASTCLAW_STORAGE_TYPE | sqlite | sqlite or postgres |
FASTCLAW_STORAGE_DSN | empty | Postgres DSN, or empty for SQLite at $FASTCLAW_HOME/fastclaw.db |
FASTCLAW_STORAGE_AUTO_MIGRATE | true | Apply schema migrations on boot |
FASTCLAW_REDIS_ENABLED | false | Enable Redis-backed bus and channel leases |
FASTCLAW_REDIS_ADDR | empty | Redis address, e.g. redis:6379 |
FASTCLAW_SANDBOX_ENABLED | dashboard | Override sandbox runtime toggle |
FASTCLAW_SANDBOX_BACKEND | docker path | docker, e2b, or boxlite |
FASTCLAW_SANDBOX_IMAGE | backend default | Sandbox image/template |
FASTCLAW_LOG_LEVEL | info | debug, info, warn, error |
FASTCLAW_DEBUG_MODE | false | Verbose diagnostics, including prompt dumps |
Object Store Variables
Distributed deployments can hydrate skills/files from S3-compatible storage:
FASTCLAW_OBJECT_STORE_TYPE
FASTCLAW_OBJECT_STORE_REGION
FASTCLAW_OBJECT_STORE_BUCKET
FASTCLAW_OBJECT_STORE_PREFIX
FASTCLAW_OBJECT_STORE_ACCESSKEY
FASTCLAW_OBJECT_STORE_SECRETKEY
FASTCLAW_OBJECT_STORE_ACCOUNTID
FASTCLAW_OBJECT_STORE_ENDPOINT
FASTCLAW_OBJECT_STORE_USESSLRuntime Settings
Runtime settings are edited from the dashboard and stored in the database. Examples:
- Providers and model catalog
- Agent default model and policy
- Channel credentials
- Tool categories and tool providers
- Sandbox toggle, backend, image, and network policy
- Plugin configuration
- Scheduler, memory, heartbeat, privacy, object store
CLI commands such as fastclaw agents config <agent> set <key> <value> write through the same store the dashboard uses.