IronClaw Entwickler-Guide
IronClaw ist eine sichere persönliche KI-Assistenz-Laufzeit, die stark auf lokale Kontrolle, explizite Konfiguration und richtlinienbewusste Ausführung setzt. Dieser Guide erklärt, was IronClaw ist, wie die neuere Reborn-Laufzeit aufgebaut ist, wie Setup und Konfiguration funktionieren und wo du beitragen kannst.
Dieser Guide basiert auf den offiziellen IronClaw-Docs und dem offiziellen Repository nearai/ironclaw, geprüft am 26. Juni 2026.
In diesem Abschnitt
- Setup und erster Start
- Architektur und Laufzeit
- Konfiguration und Sicherheit
- Erweitern und Beitragen
- Einfacher Benutzer-Guide
1. Was IronClaw ist
Die kürzeste zutreffende Beschreibung lautet:
IronClaw ist eine persönliche KI-Laufzeit, die lokal, explizit und sicherheitsbewusst sein soll statt magisch und undurchsichtig.
Die Upstream-README und die Docs betonen besonders:
- sichere persönliche Nutzung,
- explizite Konfiguration,
- umgebungsbasierte Secrets,
- richtlinienbewusste Ausführung,
- und eine neuere eigenständige Reborn-Laufzeit.
2. Das mentale Modell
Stell dir IronClaw als fünf zusammenwirkende Schichten vor:
| Schicht | Was sie tut |
|---|---|
| CLI-Laufzeit | Wichtigste nutzerseitige Steuerungsfläche |
| Model-Routing | Wählt Anbieter und Modelle explizit aus |
| Konfiguration und Profile | Definieren Verhalten und Betriebsmodus |
| Richtlinie und Speicher | Steuern Deployment-Modus und Persistenz |
| Skills und Automatisierungsflächen | Erweitern die Fähigkeiten des Assistenten |
3. Warum Entwickler es wählen würden
- Es ist bewusst sicherheitsorientiert.
- Es bevorzugt explizite Konfiguration gegenüber versteckten Defaults.
- Es hat einen CLI-nativen Konfigurationsablauf für Anbieter und Modelle.
- Es ist transparent genug, dass Betreibende es wie ein echtes System statt wie eine Blackbox durchdenken können.
4. Was die Docs nützlich macht
IronClaws Docs und README zeigen gut, wie man es nutzt, aber auch, wie Konfiguration, Richtlinie, Secrets und Speicher zusammenpassen. Das ist besonders wertvoll für ein Tool, dem man vertrauen können soll.
5. Empfohlene Lesereihenfolge
- diesen Überblick,
- Quick Start und Konfigurationspfad,
- Architektur und Laufzeit,
- Konfiguration und Sicherheit,
- Beitragsflächen.