Config policies (16 files): alert_routing, architecture_pressure, backlog, cost_weights, data_governance, incident_escalation, incident_intelligence, network_allowlist, nodes_registry, observability_sources, rbac_tools_matrix, release_gate, risk_attribution, risk_policy, slo_policy, tool_limits, tools_rollout Ops (22 files): Caddyfile, calendar compose, grafana voice dashboard, deployments/incidents logs, runbooks for alerts/audit/backlog/incidents/sofiia/voice, cron jobs, scripts (alert_triage, audit_cleanup, migrate_*, governance, schedule), task_registry, voice alerts/ha/latency/policy Docs (30+ files): HUMANIZED_STEPAN v2.7-v3 changelogs and runbooks, NODA1/NODA2 status and setup, audit index and traces, backlog, incident, supervisor, tools, voice, opencode, release, risk, aistalk, spacebot Made-with: Cursor
99 lines
2.9 KiB
Markdown
99 lines
2.9 KiB
Markdown
# Spacebot — Sofiia Telegram Agent
|
||
|
||
Spacebot — це Rust-based multi-agent framework від Spacedrive. Використовується як Telegram-фронтенд для агента Sofiia в екосистемі DAARION.
|
||
|
||
- GitHub: https://github.com/spacedriveapp/spacebot
|
||
- Версія: v0.1.15
|
||
- Telegram bot: @SofiiaDaarionbot
|
||
|
||
## Архітектура
|
||
|
||
```
|
||
[Telegram] ←→ [Spacebot (Rust)] ←→ [GLM-5 / Grok 4.1]
|
||
↕
|
||
LanceDB (vector memory)
|
||
SOUL.md / IDENTITY.md / USER.md
|
||
```
|
||
|
||
## Встановлення (перший раз)
|
||
|
||
### Залежності
|
||
|
||
```bash
|
||
brew install rust protobuf cmake
|
||
curl -fsSL https://bun.sh/install | bash
|
||
```
|
||
|
||
### Збірка з вихідного коду
|
||
|
||
```bash
|
||
git clone --depth=1 https://github.com/spacedriveapp/spacebot.git ~/github-projects/spacebot
|
||
cd ~/github-projects/spacebot
|
||
cargo build --release # ~7-20 хвилин
|
||
```
|
||
|
||
### Конфіг
|
||
|
||
```bash
|
||
mkdir -p ~/.spacebot
|
||
cp docs/spacebot/config.toml.example ~/.spacebot/config.toml
|
||
# Відредагуй ~/.spacebot/config.toml — виправ модель і ключі якщо потрібно
|
||
```
|
||
|
||
Ключі зберігаються в `.env` проекту:
|
||
- `SOFIIA_TELEGRAM_BOT_TOKEN` — токен бота @SofiiaDaarionbot
|
||
- `ZHIPU_API_KEY` / `GLM5_API_KEY` — GLM-5 (Zhipu AI)
|
||
- `XAI_API_KEY` — Grok (xAI), fallback
|
||
|
||
### Ідентичність агента
|
||
|
||
Файли в `~/.spacebot/agents/sofiia/workspace/`:
|
||
- `IDENTITY.md` — хто такий агент, контекст DAARION, засновник
|
||
- `SOUL.md` — стиль спілкування, мова, межі
|
||
- `USER.md` — інформація про Повелителя Хаосу / Іван Титар
|
||
|
||
## Управління
|
||
|
||
```bash
|
||
# Запуск
|
||
./ops/scripts/start_spacebot.sh start
|
||
|
||
# Статус
|
||
./ops/scripts/start_spacebot.sh status
|
||
|
||
# Live логи
|
||
./ops/scripts/start_spacebot.sh logs
|
||
|
||
# Перезапуск (після змін конфігу або identity файлів)
|
||
./ops/scripts/start_spacebot.sh restart
|
||
|
||
# Зупинка
|
||
./ops/scripts/start_spacebot.sh stop
|
||
```
|
||
|
||
## Важливо перед запуском
|
||
|
||
Якщо бот раніше використовував webhook (наприклад через gateway.daarion.city), треба видалити його:
|
||
|
||
```bash
|
||
source .env
|
||
curl "https://api.telegram.org/bot${SOFIIA_TELEGRAM_BOT_TOKEN}/deleteWebhook?drop_pending_updates=true"
|
||
```
|
||
|
||
## Моделі (поточні)
|
||
|
||
| Призначення | Модель | Provider |
|
||
|-------------|--------|----------|
|
||
| channel (чат) | glm-5 | Zhipu AI |
|
||
| branch (задачі) | glm-5 | Zhipu AI |
|
||
| worker (фон) | glm-4.5-air | Zhipu AI |
|
||
| cortex (память) | glm-4.7 | Zhipu AI |
|
||
| fallback | grok-4-1 / grok-4-1-mini | xAI |
|
||
|
||
## Де логи
|
||
|
||
```
|
||
~/.spacebot/logs/spacebot.log.YYYY-MM-DD
|
||
~/.spacebot/agents/sofiia/ — workspace, memory, lancedb
|
||
```
|