IR
irwinrodriguez.dev
Zurück zur Dokumentation

Server-Kit

Das gehört auf den Rechner, den Sie bedienen wollen. Der Agent ist eine einzige Datei, golem.exe. Es gibt keinen Installer: Kopieren Sie sie, wohin Sie wollen, und starten Sie sie. Sie fasst die Registry nicht an, legt keine Dienste an und hinterlässt nichts außer ihrem eigenen Log daneben.

Der Agent trägt keine Lizenz und kostet nichts für das Verbinden. Kopieren Sie ihn auf so viele Rechner, wie Sie wollen. Lizenziert wird der Client am anderen Ende (Installation).

Sitzt vor dem Server niemand, lässt der Guardian Ihre Techniker hinein, ohne dass jemand den Agenten startet. Er gehört zu Golem Unternehmen.

Sie suchen das Programm, mit dem Ihnen jemand an Ihrem Computer hilft? Das ist Golem Assist: eine Datei, ein Knopf und zwölf Ziffern. Sie finden es unter Fernhilfe. Beide nebeneinander: Welches lade ich herunter?

Golem ist digital signiert

Seit 1.1.3 tragen golem.exe (und cloudflared.exe, von Cloudflare signiert) eine Herausgebersignatur auf den Namen Irwin Alfredo Rodriguez Gimenez, mit Zeitstempel. So sehen Sie sie: Rechtsklick auf die Datei → Eigenschaften → Digitale Signaturen, oder Get-AuthenticodeSignature in PowerShell, das Valid melden muss.

  • SmartScreen: Das Zertifikat ist neu, und Windows kann noch eine Zeit lang warnen. Erscheint „Der Computer wurde durch Windows geschützt“, klicken Sie auf Weitere Informationen: Dort muss Herausgeber: Irwin Alfredo Rodriguez Gimenez stehen. Steht das dort, Trotzdem ausführen; steht dort „Unbekannter Herausgeber“, ist die Datei nicht von uns: Führen Sie sie nicht aus.
  • Fernwartungswerkzeuge: Manche Virenscanner markieren Fernwartungsprogramme wie Golem allein wegen ihrer Kategorie, ohne dass mit der Datei etwas nicht stimmt. Wenn Ihrer das tut, fügen Sie die Ausnahme erst hinzu, nachdem Sie geprüft haben, dass der SHA-256 mit dem weiter unten veröffentlichten übereinstimmt.
Server-Kit herunterladen (kostenlos)

Ohne Konto und ohne Lizenz. Eine .zip mit golem.exe, den Start-.bat-Dateien und cloudflared.exe. Golem-Server-1.6.0.zip · 57.8 MB

Vor der Installation

Das Server-Kit wird als .zip ausgeliefert. golem.exe ist signiert, aber Windows markiert Dateien aus dem Internet und kann bei einem neuen Zertifikat beim Starten warnen. Hier steht, was Sie sehen werden, wie es weitergeht und wie Sie selbst prüfen können, dass die heruntergeladene Datei genau die ist, die wir veröffentlicht haben.

Aus dem Internet heruntergeladene Datei und SmartScreen

Windows markiert die .zip als aus dem Internet heruntergeladen, und diese Markierung geht auf jede entpackte Datei über. Starten Sie golem.exe oder eine der .bat-Dateien, ohne vorher freizugeben, erscheint SmartScreen („Der Computer wurde durch Windows geschützt“): dort sind es zwei Klicks, „Weitere Informationen“ und „Trotzdem ausführen“. Damit es nicht erscheint, geben Sie die .zip vor dem Entpacken frei.

  1. Rechtsklick auf die .zip → Eigenschaften.
  2. Unten Zulassen ankreuzen und bestätigen.
  3. Erst freigeben, dann entpacken: andersherum bleibt die Markierung an jeder einzelnen Datei.

Es geht auch per PowerShell: Unblock-File auf die heruntergeladene .zip.

Wenn Ihr Virenscanner blockiert

Manche Virenscanner stellen selten gesehene Programme unter Quarantäne, und golem.exe öffnet einen Port und startet PowerShell, genau das, worauf sie achten. Fügen Sie in dem Fall eine Ausnahme für den Ordner hinzu, in dem golem.exe liegt (zum Beispiel C:\Golem\), und starten Sie es erneut.

Wenn der Virenscanner der Firma gehört und Sie seine Regeln nicht ändern dürfen, geben Sie den SHA-256 unten an die Administration weiter: mehr braucht sie nicht, um die Datei freizugeben.

Prüfen Sie, was Sie heruntergeladen haben

