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.
- Docker Engine 24+ and Docker Compose v2 — Install Docker
git clone git@github.com:gastown-publish/gasclaw.git && cd gasclaw
cp .env.example .env # add your keys
docker compose up -d| 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 |
┌──────────────── 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.
| 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 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.
python -m venv .venv && source .venv/bin/activate
make dev
make test # 1021 unit tests — no API keys needed
make lintsrc/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
See CONTRIBUTING.md and CLAUDE.md.
MIT