clawtainer/README.md

2.1 KiB

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

Run (Docker Compose)

docker compose up -d

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

  1. Register a new Workspace in Kasm Admin
  2. Set Docker Image to clawtainer:local (or your tagged name)
  3. Add port 18789 to the workspace's port configuration
  4. Save and launch a session

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

You can also access the Control UI in the in-session browser. Run openclaw onboard --non-interactive from the terminal if needed, or paste your token in Settings.

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.