IR
irwinrodriguez.dev
Zurück zur Dokumentation

Erste Schritte

Vorher brauchen Sie den Client auf Ihrem Rechner (Installation) und den Agenten auf dem anderen (Server-Kit).

1. Den Agenten auf dem anderen Rechner starten

Doppelklick auf die passende .bat aus dem Kit. Der Agent gibt eine Zeile wie diese aus und hat sie bereits in die Zwischenablage kopiert:

Die golem_connect-Zeile, die der Agent ausgibt
golem_connect https://192.168.1.40:8797 nSbK7q…  A1B2C3…

Startet ihn Ihr Kunde, genügt es, wenn er sie Ihnen per E-Mail oder Nachricht schickt, so wie er Ihnen heute eine AnyDesk-ID schickt.

2. Die Zeile in den Chat einfügen

Öffnen Sie Claude (war es geöffnet, starten Sie es neu, damit es die neue Konfiguration liest) und fügen Sie die Zeile in den Chat ein. Vollständig, genau so.

3. Den Agenten aufrufen

Das war's. Und ab hier hängt es davon ab, welches Claude Sie verwenden, denn nicht alle aktualisieren die Tool-Liste nach dem Verbinden:

WoWas passiertWie der Agent aufgerufen wird
Claude DesktopAktualisiert den Katalog: Die Tools erscheinen mit dem Präfix vps__Direkt: vps__run_powershell, vps__screenshot…
Claude CodeAktualisiert den Katalog nicht: Diese Tools werden nicht erscheinenMit golem_call: hier der normale Weg und kein Notbehelf

In Claude Code sagt Ihnen golem_tools, was der Agent hat (mit Schemas), und golem_call ruft es beim entfernten Namen auf, ohne Präfix:

Ein Tool des Agenten mit golem_call aufrufen
golem_call  tool = "run_powershell"
            arguments = { "script": "Get-Service W3SVC" }

Das Ergebnis ist genau dasselbe wie beim direkten Aufruf, Bilder eingeschlossen. Zum Trennen golem_disconnect. Um zu sehen, was verbunden ist, golem_status, das nie ein Token zurückgibt.

Gut zu wissen

  • Das Token ändert sich bei jedem Start des Agenten. Wurde der Agent neu gestartet, fügen Sie die neue Zeile ein, ohne vorher zu trennen: Golem erkennt, dass die alte Verbindung tot ist, ersetzt sie und sagt es Ihnen (replaced_dead). Dieselbe Zeile zweimal einzufügen ist auch kein Fehler: Sie wird wiederverwendet.
  • Meldet es alias_en_uso, gibt es wirklich eine andere aktive Verbindung mit diesem Alias, zu einem anderen Agenten, und wahrscheinlich eine andere Sitzung, die damit arbeitet. Die Meldung sagt, mit welchem Rechner. Verwenden Sie einen anderen Alias, oder golem_disconnect, wenn Sie wissen, dass sie niemand mehr braucht.
  • Der Agent beendet sich selbst nach 30 Minuten ohne Anfragen. Das ist Absicht: Auf niemandes Rechner bleibt ein Port offen, weil jemand es vergessen hat.
  • Sie können sich mit mehreren Rechnern gleichzeitig verbinden, jeder mit seinem Alias: golem_connect <Zeile> alias=anderer veröffentlicht anderer__run_powershell. Im Evaluierungsmodus eine aktive Verbindung gleichzeitig.
  • Mehrere Dateien auf einmal: golem_push paths = ["C:\\a\\eins.dbf", "C:\\b\\zwei.dll"] remote_path = "C:\\ziel". Immer absolute Pfade, und jede landet mit ihrem Namen im Ziel.
  • Nur die Tabellen eines Ordners: golem_pull remote_path = "…" local_path = "…" include = ["*.dbf", "*.cdx"]. include wird wie exclude geschrieben und vor diesem angewendet.

Wenn etwas nicht funktioniert

Was Sie sehenWas es ist
Claude hat kein golem_*-ToolEs hat die Konfiguration nicht gelesen: vollständig schließen und erneut öffnen
golem_connect kann keine Verbindung herstellenDer Agent läuft nicht, oder die Firewall des anderen Rechners lässt diesen Port nicht durch
„Das Zertifikat ist nicht vertrauenswürdig“Der Agent erzeugt bei jedem Start sein eigenes. Der Fingerabdruck steht in der eingefügten Zeile: Wurde sie nicht vollständig eingefügt, fügen Sie sie erneut ein
Installiert, erscheint aber immer noch nichtPrüfen Sie, ob %LOCALAPPDATA%\Golem\golem-client.exe existiert. Fehlt sie, hat der Virenscanner sie entfernt
tope_de_evaluacion beim Aufruf eines eingreifenden Tools oder beim Verbinden mit dem zweiten HostKein Fehler: das ist die Grenze der Evaluierung. Eingreifende Tools brauchen eine Lizenz, und ohne sie gibt es eine aktive Verbindung gleichzeitig: Trennen Sie die bestehende mit golem_disconnect, oder kaufen Sie eine Lizenz

Große Übertragungen

golem_push und golem_pull halten nach 30 Sekunden von selbst an und liefern done: false mit einem resume: Rufen Sie sie mit diesem resume erneut auf, so oft wie nötig, bis done true ist. Ein Ordner mit 305 MB sind drei Runden.

Dreißig Sekunden sind absichtlich knapp: Was einen langen Aufruf abbricht, ist die Geduld Ihres MCP-Clients, die Golem nicht kennen kann. Wissen Sie, dass Ihrer länger wartet, erhöhen Sie den Wert mit der Umgebungsvariable GOLEM_MAX_CALL_SECONDS (1 bis 240) im env-Block, der den Client startet:

golem-Eintrag mit GOLEM_MAX_CALL_SECONDS im env-Block
{
  "mcpServers": {
    "golem": {
      "command": "C:\\Users\\<tu usuario>\\AppData\\Local\\Golem\\golem-client.exe",
      "args": [
        "proxy"
      ],
      "env": {
        "GOLEM_MAX_CALL_SECONDS": "120"
      }
    }
  }
}

Ein Wert außerhalb des Bereichs oder ein Tippfehler wird ignoriert, und es bleibt bei 30. Und am bequemsten ist es, nicht den ganzen Eintrag zu schreiben: der Installer hat in der Konfiguration Ihres Clients bereits einen Eintrag golem mit dem richtigen Pfad hinterlassen, dem Sie nur den env-Block hinzufügen.