# Optimizacija Multi-Agent AI Sustava za OpenClaw Platformu

**Datum istraživanja:** 10. veljače 2026.  
**Istraživač:** Alex (sub-agent)  
**Cilj:** Best practice za multi-agent AI sustave i optimizacija postojećeg tima agenata

---

## 📋 Pregled Tima

| Agent | Model | Uloga | Trenutni Skills |
|-------|-------|-------|-----------------|
| **Aladin** | Claude Opus 4.6 | Orkestrator | bird, check-network, lan-scanner, mikrotik-monitor, reddit-cli, reddit-readonly |
| **Alex** | Kimi K2P5 | Istraživač | tavily, tavily-search-pro, web-search-pro, brave-images, summarize, blogwatcher, bird, reddit-readonly |
| **Spider** | Kimi K2P5 | Mrežni inženjer | camsnap, check-network, healthcheck, lan-scanner, mikrotik-monitor, ping-device |
| **Matrix** | Kimi K2P5 | Developer | coding-agent, github, tmux, code-review |
| **Leo** | Kimi K2P5 | Marketing | ad-copy, notion, reddit-cli, trello |
| **Georga** | GPT-5.2 | Dizajner | openai-image-gen, canvas, video-frames, nano-pdf |

---

## 1. Multi-Agent Orchestration Best Practices

### 1.1 Kada Koristiti Sub-Agenta vs Raditi Sam

| Scenarij | Preporuka | Razlog |
|----------|-----------|--------|
| Jednostavan upit s jasnim kontekstom | **Direktno** | Izbjegava overhead sub-agent sesije (~500-1000 tokena) |
| Kompleksni zadatak s više koraka | **Sub-agent** | Bolja organizacija i ponovna upotreba rezultata |
| Istraživanje s više izvora | **Sub-agent** | Paralelizacija i specijalizacija |
| Rutinska provjera statusa | **Direktno** | Brže, manja latencija |
| Kritični zadaci za koje treba audit trail | **Sub-agent** | Izolirani logovi za reproducibilnost |

**Pravilo palca:** Ako zadatak zahtijeva:
- Više od 3 različite alate → **sub-agent**
- Potencijalno pogrešno izvršenje može uzrokovati probleme → **sub-agent**
- Jednostavan lookup ili status check → **direktno**

### 1.2 Chain-of-Agents vs Parallel Execution

#### Sequential (Chain) Pattern
```
Korisnik → Aladin → Alex (istraživanje) → Matrix (implementacija) → Aladin (odgovor)
```

**Kada koristiti:**
- Zadaci s linearnim ovisnostima (istraživanje → analiza → izvještaj)
- Progressive refinement (draft → review → final)
- Compliance workflows gdje svaki korak mora biti validiran

**Prednosti:**
- Predvidljiv tijek rada
- Jednostavno debugiranje
- Jasna odgovornost na svakom koraku

**Nedostaci:**
- Kumulativna latencija
- Nema fault tolerance (ako jedan agent padne, cijeli lanac stane)

#### Concurrent (Parallel) Pattern
```
              ┌→ Alex (web search)
Korisnik → Aladin ┼→ Spider (mrežna provjera)
              └→ Matrix (code review)
              → Agregacija rezultata
```

**Kanda koristiti:**
- Nezavisne provjere (security scan + performance test + code review)
- Multi-perspective analysis (technical + business + creative)
- Time-sensitive scenariji

**Prednosti:**
- Manja ukupna latencija
- Fault tolerance (jedan agent može pasti bez utjecaja na ostale)
- Diverse insights

**Nedostaci:**
- Kompleksnija agregacija rezultata
- Potencijalno duplicirani rad

#### Preporuka za OpenClaw:
- **Hibridni pristup** - Koristiti sequential za kritične točke odlučivanja, parallel za nezavisne provjere
- Aladin treba odlučiti o strategiji unutar prvog poziva na temelju kompleksnosti zadatka

### 1.3 Token Optimizacija Strategije

Prema istraživanjima iz 2025, token potrošnja može varirati i do **200%** ovisno o orkestracijskom patternu.

| Strategija | Ušteda | Implementacija |
|------------|--------|----------------|
| Prompt caching | 50-90% | Claude podržava prompt caching - ponovno korištenje sistemskih instrukcija |
| Context pruning | 30-50% | Uklanjanje nebitnog povijesnog konteksta nakon N poruka |
| Sub-agent sažeci | 60-80% | Sub-agent vraća sažetak umjesto raw outputa |
| Structured outputs | 20-40% | Definirani output formati smanjuju "razmišljanje" |
| Dynamic tool discovery | 100x | Učitavanje samo potrebnih alata umjesto svih |

