Add OpenClaw setup guide to desktop

Added OPENCLAW-SETUP.md with comprehensive setup instructions:
- Three setup methods: interactive wizard, web UI, and manual config
- Links to get API keys from all major providers
- Pre-installed tools overview
- Troubleshooting section
- Gateway token information

The guide is now visible on the desktop when users first log in,
making it easier to configure OpenClaw without leaving the container.

Modified Dockerfile to copy the setup guide to the desktop during build.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Leopere 2026-02-12 13:38:43 -05:00
parent 2e497d1ecf
commit eb3f3d4134
Signed by: colin
SSH Key Fingerprint: SHA256:nRPCQTeMFLdGytxRQmPVK9VXY3/ePKQ5lGRyJhT5DY8
2 changed files with 135 additions and 0 deletions

View File

@ -68,6 +68,9 @@ RUN mkdir -p $HOME/Desktop \
&& chmod +x $HOME/Desktop/*.desktop \ && chmod +x $HOME/Desktop/*.desktop \
&& chown -R 1000:1000 $HOME/Desktop && chown -R 1000:1000 $HOME/Desktop
# Copy OpenClaw setup guide to desktop
COPY --chown=1000:1000 OPENCLAW-SETUP.md $HOME/Desktop/
# Disable authentication but keep HTTPS # Disable authentication but keep HTTPS
RUN sed -i 's/vncserver/vncserver -SecurityTypes None -DisableBasicAuth 1/g' /dockerstartup/vnc_startup.sh \ RUN sed -i 's/vncserver/vncserver -SecurityTypes None -DisableBasicAuth 1/g' /dockerstartup/vnc_startup.sh \
&& sed -i 's/kasm_password_file:.*$/kasm_password_file:/g' /usr/share/kasmvnc/kasmvnc_defaults.yaml && sed -i 's/kasm_password_file:.*$/kasm_password_file:/g' /usr/share/kasmvnc/kasmvnc_defaults.yaml

132
OPENCLAW-SETUP.md Normal file
View File

@ -0,0 +1,132 @@
# OpenClaw Setup Guide
Welcome to Clawtainer! This desktop has OpenClaw Gateway pre-installed and running on port 18789.
## What is OpenClaw?
OpenClaw is an open-source AI agent orchestration platform that connects to AI provider APIs. The Gateway is already running in the background, but you need to configure it with your API keys.
## Quick Setup (Choose One)
### Option 1: Interactive Wizard (Recommended)
Open a terminal and run:
```bash
openclaw onboard
```
This will guide you through:
- Selecting your preferred AI models
- Entering API keys
- Configuring messaging channels (optional)
### Option 2: Web Interface
1. Open Firefox/Chromium in this desktop
2. Navigate to: `http://localhost:18789`
3. Click **Settings** in the Gateway UI
4. Add your API keys for desired providers
### Option 3: Manual Configuration
Create or edit `~/.openclaw/openclaw.json`:
```json
{
"models": {
"providers": {
"anthropic": {
"apiKey": "sk-ant-your-key-here"
},
"openai": {
"apiKey": "sk-your-key-here"
},
"google": {
"apiKey": "AIza-your-key-here"
}
}
}
}
```
Or use environment variables in `~/.bashrc`:
```bash
export ANTHROPIC_API_KEY="sk-ant-your-key-here"
export OPENAI_API_KEY="sk-your-key-here"
export GOOGLE_API_KEY="AIza-your-key-here"
```
## Get API Keys
You'll need API keys from at least one provider:
- **Anthropic (Claude)**: https://console.anthropic.com/
- Best for: Coding, analysis, long conversations
- Pricing: Pay-per-token, ~$3-15 per million tokens
- **OpenAI (GPT-4)**: https://platform.openai.com/api-keys
- Best for: General purpose, creative writing
- Pricing: Pay-per-token, varies by model
- **Google (Gemini)**: https://makersuite.google.com/app/apikey
- Best for: Free tier available, multimodal
- Pricing: Free tier + pay-per-token
- **OpenRouter**: https://openrouter.ai/keys
- Best for: Access to multiple models through one API
- Pricing: Varies by model selected
## Verify Setup
After adding keys, test the connection:
```bash
openclaw gateway status
```
Or visit `http://localhost:18789` to see the Gateway control panel.
## Pre-installed Tools
This desktop includes:
- **OpenClaw** - AI agent orchestration (port 18789)
- **Cursor** - AI-powered code editor
- **VS Code** - Microsoft Visual Studio Code
- **Antigravity** - Google's AI IDE with Gemini
- **Anthropic SDK** - Python library for Claude (`import anthropic`)
All tools have desktop shortcuts for easy access.
## Gateway Token
The OpenClaw Gateway is configured with token: `clawtainer`
You can change this by setting the `OPENCLAW_GATEWAY_TOKEN` environment variable when launching the container.
## Troubleshooting
**Gateway not responding?**
```bash
# Check if gateway is running
ps aux | grep openclaw
# Restart gateway
openclaw gateway restart
```
**API key not working?**
- Check that your API key has not expired
- Verify billing is enabled on the provider's platform
- Check for typos in the key
**Need help?**
- OpenClaw Docs: https://docs.openclaw.ai/
- OpenClaw GitHub: https://github.com/openclaw/openclaw
---
**Clawtainer** - https://colinknapp.com
Licensed under CC Attribution 4.0