Kategorien
general

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