**Konkretne preporuke:**
1. **Sub-agent sesije:** Ograničiti na 3-5 iteracija maksimalno
2. **Context handoff:** Proslijediti samo relevantni kontekst između agenata
3. **Summary pattern:** Alex treba vraćati strukturirane sažetke umjesto raw weba
4. **System prompt optimization:** Smanjiti system promptove na minimum (svaki token se računa)

---

## 2. Per-Agent Optimizacija

### 2.1 Preporučeni Dodatni Skills po Agentu

#### Aladin (Orkestrator) - PRIORITET: HIGH

| Skill | Svrha | Izvor |
|-------|-------|-------|
| `gog` | Google Workspace integracija (Gmail, Calendar) | clawhub.com/skills/gog |
| `himalaya` | IMAP/SMTP email upravljanje | clawhub.com/skills/himalaya |
| `session-logs` | Analiza vlastitih logova | već dostupno |
| `model-usage` | Praćenje troškova po modelu | clawhub.com/skills/model-usage |
| `obsidian` | Knowledge base management | clawhub.com/skills/obsidian |

**Razlog:** Aladin treba imati pristup korisnikovim komunikacijskim kanalima (email) i mora moći analizirati vlastitu učinkovitost.

#### Alex (Istraživač) - PRIORITET: MEDIUM

| Skill | Svrha | Izvor |
|-------|-------|-------|
| `perplexity` | AI-powered web search s citatima | clawhub.com/skills/perplexity |
| `exa-web-search-free` | Free web search alternative | clawhub.com/skills/exa-web-search-free |
| `github` | Pristup kodu za tehničko istraživanje | clawhub.com/skills/github |
| `supabase` | Pohrana istraživačkih rezultata | clawhub.com/skills/supabase |
| `skill-creator` | Kreiranje novih skills po potrebi | već dostupno |

**Razlog:** Trenutni skills su dobri, ali dodatni search provideri daju redundancy i različite perspektive.

#### Spider (Mrežni inženjer) - PRIORITET: HIGH

| Skill | Svrha | Izvor |
|-------|-------|-------|
| `docker` / `portainer` | Container management | awesome-openclaw-skills |
| `supabase` ili `postgres` | Logiranje događaja u bazu | clawhub.com/skills/supabase |
| `notify` | Push notifikacije za kritične alarme | OpenClaw built-in |
| Custom Dahua skill | Direktna kamera integracija | Treba razviti |
| Custom MikroTik API skill | Napredni router management | Treba razviti |

**Razlog:** Trenutni skills su osnovni. Za produkcijsku upotrebu potrebni su napredniji alati za monitoring i automatizaciju.

#### Matrix (Developer) - PRIORITET: MEDIUM

| Skill | Svrha | Izvor |
|-------|-------|-------|
| `vercel` | Deployment management | clawhub.com/skills/vercel |
| `github-pr` | PR management | clawhub.com/skills/github-pr |
| `coding-agent` | Već dostupan, ali proširiti | - |
| `app-store-changelog` | Generiranje release notes | clawhub.com/skills/app-store-changelog |
| `docker` | Container development | awesome-openclaw-skills |

#### Leo (Marketing) - PRIORITET: LOW

| Skill | Svrha | Izvor |
|-------|-------|-------|
| `bird` | Već dostupan - proširiti | - |
| `search-x` | X/Twitter search | clawhub.com/skills/search-x |
| `moltbook` | Social media za AI agente | clawhub.com/skills/moltbook |
| `gamma` | AI presentation generation | awesome-openclaw-skills |

#### Georga (Dizajner) - PRIORITET: LOW

| Skill | Svrha | Izvor |
|-------|-------|-------|
| `nano-banana-pro` | Napredna image generacija | clawhub.com/skills/nano-banana-pro |
| `ui-ux-pro-max` | UI/UX design guidance | clawhub.com/skills/ui-ux-pro-max |
| `ui-audit` | Automatizirani UI review | clawhub.com/skills/ui-audit |

### 2.2 Model Optimizacija - Cost vs Performance

Prema istraživanju cijena iz 2025:

