Docker Deployment

Overview

Docker provides the easiest way to deploy Clawdbot with consistent environments and simple updates.

Quick Start

# Pull and run
docker run -d \
  --name clawdbot \
  -e ANTHROPIC_API_KEY=your_key \
  -e TELEGRAM_BOT_TOKEN=your_token \
  ghcr.io/polvoazul/clawdbot:latest

Docker Compose

Create docker-compose.yml:

version: '3.8'

services:
  clawdbot:
    image: ghcr.io/polvoazul/clawdbot:latest
    container_name: clawdbot
    restart: unless-stopped
    env_file:
      - .env
    volumes:
      - ./data:/app/data
      - ./config:/app/config
    ports:
      - "8080:8080"  # If using webhooks

Start:

docker-compose up -d

Configuration

Environment Variables

Create .env file:

ANTHROPIC_API_KEY=sk-ant-xxxxx
TELEGRAM_ENABLED=true
TELEGRAM_BOT_TOKEN=xxxxx
LOG_LEVEL=INFO

Volume Mounts

Mount	Purpose
`/app/data`	Persistent data (sessions, etc.)
`/app/config`	Configuration files
`/app/logs`	Log files

Building Custom Image

FROM ghcr.io/polvoazul/clawdbot:latest

# Add custom plugins
COPY my-plugins/ /app/plugins/

# Custom configuration
COPY config.yaml /app/config/

Build:

docker build -t my-clawdbot .

Management

# View logs
docker logs -f clawdbot

# Restart
docker restart clawdbot

# Update
docker pull ghcr.io/polvoazul/clawdbot:latest
docker-compose up -d

# Shell access
docker exec -it clawdbot /bin/bash

Multi-Architecture

Images available for:

linux/amd64
linux/arm64 (Raspberry Pi 4, Apple Silicon)

Troubleshooting

Container exits immediately

docker logs clawdbot
# Check for configuration errors

Permission issues

# Fix volume permissions
sudo chown -R 1000:1000 ./data ./config

Network issues

# Verify DNS resolution
docker exec clawdbot ping api.anthropic.com