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.