| Model | Input (per 1M) | Output (per 1M) | Preporučena upotreba |
|-------|---------------|-----------------|---------------------|
| **Claude Opus 4.6** | ~$15 | ~$75 | Orkestracija, kompleksno odlučivanje |
| **Claude Sonnet 4.5** | ~$3 | ~$15 | Balansirani zadaci |
| **Claude Haiku** | ~$0.25 | ~$1.25 | Jednostavni taskovi, high-volume |
| **Kimi K2.5** | ~$0.50-1.00 | ~$2-4 | Dobar za sub-agente (trenutno korištenje ispravno) |
| **GPT-4o** | ~$2.50 | ~$10 | General purpose |
| **GPT-5 mini** | ~$0.15 | ~$0.60 | Jednostavni taskovi |
| **DeepSeek V3.2** | ~$0.28 | ~$0.42 | Najjeftiniji za high-volume |

**Preporuke:**

1. **Aladin (Orkestrator):** Ostati na Claude Opus 4.6 - orkestracija zahtijeva najbolji model
2. **Alex, Spider, Matrix, Leo:** Kimi K2P5 je optimalan izbor - dobar omjer cijene i kvalitete
3. **Georga:** GPT-5.2 je OK za dizajn, ali razmotriti Claude Sonnet za image generation taskove

**Cost-saving strategija:**
- Za rutinske heartbeat checkove → koristiti jeftiniji model (Haiku ili GPT-mini)
- Za prvu klasifikaciju zadatka → koristiti jeftiniji model
- Samo za kompleksne zadatke delegirati na skuplje modele

---

## 3. Workflow Automatizacija

### 3.1 Cron Jobs za Periodične Zadatke

**Preporučeni cron patterni:**

| Zadatak | Frekvencija | Odgovoran Agent | Model |
|---------|-------------|-----------------|-------|
| Network health check | Svakih 15 min | Spider | Kimi K2P5 |
| Security camera status | Svakih 30 min | Spider | Kimi K2P5 |
| MikroTik bandwidth report | Svaki sat | Spider | Kimi K2P5 |
| Email inbox triage | Svakih 10 min | Aladin | Claude Haiku (za uštedu) |
| Daily briefing | 06:47 | Aladin | Claude Opus |
| Weekly security scan | Nedjelja 02:00 | Spider + Matrix | Kimi K2P5 |
| GitHub repo sync | Svakih 5 min | Matrix | Kimi K2P5 |

### 3.2 Heartbeat Monitoring Best Practice

Prema OpenClaw dokumentaciji i Azure/AWS best practices:

**Struktura HEARTBEAT.md:**
```markdown
## Daily Checks (rotirati)
- [ ] Email (high priority only)
- [ ] Calendar (nadolazeći događaji <2h)
- [ ] Network status (router + kamere)
- [ ] Disk space / backups
- [ ] GitHub notifications

## Frequency Guide
- Email: 4x dnevno (09:00, 12:00, 15:00, 18:00)
- Network: Kontinuirano (putem Spider sub-agenta)
- Calendar: Svakih 30 min
- Backups: Jednom dnevno
```

**State tracking:**
```json
{
  "lastChecks": {
    "email": 1703275200,
    "calendar": 1703260800,
    "network": 1703275800,
    "backup": 1703189400
  },
  "alertThresholds": {
    "cameraOffline": 5,
    "highLatency": 100
  }
}
```

### 3.3 Rutinska Task Automatizacija

| Task | Automatizacija | Implementacija |
|------|----------------|----------------|
| **Email check** | Gmail Pub/Sub + gog skill | Push notifikacije umjesto polling |
| **Security scan** | Spider s custom skriptama | Nmap + MikroTik API |
| **Backup monitoring** | Windows Server Event Log parsing | PowerShell + OpenClaw exec |
| **Camera recording check** | Dahua HTTP API polling | Custom skill |
| **Disk space alerts** | Windows WMI queries | Svakih 30 min |

---

## 4. Skill Gaps - Što Nedostaje

### 4.1 Kritični Gaps - PRIORITET: HIGH

| Skill | Opis | Predloženo rješenje |
|-------|------|---------------------|
| **Email/Calendar** | `gog` skill postoji - treba instalirati | `clawhub install gog` |
| **Dahua Camera API** | Direktna integracija s kamerama | Razviti custom skill ili koristiti ONVIF |
| **MikroTik napredni** | Trenutno je osnovni - treba API wrapper | Razviti skill za RouterOS API |
| **Database** | `supabase` postoji, ali treba i lokalna opcija | PostgreSQL/MySQL skill |

### 4.2 Medium Priority

