Files
microdao-daarion/docs/spacebot/README.md
Apple 67225a39fa docs(platform): add policy configs, runbooks, ops scripts and platform documentation
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
2026-03-03 07:14:53 -08:00

99 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
```