Quick Start

Запуск проекта за 5 шагов

Время выполнения: ~10-15 минут

Требования

Docker Desktop
Контейнеризация всех сервисов
Docker Compose
Оркестрация сервисов
Git
Клонирование репозитория
8GB RAM (min)
Минимальные требования
20GB disk
Для образов и данных
Telegram Bot Token
От @BotFather
Установка для macOS:
brew install --cask docker && brew install git

Шаги установки

1

Клонировать репозиторий

Получить исходный код проекта

git clone <repo-url> clowbot
cd clowbot
Verify: ls -la | grep docker-compose.yml
2

Создать .env из примера

Скопировать шаблон конфигурации

cp .env.example .env
nano .env # или vim, code, etc.
Verify: cat .env | head -5
3

Настроить TELEGRAM_BOT_TOKEN

Получить токен у @BotFather в Telegram

# 1. Откройте @BotFather в Telegram
# 2. Отправьте /newbot
# 3. Следуйте инструкциям
# 4. Скопируйте токен в .env:
TELEGRAM_BOT_TOKEN=1234567890:ABCdefGHI...
Verify: grep TELEGRAM_BOT_TOKEN .env
4

Запустить сервисы

Поднять все Docker контейнеры

# Первый запуск (скачает образы)
docker-compose up -d
# Следить за логами
docker-compose logs -f bot
Verify: docker-compose ps
5

Проверить статус

Убедиться что все сервисы работают

# Проверить здоровье бота
curl http://localhost:28000/health
# Проверить БД
docker-compose exec postgres psql -U clowbot -c 'SELECT 1'
Verify: Все сервисы status=running
6

Протестировать в Telegram

Отправить первые команды боту

# Откройте ваш бот в Telegram
# Отправьте /start
# Должен прийти приветственный ответ
Verify: Бот отвечает на /start

Сервисы и порты

bot
28000
Python/FastAPI бот
postgres
25432
PostgreSQL БД
n8n
25678
Workflow automation
ollama
21435
LLM inference
prometheus
29090
Metrics

Health Checks

ServiceCommandExpected
Bot Healthcurl http://localhost:28000/health{"status":"ok"}
Databasedocker-compose exec postgres pg_isreadyaccepting connections
Ollamacurl http://localhost:21435/api/tags{"models": [...]}
n8ncurl http://localhost:25678/healthzok
Prometheuscurl http://localhost:29090/-/healthyPrometheus is Healthy

Первые команды в Telegram

/start

Запуск и приветствие

Привет! Я clowbot...
/help

Список всех команд

Доступные команды: /start /help ...
/status

Статус системы

Bot: OK DB: OK Ollama: OK
/settings

Настройки пользователя

Model: phi4-mini Language: ru
/promode

Включить Pro Mode

Pro Mode активирован
/web <query>

Web поиск

Результаты поиска...

Конфигурация (.env)

KeyRequiredDefaultDescription
TELEGRAM_BOT_TOKENrequired-Токен от @BotFather
DEFAULT_MODELoptionalphi4-miniМодель LLM по умолчанию
OLLAMA_MODEoptionaldockerРежим Ollama: docker или host
POSTGRES_PORToptional25432Порт PostgreSQL
N8N_PORToptional25678Порт n8n
BOT_PORToptional28000Порт бота
TZoptionalAsia/BangkokЧасовой пояс

Типичные проблемы

ПроблемаРешениеSeverity
port already in useИзменить порт в .env (POSTGRES_PORT, N8N_PORT, BOT_PORT)medium
ollama connection refusedПодождать 30 сек, Ollama стартует долго. Проверить ollama logs.low
bot not respondingПроверить TELEGRAM_BOT_TOKEN в .env. Перезапустить: docker-compose restart bothigh
migration failedПроверить логи: docker-compose logs postgres. Удалить volume: docker-compose down -vhigh
out of memoryУвеличить Docker memory limit в Docker Desktop Settingsmedium
permission deniedНа Linux: sudo chown -R $USER:$USER .low

Полезные команды

Docker:

# Статус сервисов
docker-compose ps

# Логи
docker-compose logs -f bot
docker-compose logs --tail=100 postgres

# Перезапуск
docker-compose restart bot

# Полный пересборка
docker-compose down && docker-compose up -d --build

# Удалить volumes (ВНИМАНИЕ!)
docker-compose down -v

Database:

# Подключиться к БД
docker-compose exec postgres psql -U clowbot

# Список таблиц
\dt clowbot.*

# Размер БД
SELECT pg_size_pretty(pg_database_size('clowbot'));

# Backup
docker-compose exec postgres pg_dump -U clowbot clowbot > backup.sql

Следующие шаги

1
Architecture Overview
Понять архитектуру платформы
2
Database Schema
Изучить структуру БД
3
Agent Profiles
Как работают агенты
4
Process System
Система процессов
5
Operator Plane
Операторский уровень
6
Platform Constitution
Правила платформы
← Wiki HomeFull Installation Guide