SoClaw Integración de recuperación de clientes

SoClaw es el sistema autónomo de recuperación de Flash: una lista de trabajo interna de miembros de alto valor y en riesgo, un conjunto de herramientas MCP gobernadas y una habilidad para tomar decisiones. Lo opera ejecutando un agente OpenClaw (un tiempo de ejecución de agente de código abierto que usted mismo aloja) que carga la habilidad SoClaw y trabaja el bucle a través de una clave de agente limitada y con alcance.

Esta guía está dirigida a ese operador/integrador. Para obtener una descripción general del negocio, consulte la página del producto SoClaw. Las herramientas de recuperación se basan en el mismo servidor gobernado MCP documentado en la guía de integración MCP.

Herramientas de recuperación (conjunto de herramientas winback)

Las tres herramientas de escritura son rate-only, protegidas por el interruptor de pausa instantánea y un límite de velocidad de escritura, sin límite de valor por llamada porque no tienen valor nominal. Haga referencia a cada herramienta como Flash:<tool_name>.

Palancas de dinero: ancladas a una tarea

Estas son las herramientas de escritura estándar Flash. Un agente de recuperación DEBE pasar la task_id de la tarea reclamada; sin ella, la escritura de recuperación se rechaza con WINBACK_TASK_REQUIRED. El task_id hace que la escritura sea idempotente y vincula el brazo de retención impuesto por el servidor. Una acción monetaria por tarea.

Despliega por tu cuenta el entorno de ejecución de OpenClaw + la habilidad SoClaw

Flash proporciona el sistema de recuperación (la lista de trabajo, las herramientas MCP, la aplicación de seguridad) y la habilidad SoClaw (la doctrina de decisión + libro de jugadas). Usted proporciona el entorno de ejecución: autoaloje un agente OpenClaw, apúntelo al servidor MCP de Flash con su clave de agente y cargue la habilidad. El autoaloje le da control operativo (configurar, monitorear, fijar versiones y eliminar la clave), pero no relaja el modelo de seguridad: el lado MCP trata al agente como externo independientemente.

Registrar Flash como servidor HTTP MCP (la clave del servidor debe ser exactamente flash):

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}" }
    }
  }
}

Descargue la habilidad SoClaw (SKILL.md + doctrina · palancas · flujos de trabajo · referencia), colóquela en el directorio de habilidades de su tiempo de ejecución OpenClaw y ejecute el bucle:

SoClaw también gestiona una lista de trabajo de decisiones más allá de la recuperación de clientes: aprobación (revisión de pedidos por canal) y fraude (referencia del mismo hogar), a través del mismo ciclo de arrendamiento (claim_agent_task → get_agent_task → complete_agent_task). Los efectos se ejecutan mediante las escrituras idempotentes existentes de Flash; cada decisión también puede ser escalada a un humano.

Autoevaluaciones:

• El agente solo debe ver las herramientas de recuperación y las herramientas de palanca permitidas por los ámbitos de su clave; nada más.
• Un primer claim_winback_task devuelve una tarea con una concesión, o NO_TASKS_AVAILABLE / WINBACK_DISABLED; ambas son condiciones de detención normales, no fallas.
• Una llamada de cupón/puntos sin task_id debe regresar WINBACK_TASK_REQUIRED; confirme que su bucle siempre ancla la palanca a la tarea reclamada.

Manejo de errores y códigos

Dos canales. Un error de protocolo (JSON-RPC: método incorrecto / herramienta desconocida) suele indicar un nombre de herramienta incorrecto; comprueba el prefijo Flash: y la ortografía. Un resultado isError: true es un límite claro que puedes leer: transmítelo una vez y da el siguiente paso. Nunca intentes eludirlo.

Un punto más: meta.hasData: false de una herramienta de métricas es un éxito, no un error — significa "no hay datos para esa ventana", nunca 0.

Clasificación mejorada: cómo se ordena la lista de trabajo

La prioridad de la lista de trabajo es valor en riesgo × mejora cuando un modelo de mejora se adapta al equipo, y valor en riesgo puro en caso contrario. El cambio es automático y se decide mediante escaneo; no hay nada que configurar.

El modelo es un mejora logística de dos modelos, ajustado por equipo en cada escaneo a partir de los propios datos de validación aleatorios del programa: solo filas de atribución maduras, con la misma definición de conversión en ambos brazos:

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

Los resultados son deterministas (sin muestreo aleatorio), por lo que los mismos datos siempre producen la misma clasificación.

Puertas de muestra: todas deben pasar antes de que se confíe en el modelo

• ≥ 200 filas maduras tratadas con
• ≥ 50 filas maduras de holdout
• ≥ 20 conversiones
• Ambas soluciones logísticas convergen

Debajo de cualquier puerta, el modelo se descarta para ese escaneo (null) y la clasificación vuelve al valor en riesgo puro: cambio de comportamiento cero, no una estimación degradada. Una estimación de mejora negativa (un efecto secundario medido) reduce la prioridad de la tarea a 0; la tarea permanece visible en la lista de trabajo, con los números que explican el motivo.