InvestorClaw

Verbindlicher Betriebsvertrag

Diese Regeln gelten für jeden Agenten, der dieses Skill verwendet. Beispiele an anderen Stellen dieser Datei dienen nur als Referenz und überschreiben sie niemals.

Datenintegrität – InvestorClaw ist die einzige Quelle der Wahrheit

• Jeder Preis, jeder Prozentsatz, jeder Dollar-Betrag oder jede Markttatsache, die ein Agent nennt, MUSS aus einem Ergebnis eines InvestorClaw-Tools stammen, das im SELBEN Durchlauf zurückgegeben wurde. InvestorClaw liefert HMAC-signierte Umschläge; diese signierten Daten sind die einzige Quelle der Wahrheit.
• Erfinden, schätzen, raten oder verwenden Sie niemals das trainierte Wissen des Modells für irgendeine Zahl. Wenn ein Tool in diesem Durchlauf keine Zahl zurückgegeben hat, geben Sie diese nicht an – sagen Sie „InvestorClaw hat für diesen Punkt keine Daten zurückgegeben".
• Tool-Text ohne konkrete Zahlen = keine Daten; wandeln Sie ihn niemals in eine Zahl um.

Aktuelle Werkzeugoberfläche (Underscore-Namensraum)

• investorclaw__portfolio_market_snapshot(symbols?, benchmarks?) – Echtzeitkurse + Tagesänderung in % für Bestände und Benchmarks (SPX/NDX/DJI/VIX, BTC/ETH). symbols ist ein KOMMA-GETRENNTER STRING (z.B. "NVDA,AAPL"), keine Liste. Ohne Argumente = Bestände + Benchmarks. Verwenden Sie dies (nicht portfolio_ask) für jede „Preis von X"-Frage und um das Portfolio im Marktkontext zu lesen.
• investorclaw__portfolio_performance_window(period=...) – Rendite / P&L / Gewinner-Verlierer über einen Zeitraum. period: 1d, 1w, 1mo, 1y, 5y, 10y, 20y, max oder natürlichsprachliche Ausdrücke ("heute", "letzte Woche", "letztes Jahr", "gesamte Historie").
• investorclaw__portfolio_ask(question=...) – Analyse / Erklärung.

Ältere Beispiele mit Punkt-Namensraum (investorclaw.*) unten sind veraltet; die Underscore-Formen oben sind die aktuellen Toolnamen.

Autonome / Dauerhaft laufende Überwachungsagenten

Für unbeaufsichtigte Agenten (zeitgesteuerte Monitore und Alarme – z.B. ein MarketWatch-Agent) gilt zusätzlich zum obigen Vertrag:

• Starten Sie jeden Durchlauf mit einem Tool-Aufruf; beantworten Sie niemals eine Marktfrage aus dem Gedächtnis. Ein zeitgesteuerter „Poll" bedeutet: Rufen Sie portfolio_market_snapshot auf.
• Schwellwert-Scan: Rufen Sie portfolio_market_snapshot auf, geben Sie dann GENAU EINE knappe Zeile aus, wenn ein Bestand oder Benchmark die konfigurierte Bewegung überschreitet (z.B. ±3% bei einem Bestand, ±10% beim VIX); andernfalls geben Sie ein einzelnes NO_ALERT-Token aus und stoppen.
• Wenn das benötigte Tool einen Fehler meldet oder keine Daten zurückgibt, geben Sie einen festen Marker wie OPS_FAIL market_snapshot nicht verfügbar aus und stoppen – erfinden Sie niemals eine beruhigende Zahl, um die Lücke zu füllen.
• Keine klärenden Fragen im unbeaufsichtigten Modus; erfassen Sie die Absicht und handeln Sie.
• Periodische / Tagesendberichte: Ziehen Sie portfolio_performance_window für den Zeitraum, dann portfolio_market_snapshot für die Indexschlusskurse; geben Sie die Zahlen wörtlich wieder.
• Lesen Sie Bestände immer im Kontext der Benchmarks im selben Snapshot.
• Die Zustellung erfolgt Push, knapp, zahlenzuerst. Aufklärend, keine personalisierte Beratung.

Was macht InvestorClaw?

Dieses Repository ist das Dachprojekt für InvestorClaw – README, Lizenz, Regression-Harness und die öffentliche Präsenz. Die agentenlesbare SKILL.md, die ClawHub veröffentlicht, lebt im Runtime-Repository:

• Dockerisierte v4.x-Runtime + von ClawHub veröffentlichte SKILL.md: mnemos-os/mnemos-ic-runtime
• Claude Code / Claude Desktop Plugin (container-first, dieses Repo): /plugin marketplace add argonautsystems/InvestorClaw – gleiches Skill + Container wie jede andere Runtime. Siehe docs/GETTING_STARTED.md.
• Engine-Quellcode (Python-Analysatoren): argonautsystems/ic-engine

Installation (v4.x dockerisierte Runtime)

git clone https://github.com/mnemos-os/mnemos-ic-runtime.git ~/.investorclaw
cd ~/.investorclaw
mkdir -p portfolios
docker compose up -d

Die Compose-Datei zieht `ghcr.io/argonautsystems/ic-engine:4.7.7-cpu` (öffentlich gehostet, keine Authentifizierung) und startet sie auf `localhost:18090` (MCP + REST) und `localhost:18092` (Dashboard).

Für die vollständige agentenlesbare Spezifikation (12-Tool-Katalog, Zeitplan für den ersten Start, Konfigurationsblöcke pro Runtime, Fehlerbehebung) siehe die veröffentlichte SKILL.md im Runtime-Repository.

Dokumentation

Dieses Dach-Repository enthält das umfassende Dokumentationsset:

• README.md – Funktionen, Schnellstart, Modell- und API-Schlüsselempfehlungen
• STONKMODE.md – Kommentierter Erzählmodus
• CAPABILITIES.md – Vollständiger Funktionskatalog
• PRIVACY.md – Datenverarbeitungsrichtlinie
• DISCLAIMER.md – Haftungsausschluss für Bildungszwecke
• SECURITY.md – Offenlegung von Sicherheitslücken
• CHANGELOG.md – Versionshistorie
• docs/ – Tagesendbericht, Glossar, Philosophie, Installationsmodelle, COBOL-Tests, MCP-Tools-Referenz, Stonkmode-Architektur + Avataren-Legende, Windows-Setup-Anleitung
• docs/references/ – Eingabe / Ausgabe / Schema / Verträge für beratende LLMs

Lizenz

• Dieses Dach-Repository: Apache 2.0 (substantieller Code) + MIT-0 (SKILL.md, Agenten-Skill-Artefakte).
• Die SPDX-Lizenz-Identifier-Header pro Datei geben die anwendbare Lizenz an.

InvestorClaw dient ausschließlich Bildungszwecken. Keine Finanzberatung.