# Clawtainer

Browser-accessible Linux desktop with AI coding tools pre-installed: OpenClaw, VS Code, Cursor, Antigravity, and Anthropic Python SDK.

## Quick Start

```bash
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)

```bash
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)

```bash
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.