Voraussetzungen
Bevor Sie starten, sollte Folgendes bereits vorhanden sein:
- Ubuntu ist installiert
- der Benutzer heißt godcore
- OpenClaw soll auf eigener Hardware eingerichtet werden
- Zugriff auf tricoma ist vorhanden
- der AI Connector / Agent Core ist verfügbar
1. Agent Core in tricoma öffnen
Die Einrichtung erfolgt in tricoma im Bereich AI Connector ? Agent Core.
Dort werden die benötigten Komponenten angelegt und verbunden.
2. Was ist ein KI-Agent?
Ein KI-Agent ist Ihr virtueller Mitarbeiter.
Das bedeutet:
- ein Agent entspricht einer eigenen OpenClaw-Instanz
- ein Agent arbeitet wie ein einzelner Benutzer
- ein Agent sollte möglichst nur von einer Person oder für einen klaren Aufgabenbereich genutzt werden
Warum?
Wenn mehrere Personen denselben Agenten parallel für unterschiedliche Aufgaben nutzen, kann der Agent Inhalte vermischen. Das kann zu Fehlern führen, etwa bei Produkten, Bildern, Rechnungen oder Kundendaten.
Empfehlung: pro Mitarbeiter oder pro Aufgabe ein eigener Agent.
3. Neuen Agenten anlegen
Legen Sie im Agent Core einen neuen Agenten an.
Wichtige Felder:
- Servername ? technischer Name des Systems
- Pseudonym ? sichtbarer Name des Agenten im Chat
- IP-Adresse ? zur Dokumentation und Wartung
- Benutzerzuordnung ? optional, aber sinnvoll für Nachvollziehbarkeit
- Avatar ? optionales Bild für den Agenten
Empfehlung: Wenn Sie eigene Hardware einsetzen, beschriften Sie das Gerät passend zum Servernamen.
4. IP-Adresse in Ubuntu ermitteln
Falls Sie die IP-Adresse eintragen möchten:
- Ubuntu öffnen
- Einstellungen
- Netzwerk
- Zahnrad der aktiven Verbindung öffnen
- IP-Adresse ablesen und in tricoma eintragen
5. Benutzerzuordnung sinnvoll nutzen
Ein Agent kann in tricoma einem Benutzer zugeordnet werden.
Das hilft später bei der Nachvollziehbarkeit:
- wer den Agenten verwendet
- wer Aktionen ausgelöst hat
- wem Änderungen zugeordnet werden können
In der Praxis sollte nicht ein einziger Agent von allen gemeinsam genutzt werden.
6. Agent speichern
Nach dem Speichern ist der Agent in tricoma angelegt.
Wichtig: Der Agent ist damit noch nicht funktionsfähig, weil die technische Verbindung zu OpenClaw noch fehlt.
7. Agent-Limit beachten
Wie viele Agenten Sie anlegen können, hängt vom Hosting bzw. Serverpaket ab.
Hintergrund:
- Agenten erzeugen Last wie echte Benutzer
- deshalb ist die Anzahl je nach Paket begrenzt
Falls nötig, muss das Paket erweitert werden.
8. Was ist ein MCP-Server?
Der MCP-Server ist die technische Schnittstelle zwischen OpenClaw, tricoma und dem verwendeten KI-Modell.
über den MCP-Server kann der Agent später zum Beispiel:
- Produktdaten abrufen
- Kundendaten lesen
- Daten aktualisieren
- Aktionen in tricoma ausführen
9. MCP-Server anlegen
Legen Sie nun im Agent Core einen neuen MCP-Server an.
Dabei erhalten Sie:
- eine Server-URL
- einen Master-Token
Dieser MCP-Server ist der Kommunikations-Endpunkt zwischen OpenClaw und tricoma.
10. Agent dem MCP-Server zuweisen
Weisen Sie nun den angelegten Agenten dem MCP-Server zu.
Wichtig:
- jeder Agent erhält dadurch einen eigenen Token
- nicht alle Agenten sollten mit demselben Master-Token arbeiten
Vorteil: Sie können später nachvollziehen, welcher Agent welche Aktion ausgeführt hat und welche Rechte dabei verwendet wurden.
11. Rechte für den MCP-Server vergeben
Im MCP-Server gibt es die Funktion Rechte bearbeiten.
Dort legen Sie fest, was der Agent später tun darf.
Beispielrechte im Produktbereich:
- Produkte lesen
- Kategorien lesen
- Lieferanten lesen
- Produkte anlegen
- Produkte aktualisieren
- Produkte löschen
Empfehlung: Starten Sie immer mit wenigen Rechten, zum Beispiel Produkte lesen und vorhandene Produkte aktualisieren. Nicht sofort löschen, Kategorien neu anlegen oder weitreichende Änderungen erlauben. Lieber schrittweise erweitern.
12. Installationspaket herunterladen
Im Bereich des Agenten gibt es einen Installationsscript-Download.
Dieses Paket enthält die Dateien, die lokal auf Ihrem Ubuntu-System benötigt werden, damit OpenClaw mit tricoma kommunizieren kann.
13. ZIP-Datei in Ubuntu finden und entpacken
Die heruntergeladene Datei finden Sie normalerweise im Ordner Downloads.
Dort:
- ZIP-Datei öffnen
- entpacken
- den enthaltenen Ordner öffnen
14. Installer.txt verwenden
Im entpackten Ordner befindet sich eine Datei wie Installer.txt.
Diese Datei enthält die aktuelle Installationsanleitung.
Sehr wichtig: Orientieren Sie sich immer an der mitgelieferten Installer-Datei und nicht blind an alten Videos, da sich OpenClaw und die Installationsschritte ändern können.
15. Benutzer godcore ist Pflicht
Für die lokale Installation gilt:
- Der Benutzer muss godcore heißen
- und die passende Benutzer-ID haben
Wenn das nicht stimmt, funktionieren spätere Skripte und Pfade nicht korrekt.
16. Installation im Terminal durchführen
Die in der Installer.txt enthaltenen Befehle werden im Terminal ausgeführt.
Dabei werden unter anderem:
- benötigte Tools installiert
- Gruppen angelegt
- Ordner erstellt
- Dateien kopiert
- Rechte gesetzt
Wichtig: Befehle immer als Benutzer godcore ausführen, nicht als root.
17. Dateien in den Zielordner kopieren
Die Dateien aus dem entpackten Installationspaket werden in den vorgesehenen Zielordner kopiert, zum Beispiel in den godcore-Serverordner.
Danach werden die Dateirechte passend gesetzt.
18. OpenClaw installieren
Anschließend wird OpenClaw selbst installiert.
Wichtig:
- die OpenClaw-Installationsroutine kann sich ändern
- deshalb immer zusätzlich die aktuelle OpenClaw-Dokumentation beachten
OpenClaw selbst wird über die offizielle Installationsanleitung installiert: https://docs.openclaw.ai/install
Orientieren Sie sich bei der eigentlichen OpenClaw-Installation immer an dieser offiziellen Anleitung und führen Sie die Schritte auf Ihrem Ubuntu-System als Benutzer godcore aus.
19. OpenClaw mit einem KI-Modell verbinden
Während der Einrichtung wählen Sie, mit welchem Modell OpenClaw arbeiten soll.
Empfohlen wird zum Start meist OpenAI / GPT.
Es gibt zwei Möglichkeiten:
Variante A: Abo / OAuth
Geeignet, wenn bereits ein OpenAI-Abo vorhanden ist.
Variante B: API-Key
Hier wird nach Tokenverbrauch abgerechnet.
Empfehlung: klein starten, Verbrauch beobachten und später entscheiden, ob Abo oder API-Key besser passt.
20. Modell auswählen
Danach wird das konkrete Modell ausgewählt.
Wichtig:
- zu kleine Modelle sind oft zu schwach
- zu alte oder zu einfache Modelle können tricoma nicht sinnvoll bedienen
- das Modell muss Tool-Nutzung unterstützen
Sonst kann der Agent zwar chatten, aber keine tricoma-Aktionen ausführen.
21. Zusätzliche Integrationen können übersprungen werden
Bei der OpenClaw-Einrichtung werden oft weitere Optionen angeboten, zum Beispiel:
- Telegram
- Websuche
- Skills
- externe APIs
Für die tricoma-Grundeinrichtung können diese Punkte zunächst meist übersprungen werden.
22. Funktionstest in der Konsole
Nach der Installation kann OpenClaw testweise in der Konsole gestartet werden.
Damit prüfen Sie:
- ob OpenClaw korrekt installiert ist
- ob das Modell antwortet
- ob die Grundkonfiguration funktioniert
Wenn eine Testnachricht beantwortet wird, läuft OpenClaw grundsätzlich.
23. Möglicher Fehler: OpenClaw-Befehl funktioniert nicht
Es kann vorkommen, dass der OpenClaw-Befehl zunächst nicht korrekt funktioniert.
Dafür enthält die Installer-Anleitung einen zusätzlichen Befehl zur Reparatur bzw. Einrichtung.
Danach sollte OpenClaw normal starten.
24. Cronjob einrichten
Damit OpenClaw regelmäßig mit tricoma kommuniziert, wird ein Cronjob eingerichtet.
Dieser sorgt dafür, dass:
- das lokale Skript regelmäßig läuft
- Nachrichten aus tricoma abgeholt werden
- Antworten zurückgeschrieben werden
Ohne diesen Schritt wäre der Agent nicht dauerhaft angebunden.
25. Pairing / Gerätefreigabe durchführen
In neueren OpenClaw-Versionen ist oft ein zusätzlicher Schritt nötig: Pairing / Gerätefreigabe.
Dabei wird bestätigt, dass tricoma mit dieser OpenClaw-Instanz kommunizieren darf.
Typisches Problem ohne Pairing:
- der Agent erscheint im Chat
- Anfragen gehen raus
- aber es kommen keine Antworten zurück
Lösung:
Im Terminal: openclaw devices list
Dann prüfen, ob ein Gerät auf Pending steht.
Diese Request-ID merken und mit folgendem Befehl bestätigen:
openclaw devices approve <requestId>
Die Geräteanfrage muss einmal freigegeben werden.
26. Verbindung in tricoma testen
Nach erfolgreicher Einrichtung können Sie in tricoma einen neuen Chat mit Ihrem Agenten starten.
Dazu:
- Neuer Chat
- KI-Agent auswählen
- Nachricht senden
Wenn alles korrekt eingerichtet ist, antwortet der Agent direkt im tricoma-Chat.
27. Arbeiten mit dem Agenten
Sobald der Agent antwortet, können Sie ihn wie einen Mitarbeiter im Chat nutzen.
Zum Beispiel für:
- Fragen
- Aufgaben
- Datenpflege
- Recherchen
- spätere Automatisierungen
Die Antwortgeschwindigkeit hängt dabei auch vom verwendeten Modell ab.
28. Wichtiger Sicherheitshinweis
OpenClaw ist leistungsfähig, aber auch riskant, wenn zu viele Rechte vergeben oder ungenaue Prompts verwendet werden.
Beispiele:
- Produkte löschen
- Titel überschreiben
- große Änderungen ungewollt ausführen
Deshalb:
- Rechte klein halten
- zuerst testen
- keine unnötig weitreichenden Freigaben erteilen
Fazit
Die Anbindung von OpenClaw an tricoma besteht im Kern aus diesen Schritten:
- Agent in tricoma anlegen
- MCP-Server anlegen
- Agent dem MCP-Server zuweisen
- Rechte vergeben
- Installationspaket herunterladen
- OpenClaw lokal installieren
- Cronjob einrichten
- Pairing durchführen
- Chat in tricoma testen
Danach ist Ihr Agent einsatzbereit und kann direkt in tricoma verwendet werden.