Added detailed documentation explaining: - OpenClaw is open-source but requires AI provider API keys - Three setup options: interactive wizard, manual config, or web UI - Links to get API keys from major providers - Clarified that OpenClaw itself is free, only API usage costs - Added first-time setup note in Quick Start section Co-authored-by: Cursor <cursoragent@cursor.com> |
||
|---|---|---|
| .gitignore | ||
| Dockerfile | ||
| LICENSE | ||
| README.md | ||
| docker-compose.yml | ||
| nginx.conf | ||
README.md
Clawtainer
Browser-accessible Linux desktop with AI coding tools pre-installed: OpenClaw, VS Code, Cursor, Antigravity, and Anthropic Python SDK.
Quick Start
git clone git@git.nixc.us:colin/clawtainer.git
cd clawtainer
docker compose up -d
Access from any device on your LAN:
- Desktop (VNC):
http://YOUR_IP:6901(no password) - OpenClaw Gateway:
http://YOUR_IP:18789
First-time setup: OpenClaw requires API keys from AI providers (Anthropic, OpenAI, Google, etc.). See OpenClaw Setup below.
Run (Docker Compose)
docker compose up -d
- Desktop: http://localhost:6901 (no password required)
- OpenClaw Control UI: http://localhost:18789 (token:
clawtainer)
The nginx proxy strips TLS from the VNC connection for easy browser access.
Set OpenClaw token: OPENCLAW_GATEWAY_TOKEN=mytoken docker compose up -d
Build (standalone)
docker build -t clawtainer:local .
Kasm Workspaces Setup
- Register a new Workspace in Kasm Admin
- Set Docker Image to
clawtainer:local(or your tagged name) - Add port 18789 to the workspace's port configuration
- Save and launch a session
OpenClaw Setup
OpenClaw is an open-source AI agent orchestration platform that connects to AI provider APIs (Anthropic, OpenAI, Google, etc.). The Gateway auto-starts on port 18789, but you need to configure it with your own API keys.
Setup Options:
-
Interactive Wizard (easiest):
openclaw onboardWalks you through model selection and API key entry.
-
Manual Configuration: Edit
~/.openclaw/openclaw.jsonor use environment variables:export ANTHROPIC_API_KEY="sk-ant-..." export OPENAI_API_KEY="sk-..." export GOOGLE_API_KEY="AIza..." -
Via Gateway UI:
- Open
http://localhost:18789in browser - Navigate to Settings
- Add your API keys for desired providers
- Open
Get API Keys:
- Anthropic (Claude): https://console.anthropic.com/
- OpenAI (GPT): https://platform.openai.com/api-keys
- Google (Gemini): https://makersuite.google.com/app/apikey
- OpenRouter: https://openrouter.ai/keys
Note: OpenClaw itself is free and open-source. You only pay for API usage from your chosen AI providers.
Usage
After startup, open the desktop at port 6901. Desktop shortcuts are available:
- OpenClaw Control - Opens the gateway UI at
http://localhost:18789 - VS Code - Launches Visual Studio Code
- Cursor - AI-powered code editor
- Antigravity - Google's AI IDE
Access the Control UI to configure API keys, set up messaging channels (Telegram, WhatsApp, etc.), and manage AI agents.
What's Included
AI Coding Tools:
- OpenClaw - Auto-starts gateway on port 18789
- Cursor IDE - AI-powered code editor
- Google Antigravity - Google's AI IDE with Gemini
- VS Code - Microsoft Visual Studio Code
- Anthropic Python SDK - Claude API access (
pip install anthropic)
Base:
- Kasm Desktop:
kasmweb/debian-bookworm-desktop:1.18.0-rolling-daily - Node: 22 (from NodeSource)
- Python 3 with pip
Network:
- Nginx proxy strips TLS for plain HTTP access
- No password authentication on VNC interface
- LAN accessible by default
License
Creative Commons Attribution 4.0 International (CC BY 4.0)
Copyright (c) 2026 Colin Knapp - https://colinknapp.com
See LICENSE file for details.