Deployment

FastClaw can run as a local single binary, a Docker deployment, or a Kubernetes/Helm deployment backed by Postgres and object storage.

Local Daemon

fastclaw
fastclaw daemon start
fastclaw daemon status
fastclaw daemon stop
fastclaw daemon install

Default dashboard URL:

http://localhost:18953

Docker

cd deploy/docker
./start.sh

Use Docker when you want an isolated local service with the Docker sandbox backend available.

Kubernetes

Use Postgres for shared state:

env:
  - name: FASTCLAW_BIND
    value: "all"
  - name: FASTCLAW_STORAGE_TYPE
    value: "postgres"
  - name: FASTCLAW_STORAGE_DSN
    valueFrom:
      secretKeyRef:
        name: fastclaw-db
        key: dsn

Use object storage for distributed file/skill hydration:

env:
  - name: FASTCLAW_OBJECT_STORE_ENDPOINT
    value: "s3.amazonaws.com"
  - name: FASTCLAW_OBJECT_STORE_BUCKET
    value: "fastclaw-skills"

Manifests live under:

deploy/k8s/
deploy/helm/fastclaw/

Multi-Pod Requirements

For more than one gateway pod:

• FASTCLAW_STORAGE_TYPE=postgres
• shared object storage for skills/workspaces where needed
• Redis-backed bus and leases for channel coordination
• FASTCLAW_BIND=all behind an ingress or service mesh
• sandbox backend that matches your infrastructure constraints

Health Checks

GET /healthz
GET /livez
GET /readyz

Use these for load balancer and Kubernetes probes.