# 🤖 Повний гайд: Запуск агента Helion на НОДА1

**Дата:** 2026-01-12  
**Мета:** Запустити Telegram бота Helion на НОДА1 через Gateway сервіс

---

## 📋 Що таке Helion?

**Helion** - це Telegram бот агент платформи Energy Union, який працює через Gateway сервіс.

**Характеристики:**
- **Token:** `8112062582:AAGS-HwRLEI269lDutLtAJTFArsIq31YNhE`
- **Bot ID:** `8112062582`
- **Prompt:** `gateway-bot/helion_prompt.txt`
- **Webhook:** `https://gateway.daarion.city/8112062582/telegram/webhook`
- **Роль:** Центральний інтелектуальний агент платформи Energy Union

**Сфери роботи:**
- Енергетичні технології (EcoMiner/SES-77, BioMiner, Biochar)
- Токеноміка (ENERGY, 1T, kWt, NFT)
- DAO governance (структура, голосування, ролі)
- Технічна документація та підтримка користувачів

---

## 🔧 Що потрібно для запуску

### 1. Gateway сервіс
Gateway-bot сервіс обробляє webhook запити від Telegram та маршрутизує їх до Router.

**Потрібно:**
- Gateway-bot контейнер запущений
- Порт 9300 відкритий
- З'єднання з Router (http://router:9102)
- З'єднання з Memory Service (http://memory-service:8000)

### 2. Змінні середовища
```bash
HELION_TELEGRAM_BOT_TOKEN=8112062582:AAGI7tPFo4gvZ6bfbkFu9miq5GdAH2_LvcM
HELION_NAME=Helion
HELION_PROMPT_PATH=/app/gateway-bot/helion_prompt.txt
```

### 3. Файли
- `gateway-bot/helion_prompt.txt` - системний prompt для Helion
- `gateway-bot/` - директорія з кодом Gateway
- `gateway-bot/Dockerfile` - Dockerfile для збірки

### 4. Залежності
- ✅ Router (вже працює на НОДА1)
- ⚠️ Memory Service (потрібно перевірити)
- ✅ NATS (вже працює на НОДА1)

---

## 🚀 План дій

### Крок 1: Перевірити наявність Gateway на НОДА1
```bash
ssh root@144.76.224.179
ls -la /opt/microdao-daarion/gateway-bot/
```

### Крок 2: Додати Gateway в docker-compose.node1.yml
Потрібно додати сервіс `gateway` до `docker-compose.node1.yml`:

```yaml
gateway:
  build:
    context: ./gateway-bot
    dockerfile: Dockerfile
  container_name: dagi-gateway-node1
  ports:
    - "9300:9300"
  environment:
    - ROUTER_URL=http://router:9102
    - HELION_TELEGRAM_BOT_TOKEN=8112062582:AAGS-HwRLEI269lDutLtAJTFArsIq31YNhE
    - HELION_NAME=Helion
    - HELION_PROMPT_PATH=/app/gateway-bot/helion_prompt.txt
    - MEMORY_SERVICE_URL=http://memory-service:8000
  volumes:
    - ./gateway-bot:/app/gateway-bot:ro
    - ./logs:/app/logs
  depends_on:
    - router
  networks:
    - dagi-network
  restart: unless-stopped
  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:9300/health"]
    interval: 30s
    timeout: 10s
    retries: 3
```

### Крок 3: Завантажити gateway-bot на НОДА1
Якщо gateway-bot немає на НОДА1, потрібно завантажити:
```bash
# З локальної машини
scp -r gateway-bot root@144.76.224.179:/opt/microdao-daarion/
```

### Крок 4: Запустити Gateway
```bash
ssh root@144.76.224.179
cd /opt/microdao-daarion
docker compose -f docker-compose.node1.yml up -d gateway
```

### Крок 5: Перевірити статус
```bash
docker ps | grep gateway
curl http://localhost:9300/health
```

### Крок 6: Налаштувати Telegram webhook
```bash
curl -X POST "https://api.telegram.org/bot8112062582:AAGS-HwRLEI269lDutLtAJTFArsIq31YNhE/setWebhook" \
  -d "url=https://gateway.daarion.city/8112062582/telegram/webhook"
```

---

## 📝 Детальна інформація

### Gateway архітектура
- Gateway приймає webhook запити від Telegram
- Маршрутизує їх до Router через `/route` endpoint
- Router обробляє запити та повертає відповіді
- Gateway відправляє відповіді назад в Telegram

### Helion інтеграція
- Helion використовує той самий Gateway, що й DAARWIZZ
- Відрізняється тільки токеном та prompt файлом
- Може працювати одночасно з іншими ботами

---

## ⚠️ Потенційні проблеми

### 1. Memory Service не запущений
Якщо Memory Service не запущений, Gateway все одно працюватиме, але без збереження пам'яті.

### 2. Router недоступний
Gateway не зможе маршрутизувати запити, потрібно перевірити Router.

### 3. Webhook не налаштований
Telegram не зможе надсилати повідомлення, потрібно налаштувати webhook.

---

**Оновлено:** 2026-01-12