| Skill | Opis | Predloženo rješenje |
|-------|------|---------------------|
| **Docker** | Container management | Postoji u awesome listi |
| **Windows Server** | Event log, WMI, PowerShell | Custom skill |
| **CI/CD Pipeline** | GitHub Actions, itd. | Proširiti github skill |
| **Home Automation** | IoT integracija | OpenHue postoji, proširiti |

### 4.3 Low Priority / Nice to Have

| Skill | Opis |
|-------|------|
| **Slack** | Već postoji u clawhub |
| **Voice call** | Postoji kao skill |
| **TTS/STT** | `sag`, `openai-whisper` dostupni |

### 4.4 Dostupni Skills na ClawHub (Relevantni)

Iz awesome-openclaw-skills liste:
- **gog** - Google Workspace (Gmail, Calendar, Drive, Sheets, Docs) ⭐ 131
- **github** - GitHub CLI integracija ⭐ 78
- **supabase** - Database + vector search ⭐ 360
- **notion** - Project management ⭐ 64
- **trello** - Task management ⭐ 38
- **obsidian** - Knowledge base ⭐ 65
- **docker/portainer** - Container management
- **himalaya** - Email IMAP/SMTP ⭐ 50

---

## 5. Konkretne Preporuke za Vaš Use Case

### 5.1 Mali Ured/Firma Setup

**Infrastruktura:**
- IP kamere (Dahua) + MikroTik router + Windows Server
- Telegram za komunikaciju
- Fokus na autonomiju

**Preporučena arhitektura:**

```
┌─────────────────────────────────────────────────────────────┐
│                      Aladin (Claude Opus)                   │
│                    - Orkestracija                           │
│                    - Korisnički interface                   │
│                    - Email/Calendar (gog)                   │
└───────────────────────┬─────────────────────────────────────┘
                        │
        ┌───────────────┼───────────────┐
        │               │               │
        ▼               ▼               ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Alex (Kimi)  │ │ Spider(Kimi) │ │ Matrix(Kimi) │
│ Istraživanje │ │ Mreža        │ │ Development  │
│ - tavily     │ │ - camsnap    │ │ - github     │
│ - web search │ │ - mikrotik   │ │ - coding     │
└──────────────┘ └──────────────┘ └──────────────┘
                        │
                        ▼
               ┌──────────────┐
               │ Georga       │
               │ (GPT-5.2)    │
               │ Dizajn       │
               └──────────────┘
```

### 5.2 Implementacijski Plan

**Faza 1: Foundation (1-2 tjedna) - HIGH PRIORITY**
1. Instalirati `gog` skill za Aladina (email/calendar)
2. Postaviti heartbeat monitoring (HEARTBEAT.md)
3. Konfigurirati cron jobs za osnovne provjere
4. Postaviti state tracking (memory/heartbeat-state.json)

**Faza 2: Mrežna Automatizacija (2-3 tjedna) - HIGH PRIORITY**
1. Razviti custom Dahua skill za direktnu kameru integraciju
2. Proširiti mikrotik-monitor skill s RouterOS API
3. Postaviti automated alerte (offline kamere, high latency)
4. Implementirati security scanning workflow

**Faza 3: Napredna Automatizacija (3-4 tjedna) - MEDIUM PRIORITY**
1. Instalirati `supabase` ili PostgreSQL skill za logiranje
2. Postaviti Windows Server monitoring (event logs, disk space)
3. Implementirati backup monitoring
4. Kreirati daily briefing automatizaciju

**Faza 4: Optimizacija (ongoing) - LOW PRIORITY**
1. Podešavanje modela na temelju stvarne potrošnje
2. Prompt caching implementacija
3. Context pruning optimizacija
4. Evaluacija i tuning sub-agent strategija

### 5.3 Telegram Integracija

Matko koristi Telegram - optimizirano za taj kanal:

| Feature | Implementacija |
|---------|----------------|
| Daily briefing | Automatsko slanje u 06:47 |
| Critical alerts | Odmah (camera offline, security) |
| Command interface | `/status`, `/check`, `/report` |
| Rich formatiranje | Koristiti bold, code blocks, emojis |
| Buttons | Inline buttons za brze akcije |

---

## 6. Cost Optimizacija

### 6.1 Kada Koristiti Koji Model

