77 lines
2.1 KiB
Markdown
77 lines
2.1 KiB
Markdown
# 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.
|