# Learnings

## [LRN-20260126-001] best_practice

**Logged**: 2026-01-26T08:12:00+01:00
**Priority**: high
**Status**: resolved
**Area**: config

### Summary
Proaktive Cron-Nachrichten an Telegram erfordern `sessionTarget: "isolated"` + `deliver: true`

### Details
Bei der Erstellung eines Cron-Jobs für morgendliche News wurde zunächst folgende Konfiguration verwendet:
```json
{
  "sessionTarget": "main",
  "payload": {
    "kind": "systemEvent",
    "text": "..."
  }
}
```

Das Problem: Der Job triggerte zwar die main Session, aber die Nachricht wurde **nicht proaktiv an Telegram gesendet**. Der User musste sich erst selbst melden.

**Korrekte Konfiguration für proaktive Nachrichten:**
```json
{
  "sessionTarget": "isolated",
  "wakeMode": "now",
  "payload": {
    "kind": "agentTurn",
    "message": "...",
    "deliver": true,
    "channel": "telegram",
    "to": "<telegram_user_id>"
  }
}
```

Wichtige Unterschiede:
- `sessionTarget: "isolated"` → eigene Session, nicht main
- `payload.kind: "agentTurn"` → nicht systemEvent
- `deliver: true` → aktiviert Zustellung
- `channel` + `to` → Ziel für die Nachricht

### Suggested Action
Bei zukünftigen proaktiven Cron-Jobs immer diese Struktur verwenden.

### Resolution
- **Resolved**: 2026-01-26T08:10:00+01:00
- **Commit/PR**: N/A (config fix)
- **Notes**: Test-Cron um 08:10 bestätigte die Lösung

### Metadata
- Source: error + user_feedback
- Related Files: ~/.clawdbot/cron/jobs.json
- Tags: cron, telegram, proactive, deliver
- Docs: https://docs.clawd.bot/automation/cron-jobs

---