SoClaw Win-Back-Integration

SoClaw ist Flashs autonomes Rückgewinnungssystem: eine interne Liste mit wertvollen, gefährdeten Mitgliedern, eine Reihe von verwalteten MCP-Tools und eine Entscheidungsfunktion. Sie betreiben es, indem Sie einen OpenClaw-Agenten ausführen – eine Open-Source-Agentenlaufzeitumgebung, die Sie selbst hosten –, der die SoClaw-Funktion lädt und die Schleife über einen bereichs- und limitierten Agentenschlüssel durchläuft.

Diese Anleitung ist für den Betreiber/Integrator bestimmt. Die Geschäftsübersicht finden Sie auf der Produktseite SoClaw. Die Tools zur Kundenrückgewinnung basieren auf demselben verwalteten Server MCP, der im Integrationsleitfaden MCP dokumentiert ist.

Rückgewinnungsinstrumente (Toolset winback)

Die drei Schreibwerkzeuge sind rate-only – geschützt durch den Instant-Pause-Schalter und eine Schreibratenbegrenzung, ohne Wertbeschränkung pro Aufruf, da sie keinen Nennwert haben. Referenzieren Sie jedes Tool als Flash:<tool_name>.

Geldhebel – an eine Aufgabe gebunden

Dies sind die Standard-Schreibwerkzeuge für Flash. Ein Win-Back-Agent MUSS die task_id der beanspruchten Aufgabe übergeben – andernfalls wird der Win-Back-Schreibvorgang mit WINBACK_TASK_REQUIRED abgelehnt. Die task_id macht den Schreibvorgang idempotent und bindet den serverseitig erzwungenen Holdout-Arm. Eine Geldaktion pro Aufgabe.

Installieren Sie die OpenClaw-Laufzeitumgebung und den Skill SoClaw selbst.

Flash sichert die Rückgewinnung System (die Arbeitsliste, die MCP Werkzeuge, die Durchsetzung der Sicherheitsbestimmungen) und die SoClaw Fähigkeit (Die Entscheidungsdoktrin + das Playbook). Sie bringen die Laufzeitumgebung mit: Selbsthosting. OpenClaw Agent, richten Sie es auf Flash'S MCP Laden Sie den Server mit Ihrem Agentenschlüssel und dem Skill. Selbsthosting bietet Ihnen die operative Kontrolle – Sie können den Schlüssel konfigurieren, überwachen, versionieren und deaktivieren – aber es … Nicht interessiert das Sicherheitsmodell lockern: das MCP Die Seite behandelt den Agenten unabhängig davon als extern.

Registrieren Sie Flash als HTTP-Server MCP (der Serverschlüssel muss exakt flash lauten):

export FLASH_WINBACK_KEY="fl_live_your_agent_key_here"

# in the OpenClaw runtime's MCP config
{
  "mcpServers": {
    "flash": {
      "type": "http",
      "url": "https://flash.socialhub.ai/api/mcp",
      "headers": { "Authorization": "Bearer ${FLASH_WINBACK_KEY}" }
    }
  }
}

Laden Sie den SoClaw-Skill (SKILL.md + doctrine · levers · workflows · reference) herunter, legen Sie ihn im Skills-Verzeichnis Ihrer OpenClaw-Laufzeitumgebung ab und führen Sie die Schleife aus:

SoClaw verarbeitet außerdem eine Entscheidungsliste über die Rückgewinnung hinaus – Genehmigung (Kanal-Auftragsprüfung) und Betrugserkennung (Empfehlung innerhalb desselben Haushalts) – im selben Leasing-Zyklus (claim_agent_task → get_agent_task → complete_agent_task). Die Effekte werden über die bestehenden idempotenten Schreibvorgänge von Flash ausgeführt; jede Entscheidung kann zudem an einen Mitarbeiter eskaliert werden.

Selbstprüfungen:

• Der Agent sollte ausschließlich die Rückgewinnungs-Tools und die Hebelwerkzeuge sehen, die durch die Berechtigungen Ihres Schlüssels abgedeckt sind – nichts anderes.
• Ein erstes claim_winback_task gibt eine Aufgabe mit einer Lease zurück, oder NO_TASKS_AVAILABLE / WINBACK_DISABLED – beides sind normale Stoppbedingungen, keine Fehler.
• Ein Coupon-/Punkteanruf ohne task_id muss zurückkommen WINBACK_TASK_REQUIRED – bestätigen Sie, dass Ihre Schleife den Hebel immer an der beanspruchten Aufgabe verankert.

Fehlerbehandlung und Codes

Zwei Kanäle. Ein Protokollfehler (JSON-RPC: Ungültige Methode / unbekanntes Tool) bedeutet in der Regel einen falschen Toolnamen – überprüfen Sie das Präfix Flash: und die Schreibweise. Ein Ergebnis von isError: true stellt eine eindeutige Grenze dar, die Sie einmalig übermitteln und den nächsten Schritt ausführen können. Versuchen Sie niemals, diese Grenze zu umgehen.

Noch ein Hinweis: meta.hasData: false von einem Metriktool ist ein Erfolg, kein Fehler – es bedeutet „keine Daten für dieses Fenster“, niemals 0.

Uplift-Ranking – wie die Arbeitsliste geordnet ist

Die Priorität der Arbeitsliste ist Value-at-Risk × Uplift, wenn ein Uplift-Modell für das Team passt, andernfalls reiner Value-at-Risk. Der Wechsel erfolgt automatisch und wird pro Scan entschieden – es gibt nichts zu konfigurieren.

Das Modell ist ein logistischer Uplift mit zwei Modellen, das pro Team auf Basis jedes Scans der eigenen randomisierten Holdout-Daten des Programms angepasst wird – nur ausgereifte Attributionszeilen, mit der gleichen Konversionsdefinition für beide Arme:

uplift(x) = P(convert | treated, x) − P(convert | holdout, x)

Die Ergebnisse sind deterministisch – keine Zufallsstichprobe –, sodass dieselben Daten immer zum gleichen Ranking führen.

Beispiel-Gates – alle müssen bestanden werden, bevor dem Modell vertraut wird

• ≥ 200 ausgereifte behandelte Zeilen
• ≥ 50 ausgereifte holdout Zeilen
• ≥ 20 Konversionen
• Beide logistischen Anpassungen konvergierten.

Unterhalb eines beliebigen Gates (any) wird das Modell für diesen Scan verworfen (null), und das Ranking basiert wieder auf dem reinen Value-at-Risk – Null Verhaltensänderung, nicht auf einer verschlechterten Schätzung. Eine negative Uplift-Schätzung (negative Uplift-Schätzung), ein gemessener Rückschlag, setzt die Priorität der Aufgabe auf 0 – die Aufgabe bleibt in der Aufgabenliste sichtbar, mit den Zahlen, die den Grund dafür angeben.