Das sind die Daten der aktuellen Version, für den Client-Installer und das Server-Kit. Jeder Hash wird über die Datei berechnet, so wie sie heruntergeladen wird:

DateiVersionVeröffentlichtGrößeSHA-256
Golem-Server-1.6.0.zip 1.6.0 15. Okt. 2026 57.8 MB 30035DEF0AE5BB7A37C68CEF061838912324DF5F21B7EE845C7EB6B8AE989E67
Golem-Client-Setup-1.6.0.exe 1.6.0 15. Okt. 2026 30.4 MB 88951E5DD1DD0CB862F865E54746E2B9A5F5ABBF604B2F08193610A83D789485

Zum Prüfen öffnen Sie PowerShell in Ihrem Download-Ordner und führen aus:

Den SHA-256 der heruntergeladenen Datei berechnen
Get-FileHash -Algorithm SHA256 "$HOME\Downloads\Golem-Server-1.6.0.zip"

Stimmt der Wert mit der Tabelle überein, ist die Datei von uns und unversehrt. Stimmt er nicht, führen Sie sie nicht aus: laden Sie sie erneut herunter, und wenn es dann immer noch nicht passt, schreiben Sie an soporte@irwinrodriguez.dev.

Die Hashes werden bei jeder veröffentlichten Version neu gemessen. Wenn Sie eine ältere Version heruntergeladen haben, muss ihr Hash nicht mit dieser Tabelle übereinstimmen.

Was das Kit enthält

DateiWofür
golem.exeDer Agent. Das Einzige, was unbedingt nötig ist
Start - server with public IP.batStart mit einem Klick für einen VPS oder einen von außen erreichbaren Server
Start - normal PC, through tunnel.batStart mit einem Klick für einen PC hinter einem Router, an einer Mobilverbindung oder hinter einer Firmen-Firewall
Start - look only, server with public IP.batWie die erste, aber der Agent veröffentlicht <strong>nur die Tools, die hinsehen</strong> (<code>--read-only</code>). Um jemanden zur Diagnose hereinzulassen, nicht zum Eingreifen
Arrancar - servidor con IP publica.bat · Arrancar - PC normal, por tunel.bat · Arrancar - solo mirar, servidor con IP publica.batDieselben drei, auf Spanisch
cloudflared.exeÖffnet den Tunnel; nur der Tunnel-Start verwendet es. Es ist das offizielle, unveränderte Binary von Cloudflare, signiert von Cloudflare, Inc., mit seiner Lizenz (Apache 2.0) daneben
README-server.md · README-servidor.mdDas Handbuch des Agenten, auf Englisch und Spanisch

Welche der beiden .bat-Dateien

In einer Frage: Ist dieser Rechner von außen erreichbar? Ein VPS, ein Server mit öffentlicher IP oder ein Rechner im selben Netz wie der Techniker: die erste. Ein PC zu Hause, einer an einer Mobilverbindung oder einer im Firmennetz: die zweite, denn dort gibt es keinen Port zu öffnen, und die Verbindung muss von diesem Rechner nach außen gehen. Die zweite braucht keine Administratorrechte.

Starten

Doppelklick auf die passende .bat. Beim Start gibt der Agent ein Banner mit Rechner, Port, Audit-Log, Tools und am Ende der golem_connect-Zeile aus, die er bereits in die Zwischenablage kopiert hat: Einfach (Strg+V) in den Chat von Claude einfügen, oder in die E-Mail oder Nachricht an Ihren Techniker.

Die Zeile wird in keiner Datei gespeichert, und das ist Absicht. Das Token ändert sich bei jedem Start, eine gespeicherte Zeile wäre also tot, sähe aber gültig aus. Beim Schließen des Fensters oder mit Strg+C beendet sich der Agent geordnet und vermerkt das in seinem Log.

Die drei Startarten

Wo Sie sindWieWelche Zeile Sie bekommen
Ein vertrauenswürdiges LAN, oder per RDPgolem serve --no-tlshttp://ip:8797 <token>, unverschlüsselt, und das Banner sagt es in Großbuchstaben
Ein Server mit öffentlicher IPgolem serve (der Normalfall, und was der Doppelklick tut)https://ip:8797 <token> <Fingerabdruck>, verschlüsselt mit eigenem Zertifikat
Ein Rechner ohne zu öffnenden Portgolem serve --tunnelhttps://etwas.trycloudflare.com <token>, ohne Fingerabdruck: eine echte CA signiert

