# 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