133 lines
3.1 KiB
Markdown
133 lines
3.1 KiB
Markdown
# 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
|