Drei Dinge zum Tunnel

  1. Die Adresse ändert sich bei jedem Start, genau wie das Token. Warten Sie etwa zehn Sekunden, bevor Sie die Zeile einfügen: Der Name erscheint am Bildschirm, bevor das DNS ihn auflösen kann.
  2. Durch den Tunnel darf nichts länger als 125 Sekunden dauern. Das ist eine Grenze von Cloudflare: Ein run_powershell von mehr als zwei Minuten oder ein langes Warten stirbt dort. Starten Sie den Job im Hintergrund und fragen Sie in kürzen Runden nach.
  3. Es ist der kostenlose Dienst von Cloudflare, ohne Verfügbarkeitszusage. Um einem Kunden eine Weile zu helfen, reicht er völlig; für etwas, das zu einer festen Zeit laufen muss, nehmen Sie die öffentliche IP mit Fingerabdruck.

TLS und Firewall

TLS ist standardmäßig an. Der Agent erzeugt bei jedem Start sein eigenes Zertifikat, und die golem_connect-Zeile trägt am Ende dessen Fingerabdruck; deshalb wird sie vollständig eingefügt. Mit --no-tls reist das Token im Klartext: gut für ein LAN, nicht für das Internet.

Als Administrator gestartet, legt der Agent eine eigene eingehende Regel für seinen Port an (Golem-agente-8797) und entfernt sie beim Beenden. In einer normalen Konsole kann er das nicht, sagt es und gibt Ihnen den vollständigen netsh-Befehl. Mit Tunnel gibt es nichts zu öffnen.

Ein Agent mit weniger Händen

Soll auf diesem Rechner nur hingesehen werden, starten Sie ihn mit --read-only (oder Doppelklick auf Start - look only, server with public IP.bat). Er veröffentlicht nur die Tools, die hinsehen: host_info, Dateien, Screenshots, Prozesse, den Zustand der Dienste und was FoxAgent untersucht. run_powershell, Dateien schreiben, Prozesse starten oder beenden und die Skripte in scripts\ werden nicht veröffentlicht; service schon, antwortet aber nur auf action=status. Für Feineres gibt es --allow mit einer Liste von Mustern, und beides lässt sich kombinieren: Durch kommt, was passt und hinsieht.

Den Agenten nur zum Hinsehen starten
golem serve --read-only

Ihre Skripte und die MCP-Server des Rechners

scripts\: Jede .ps1, die Sie in diesen Ordner neben golem.exe legen, wird als weiteres Tool veröffentlicht, mit der Beschreibung und den Parametern, die das Skript selbst deklariert. Der Ordner wird beim Start gelesen.

golem.mcp.json: Gibt es auf diesem Rechner einen MCP-Server (zum Beispiel FoxAgent), startet Golem ihn beim Hochfahren und veröffentlicht seine Tools als <alias>__<tool>. Die Datei hat dieselbe Form wie die .mcp.json von Claude; der Pfad wird vollständig geschrieben, weil Golem nicht im PATH sucht:

golem.mcp.json mit FoxAgent
{
  "mcpServers": {
    "foxagent": {
      "command": "C:\\Program Files\\FoxAgent\\FoxAgent.McpHost.exe",
      "args": []
    }
  }
}

Fällt ein Server aus, startet ihn der nächste Aufruf neu, höchstens einmal pro Minute. Beendet sich der Agent, nimmt er die gestarteten Server mit.

Was er protokolliert

golem-audit.log, neben der exe und auf Spanisch: eine Zeile pro Aufruf: welches Tool, welche Argumente, wie lange, wie es endete, und eine pro übertragener Datei, mit ihrem sha256. Es enthält kein Token und kann daher gezeigt werden.

Es vermerkt auch, mit welcher Lizenz sich jeder Client nach eigener Angabe verbunden hat, und der Agent prüft sie nicht und weist deshalb niemanden ab:

Zeile in golem-audit.log beim Öffnen einer Sitzung
… [agente] -- sesion abierta -- el cliente dice: modo licenciado, id _GY9C452T (4c77b9d2)

Den Zustand ohne Token prüfen

GET /health antwortet jedem, der den Port erreicht, ohne Anmeldedaten: Status, auf Haupt- und Nebenversion gekürzte Version und Anzahl der Tools. GET /sessions liefert die Zahl der aktiven Sitzungen. Keine der beiden gibt Tokens zurück. Alles andere verlangt das Token. Wollen Sie nichts offenlegen, starten Sie mit Tunnel oder mit --host 127.0.0.1.

Aktualisieren

Die neue golem.exe über die alte kopieren und erneut starten. Nichts auf der Festplatte hängt von der Version ab. Lief sie noch, schließen Sie sie vorher: Eine laufende ausführbare Datei lässt sich nicht überschreiben.