SDK API MCP AGENTEN
Darstellung
Tutorial

OpenClaw mit tricoma verbinden? Schritt für Schritt

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

Die Einrichtung erfolgt in tricoma im Bereich AI Connector ? Agent Core.

Dort werden die benötigten Komponenten angelegt und verbunden.

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.

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.

Falls Sie die IP-Adresse eintragen möchten:

  • Ubuntu öffnen
  • Einstellungen
  • Netzwerk
  • Zahnrad der aktiven Verbindung öffnen
  • IP-Adresse ablesen und in tricoma eintragen

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.

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.

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.

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

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.

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.

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.

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.

Die heruntergeladene Datei finden Sie normalerweise im Ordner Downloads.

Dort:

  • ZIP-Datei öffnen
  • entpacken
  • den enthaltenen Ordner öffnen

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.

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.

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.

Die Dateien aus dem entpackten Installationspaket werden in den vorgesehenen Zielordner kopiert, zum Beispiel in den godcore-Serverordner.

Danach werden die Dateirechte passend gesetzt.

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.

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.

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.

Bei der OpenClaw-Einrichtung werden oft weitere Optionen angeboten, zum Beispiel:

  • WhatsApp
  • Telegram
  • Websuche
  • Skills
  • externe APIs

Für die tricoma-Grundeinrichtung können diese Punkte zunächst meist übersprungen werden.

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.

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.

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.

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.

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.

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.

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

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.

Cookie und Tracking
Diese Webseite nutzt Cookies, um eine sichere und zuverlässige Bereitstellung zu gewährleisten. Erforderliche Cookies sind für den Betrieb notwendig. Optionale Cookies unterstützen uns dabei, die Webseite zu analysieren und kontinuierlich zu verbessern.

Impressum | Datenschutzerklärung