| Scenarij | Model | Procjena uštede |
|----------|-------|-----------------|
| Heartbeat checkovi | Haiku/GPT-mini | 90% |
| Prva klasifikacija zadatka | Kimi/GPT-4o-mini | 70% |
| Istraživanje (Alex) | Kimi K2P5 | 50% vs Opus |
| Mrežni monitoring | Kimi K2P5 | 50% vs Opus |
| Orkestracija | Claude Opus 4.6 | - |
| Code review | Kimi K2P5 ili Sonnet | 60% |

### 6.2 Token Usage Minimizacija

**Strategije:**

1. **Prompt Caching (Claude)**
   - Sistemski promptovi se cache-iraju
   - Ušteda: 50-90% na input tokenima
   - Zahtijeva ponavljajuće iste promptove

2. **Context Pruning**
   ```python
   # Nakon 10 poruka, sažeti povijest
   if message_count > 10:
       summary = generate_summary(messages)
       messages = [system_msg, summary, last_2_msgs]
   ```

3. **Sub-Agent Output Format**
   - Alex vraća strukturirani JSON umjesto raw teksta
   - Spider vraća samo anomalije, ne "sve OK"
   - Matrix vraća diff + summary

4. **Tool Call Optimization**
   - Batch tool calls kada je moguće
   - Koristiti `parallel_tool_calls: true`

### 6.3 Procjena Mjesečnih Troškova

| Scenarij | Procjena dnevno | Mjesečno |
|----------|-----------------|----------|
| **Conservative** (Haiku za rutinske, Opus samo za kritično) | $2-3 | $60-90 |
| **Balanced** (Kimi za sub-agente, Opus za orkestraciju) | $5-8 | $150-240 |
| **Current** (Sve na Kimi/Opus bez optimizacije) | $10-15 | $300-450 |

**Cilj:** Balanced scenarij s automatskim fallbackom na jeftinije modele za rutinske zadatke.

---

## 7. Konkretni Linkovi i Resursi

### 7.1 Skills - Direktni Linkovi

| Skill | URL | Prioritet |
|-------|-----|-----------|
| gog (Google Workspace) | https://clawhub.com/skills/gog | HIGH |
| himalaya (Email) | https://clawhub.com/skills/himalaya | HIGH |
| github | https://clawhub.com/skills/github | MEDIUM |
| supabase (DB) | https://clawhub.com/skills/supabase | HIGH |
| perplexity | https://clawhub.com/skills/perplexity | MEDIUM |
| model-usage | https://clawhub.com/skills/model-usage | MEDIUM |
| notion | https://clawhub.com/skills/notion | MEDIUM |
| obsidian | https://clawhub.com/skills/obsidian | LOW |

### 7.2 Awesome OpenClaw Skills
- GitHub: https://github.com/sundial-org/awesome-openclaw-skills

### 7.3 Reference Materijali
- OpenAI Multi-Agent: https://openai.github.io/openai-agents-python/multi_agent/
- Azure AI Patterns: https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/ai-agent-design-patterns
- Multi-Agent Best Practices: https://collabnix.com/multi-agent-orchestration-patterns-and-best-practices-for-2024/
- Kore.ai Patterns: https://www.kore.ai/blog/choosing-the-right-orchestration-pattern-for-multi-agent-systems

---

## 8. Sažetak Preporuka po Prioritetu

### 🔴 HIGH (Implementirati odmah)
1. Instalirati `gog` skill za Aladina (email/calendar integracija)
2. Kreirati HEARTBEAT.md s rutinskim provjerama
3. Postaviti cron jobs za network monitoring (Spider)
4. Implementirati context pruning za smanjenje tokena

### 🟡 MEDIUM (Sljedeća faza)
1. Razviti custom Dahua kamera skill
2. Proširiti MikroTik integraciju s RouterOS API
3. Instalirati `supabase` za logiranje događaja
4. Postaviti Windows Server monitoring

### 🟢 LOW (Nice to have)
1. Proširiti Leo s dodatnim marketing skills
2. UI/UX skills za Georgu
3. Advanced CI/CD integracija
4. Voice capabilities (TTS/STT)

---

## 9. Mjerenje Uspjeha (KPIs)

| Metrika | Cilj | Trenutno |
|---------|------|----------|
| Token cost per day | <$5 | ? |
| Average response time | <30s za obične zadatke | ? |
| Camera offline detection | <5 min | ? |
| Email response time | <2h za high priority | ? |
| False positive rate | <5% | ? |
| User satisfaction | >4/5 | ? |

---

**Izvještaj pripremio:** Alex (Istraživač)  
**Datum:** 10. veljače 2026.  
**Verzija:** 1.0