OpenFang Installations- und Initialisierungshandbuch: Von Null zum ersten Agent

Slug: openfang-install-setup-guide Kategorie: usage-guides (Anleitungen) Ziel-Keywords: OpenFang Installation, OpenFang Konfigurations-Tutorial, OpenFang Einstiegshilfe Suchintention: Informationell (Benutzer möchte OpenFang bereitstellen) Ziel-Wortanzahl: ~1800 Wörter Sprache: de

Was ist OpenFang?

OpenFang ist ein produktionsreifes Agent-Betriebssystem, das auf Rust basiert. Im Gegensatz zu herkömmlichen KI-Chat-Frameworks bietet OpenFang eine vollständige Agent-Laufzeitumgebung – 180ms Kaltstart, 40MB Speicherverbrauch, 16 Sicherheitsebenen und 40 Kanal-Adapter. Egal, ob du eine einfache Automatisierungsaufgabe lokal ausführen oder ein plattformübergreifendes 24/7 autonomes Agent-Cluster aufbauen möchtest, OpenFang ist dafür bestens geeignet.

Dieser Artikel führt dich von Grund auf durch die Installation, Initialisierung und den Betrieb deines ersten Agents mit OpenFang.

Systemanforderungen

Bevor du mit der Installation beginnst, stelle bitte sicher, dass dein System die folgenden Mindestanforderungen erfüllt:

Die Designphilosophie von OpenFang ist "Lightweight First" – selbst ein Raspberry Pi 4 (4GB-Version) kann es flüssig ausführen.

Schritt 1: Installation der Rust-Toolchain

OpenFang ist in Rust geschrieben, daher musst du zuerst die Rust-Toolchain installieren:

# Rustup installieren (Rust-Toolchain-Manager)curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh# Umgebungsvariablen neu ladensource "$HOME/.cargo/env"# Installation verifizierenrustc --versioncargo --version

Falls du Rust bereits installiert hast, empfehlen wir ein Update auf die neueste stabile Version:

rustup update stable

Schritt 2: Installation von OpenFang

OpenFang bietet verschiedene Installationsmethoden; wir empfehlen die direkte Installation über Cargo:

# Neueste Version von crates.io installierencargo install openfang# Installation verifizierenopenfang --version

Wenn du den Build aus dem Quellcode bevorzugst (geeignet für fortgeschrittene Benutzer, die eine benutzerdefinierte Konfiguration benötigen):

git clone https://github.com/openfang/openfang.gitcd openfangcargo build --release./target/release/openfang --version

Docker-Benutzer können auch das offizielle Image verwenden:

docker pull openfang/openfang:latestdocker run -d --name openfang -v ./config:/app/config openfang/openfang

Schritt 3: Konfigurations-Initialisierung

Nach der Installation führst du den Initialisierungsbefehl aus, um die Konfigurationsdatei zu erstellen:

# Standard-Konfigurationsverzeichnis erstellenopenfang init# Speicherort der Konfigurationsdatei# Linux/macOS: ~/.config/openfang/config.toml# Windows:     %APPDATA%\openfang\config.toml

Nach der Initialisierung wird eine config.toml-Datei generiert. Die wichtigsten Konfigurationspunkte sind:

[core]name = "my-first-agent"          # Agent-Nameworkspace = "./workspace"         # Arbeitsverzeichnislog_level = "info"                # Log-Level: trace, debug, info, warn, error[claude]api_key = "${ANTHROPIC_API_KEY}"  # Aus Umgebungsvariable lesenmodel = "claude-sonnet-5"         # Standardmodellmax_tokens = 4096[security]sandbox_mode = "strict"           # Sandbox-Modus: off, basic, strictnetwork_policy = "allowlist"      # Netzwerkrichtlinieallowed_domains = ["api.anthropic.com"][channels]# Mindestens einen Kanal-Adapter konfigurieren

Erläuterungen zu den wichtigen Konfigurationen:

• api_key: Unterstützt Referenzen auf Umgebungsvariablen (Format ${VAR_NAME}). Schreibe den API-Key niemals direkt in die Konfigurationsdatei.
• sandbox_mode: Für Produktionsumgebungen wird der Modus strict empfohlen.
• network_policy: Der Modus allowlist erlaubt nur Zugriffe auf Domains in der Whitelist, während blocklist Domains in der Blacklist blockiert.
• channels: Es wird mindestens ein Kanal-Adapter benötigt, damit der Agent mit der Außenwelt interagieren kann.

Schritt 4: Anthropic API-Key konfigurieren

OpenFang ist auf die Claude API (via Anthropic) angewiesen, daher muss ein API-Key konfiguriert werden:

# Umgebungsvariable setzenexport ANTHROPIC_API_KEY="sk-ant-..."# Empfehlung: In Shell-Konfigurationsdatei schreibenecho 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.bashrcsource ~/.bashrc

Du kannst deinen API-Key über die Anthropic Console beziehen.

Schritt 5: Kanal-Adapter auswählen und konfigurieren

OpenFang unterstützt über 40 Kanal-Adapter, damit der Agent über verschiedene Plattformen mit Benutzern interagieren kann. Hier sind einige der gängigsten:

Beispiel für die Konfiguration eines Telegram-Kanals:

[channels.telegram]enabled = truebot_token = "${TELEGRAM_BOT_TOKEN}"allowed_users = ["@your_username"]

Schritt 6: Deinen ersten Agent starten

Nachdem die Konfiguration abgeschlossen ist, kannst du den Agent starten:

# Standard-Startopenfang start# Spezifische Konfigurationsdatei angebenopenfang start --config ./my-config.toml# Im Hintergrund ausführenopenfang start --daemon# Laufzeit-Logs anzeigenopenfang logs --follow

Nach einem erfolgreichen Start wird Folgendes angezeigt:

⚡ OpenFang v1.0.0├─ Agent: my-first-agent├─ Model: claude-sonnet-5├─ Sandbox: strict├─ Channels: cli└─ Ready. Type /help for commands.

Im CLI-Kanal kannst du direkt mit dem Agent chatten:

> /help> Prüfe das Wetter für heute> Analysiere die Codestruktur dieses GitHub-Repositorys

Schritt 7: Installation verifizieren

Führe den integrierten Diagnosebefehl aus, um sicherzustellen, dass alles ordnungsgemäß funktioniert:

# Gesundheitscheckopenfang doctor# Sollte in etwa so aussehen:# ✅ Rust toolchain: 1.80.0# ✅ Config file: valid# ✅ API key: configured# ✅ Network: ok (latency 45ms)# ✅ Workspace: writable# All checks passed.

Häufig gestellte Fragen (FAQ)

Nächste Schritte

Herzlichen Glückwunsch zur erfolgreichen Installation und Initialisierung von OpenFang! Wir empfehlen dir, als Nächstes Folgendes zu lesen:

• OpenFang Hands Konfigurationshandbuch: Erfahre, wie du Agent-Fähigkeitsmodule für verschiedene Zwecke konfigurierst.
• OpenFang Mehrkanal-Adapter-Konfiguration: Konfiguriere mehrere Kanäle gleichzeitig, damit dein Agent überall erreichbar ist.
• OpenFang Sicherheits-Best-Practices: Schütze deinen Agent vor Angriffen.