Gasclaw

Gastown + OpenClaw + KimiGas in one container.

A single-container deployment that runs a Gastown multi-agent workspace, managed by an OpenClaw overseer bot on Telegram. All agents use Kimi K2.5 as their LLM backend through Claude Code's agentic interface.

Prerequisites

Docker Engine 24+ and Docker Compose v2 — Install Docker

Quick Start

git clone [email protected]:gastown-publish/gasclaw.git && cd gasclaw
cp .env.example .env   # add your keys
docker compose up -d

What's Inside

Component	Role
Gastown (`gt`)	Multi-agent workspace — Mayor, Crew, Daemon
OpenClaw	Overseer — Telegram bot, monitoring, compliance
KimiGas	LRU key rotation with rate-limit cooldown
AIS	tmux-based AI session manager
Dolt	Version-controlled SQL for agent state
Beads (`bd`)	Git-backed issue tracking

How It Works

┌──────────────── Docker Container ────────────────┐
│  OpenClaw Gateway (Telegram) ← human             │
│  Gastown HQ — Mayor + Crew (Claude Code / Kimi)  │
│  Dolt SQL — agent state    KimiGas — key pools   │
│  /project ← your repo (volume mount)             │
└──────────────────────────────────────────────────┘

Agents run claude CLI with ANTHROPIC_BASE_URL pointed at Kimi's API. Permission bypass is via Claude config file — no --dangerously-skip-permissions flag.

Environment Variables

Variable	Required	Description
`GASTOWN_KIMI_KEYS`	Yes	Colon-separated Kimi keys for agents
`OPENCLAW_KIMI_KEY`	Yes	Kimi key for overseer (separate pool)
`TELEGRAM_BOT_TOKEN`	Yes	Telegram bot token
`TELEGRAM_OWNER_ID`	Yes	Telegram user ID

Optional: GT_RIG_URL, GT_AGENT_COUNT, MONITOR_INTERVAL, ACTIVITY_DEADLINE, DOLT_PORT, GATEWAY_PORT, LOG_LEVEL — see .env.example for the full list.

Documentation

Documentation Site — full guides and API reference
Wiki — quick reference

Guide	Topic
Architecture	System design and component interaction
Gastown Integration	Real Gastown CLI (`gt`) setup
Kimi Proxy	KimiGas key rotation and Claude env
OpenClaw & Telegram	Bot config, policies, and channels
Docker Deployment	Container setup, volumes, networking
Troubleshooting	Common issues and fixes
Knowledge Base	FAQ and lessons learned

For AI agents: llms.txt — machine-readable project reference.

Development

python -m venv .venv && source .venv/bin/activate
make dev
make test       # 1021 unit tests — no API keys needed
make lint

Project Structure

src/gasclaw/
├── cli.py           # Typer CLI
├── config.py        # Env var config
├── bootstrap.py     # 10-step startup
├── health.py        # Health checks
├── gastown/         # gt CLI integration
├── kimigas/         # Key pool + Kimi proxy
├── openclaw/        # OpenClaw config writer
└── updater/         # Version checks
reference/           # Distilled dependency docs (for agents)
scripts/             # Validation scripts
skills/              # OpenClaw skills
tests/unit/          # 1021 unit tests

Contributing

See CONTRIBUTING.md and CLAUDE.md.

License

MIT