knallt.com

  • OpenClaw auf dem Mac Mini einrichten – mein Setup als persönlicher KI-Assistent

    Seit einigen Wochen läuft bei mir zu Hause ein Mac Mini als dedizierter KI-Server mit OpenClaw – einem selbst gehosteten persönlichen Assistenten, der über Telegram, WhatsApp und einen Web-Chat erreichbar ist. In diesem Beitrag beschreibe ich die Installation und Grundkonfiguration. Weitere Teile (Obsidian-Integration, WhatsApp-Weiterleitung, Automatisierungen) folgen.

    Was ist OpenClaw?

    OpenClaw ist ein Open-Source-Framework, das einen KI-Assistenten auf deiner eigenen Hardware betreibt. Der Assistent läuft als Gateway-Dienst im Hintergrund und ist über verschiedene Messaging-Kanäle erreichbar. Im Gegensatz zu Cloud-Diensten wie ChatGPT bleiben alle Daten auf deinem eigenen Rechner – du gibst nur den API-Schlüssel des gewünschten KI-Modells an.

    Ich nutze als Modell die Claude API von Anthropic, der Assistent läuft dauerhaft auf meinem Mac Mini.

    Voraussetzungen

    • Mac Mini (oder ein anderes macOS/Linux-System)
    • Node.js 18 oder neuer
    • Ein API-Schlüssel eines KI-Anbieters (z.B. Anthropic Claude, OpenAI)
    • Optional: Telegram-Bot-Token für die Chat-Integration

    Node.js installieren

    Am einfachsten geht das über Homebrew:

    # Homebrew installieren (falls noch nicht vorhanden)
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    
    # Node.js installieren
    brew install node

    Anschließend prüfen ob alles funktioniert:

    node --version
    npm --version

    OpenClaw installieren

    OpenClaw wird über npm global installiert:

    npm install -g openclaw

    Nach der Installation steht der openclaw-Befehl systemweit zur Verfügung.

    Ersteinrichtung

    Der interaktive Setup-Assistent führt durch die wichtigsten Einstellungen:

    openclaw setup

    Hier wird abgefragt:

    • Workspace-Verzeichnis – wo der Agent seine Dateien speichert (Standard: ~/.openclaw/workspace)
    • KI-Modell – welcher Anbieter und welches Modell genutzt werden soll
    • API-Schlüssel – der Schlüssel des jeweiligen Anbieters

    API-Schlüssel konfigurieren

    Für Anthropic Claude öffnet man zuerst die Konfiguration:

    openclaw configure

    Dort lässt sich unter Providers der Anthropic-API-Schlüssel hinterlegen. Alternativ direkt über die CLI:

    openclaw config set model anthropic/claude-sonnet-4-5
    openclaw config set providers.anthropic.apiKey sk-ant-DEIN-SCHLUESSEL

    Gateway starten

    Das Gateway ist der Kernprozess von OpenClaw – er hält die Verbindung zu den Messaging-Kanälen und verarbeitet Anfragen:

    # Einmalig starten
    openclaw gateway
    
    # Als LaunchAgent installieren (startet automatisch beim Login)
    openclaw gateway install

    Nach dem Start ist das Control UI im Browser erreichbar:

    openclaw dashboard

    Standardmäßig läuft das Dashboard unter http://127.0.0.1:18789.

    Telegram-Bot einrichten

    Damit der Assistent über Telegram erreichbar ist, braucht man zuerst einen Bot-Token von BotFather:

    1. In Telegram @BotFather öffnen
    2. /newbot eingeben und den Anweisungen folgen
    3. Den erhaltenen Token kopieren

    Dann in OpenClaw eintragen:

    openclaw configure

    Unter Channels → Telegram den Bot-Token eingeben. Nach einem Gateway-Neustart ist der Bot aktiv:

    openclaw gateway restart

    Ab sofort kann man dem Telegram-Bot schreiben und bekommt Antworten vom Assistenten.

    Workspace anpassen

    Im Workspace-Verzeichnis (~/.openclaw/workspace/) liegen mehrere Konfigurationsdateien, die das Verhalten des Assistenten steuern:

    • SOUL.md – Persönlichkeit und Verhaltensregeln des Assistenten
    • MEMORY.md – Langzeitgedächtnis (wird vom Assistenten selbst gepflegt)
    • USER.md – Informationen über den Nutzer
    • AGENTS.md – Technische Konfiguration und Anweisungen für den Agenten

    Beispiel: In SOUL.md lässt sich festlegen, in welcher Sprache geantwortet werden soll, wie formell der Ton ist, und welche Aufgaben der Assistent übernehmen soll.

    Status prüfen

    Mit einem einzigen Befehl sieht man ob alles läuft:

    openclaw status

    Das zeigt den Zustand des Gateways, alle verbundenen Kanäle und aktuelle Verbindungen.

    Fazit

    Die Installation ist überraschend schnell erledigt – von npm install bis zum ersten funktionierenden Chat dauert es keine 15 Minuten. Was OpenClaw interessant macht: Der Assistent läuft dauerhaft, hat Gedächtnis über Sessions hinweg, und lässt sich tief in den eigenen Workflow integrieren.

    Im nächsten Teil zeige ich wie ich den Assistenten mit meinem Obsidian-Vault verbunden habe, sodass er direkt Notes anlegen und durchsuchen kann.

  • Schreibe einen Kommentar

    Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert