| .. | ||
| clawdbot | ||
| README.md | ||
Runtipi App Configuration
This directory contains the Runtipi app configuration for Clawdbot.
Directory Structure
runtipi/
└── clawdbot/
├── config.json # App metadata and form fields
├── docker-compose.yml # Docker Compose configuration
└── metadata/
├── description.md # App description for the store
└── logo.png # App logo (128x128)
Using with Runtipi
Option 1: Add to Custom App Store
- Fork or create your own Runtipi app store repository
- Copy the
clawdbot/directory to your app store'sapps/folder - Add your app store URL to Runtipi settings
Option 2: Local Installation
- Copy the
clawdbot/directory to your Runtipi'suser-config/folder - Restart Runtipi to detect the new app
Prerequisites
Before installing Clawdbot on Runtipi, ensure you have:
-
At least one AI provider API key:
- Anthropic API key (for Claude models)
- OpenAI API key (for GPT models)
- Google Gemini API key
- OpenRouter API key (for multiple providers)
-
A gateway token for API authentication:
openssl rand -hex 32 -
(Optional) Messaging channel tokens:
- Telegram bot token from @BotFather
- Discord bot token from the Developer Portal
- Slack bot and app tokens
Docker Image
This configuration uses the official Clawdbot Docker image from GitHub Container Registry:
ghcr.io/clawdbot/clawdbot:VERSION
To build and push your own image:
# From the clawdbot repository root
docker build -t ghcr.io/YOUR_ORG/clawdbot:latest .
docker push ghcr.io/YOUR_ORG/clawdbot:latest
Then update the image reference in docker-compose.json.
Ports
| Port | Purpose |
|---|---|
| 18789 | Gateway HTTP/WebSocket (main) |
Volumes
| Container Path | Purpose |
|---|---|
| /home/node/.clawdbot | Configuration and sessions |
| /home/node/clawd | Agent workspace |
Post-Installation
After installation:
- Access the control UI at
http://YOUR_SERVER:18789 - Configure additional channels via the UI or by editing
config/clawdbot.json - For WhatsApp: pair via QR code in the control UI