identification-client para Openclaw

Una skill inteligente de identificación de clientes que mapea automáticamente documentos contables analizados al perfil de cliente correcto y determina la dirección de la transacción.

trendex
v1.0.0
Jun 4, 2026
0
516
0

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install identification-client

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar identification-client usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es identification-client?

La skill identification-client sirve como el Paso 3 en el pipeline de contabilidad automatizada. Su misión principal es examinar los componentes de los documentos analizados y vincularlos con precisión a un registro de cliente específico dentro de la base de datos local. Más allá del simple mapeo, evalúa de forma inteligente la dirección de la factura—categorizando un documento como una venta (outbound) cuando el cliente coincide con el emisor, o una compra (inbound) cuando el cliente coincide con el destinatario.

Operando con una filosofía estricta de integridad de datos, este módulo actúa como el único gestor del registro de clientes. Lee los datos para evaluar los materiales entrantes y solo escribe nuevas entradas cuando se logra la certeza absoluta a través de fuentes bancarias formales. Para evitar la contaminación de datos, evita almacenar metadatos especulativos, asegurando un registro limpio y confiable para las etapas posteriores del flujo de trabajo.

Casos de uso de identification-client

  • Correspondencia de facturas o documentos financieros recién analizados con un registro de clientes existente.
  • Determinación automática de la dirección de la transacción (compras vs. ventas) basada en la coincidencia de contrapartes.
  • Aprovisionamiento de nuevos registros de clientes con certeza absoluta utilizando titulares de cuentas de extractos bancarios.
  • Generación de avisos de confirmación automáticos y claros para contadores humanos cuando ocurren coincidencias ambiguas o de doble cara.

Cómo funciona identification-client

  1. Recepción de Entrada: La skill acepta un directorio evaluado o una estructura JSON que contiene metadatos de análisis de documentos (del Paso 2) y metadatos opcionales de cabecera de correo electrónico (del Paso 1).
  2. Evaluación de Extracto Bancario: Si el documento es un extracto bancario, el titular de la cuenta se identifica con certeza absoluta como el cliente. Si es desconocido, se añade un perfil de cliente seguro directamente al registro.
  3. Coincidencia de Facturas: Para las facturas, la skill evalúa a los emisores y destinatarios frente a nombres corporativos conocidos utilizando coincidencias exactas seguidas de puntuación de similitud de cadena difusa (umbral >= 0.82).
  4. Determinación de Dirección: Si solo un lado coincide, asigna la función—estableciendo 'out' para ventas o 'in' para compras. Si la ambigüedad persiste o ambos lados coinciden, marca el registro para intervención manual.
  5. Generación de Salida: La skill añade un bloque de cliente dedicado a la estructura de datos del documento de entrada, que contiene metadatos, puntuaciones de confianza y preguntas de claridad si se requiere revisión.

Configuración de identification-client

La skill se ejecuta como un script dentro del entorno. Asegúrese de que su archivo de registro de clientes local esté preparado antes de inicializar el flujo de trabajo.

echo '<dossier.json>' | python3 scripts/identifier.py --clients <chemin/clients.json>

Esquema de datos y taxonomía de identification-client

La skill actualiza el contexto del documento añadiendo un bloque client estandarizado con la siguiente taxonomía de datos:

Campo Tipo Descripción
slug String | null Slug identificador único para el perfil de cliente reconocido (ej: "numerix-studio").
role String | null Dirección de la transacción: in (compra), out (venta) o holder (titular de cuenta bancaria).
counterparty String | null La entidad comercial opuesta involucrada en la transacción.
method String | null Mecanismo de coincidencia utilizado: relevé, raison-sociale-exacte o raison-sociale.
confidence String Calificación de certeza del resultado de la clasificación: haute, moyenne o faible.
needs_review Boolean Se marca como true si la confianza automática es insuficiente y se requiere intervención humana.
question String | null Pregunta legible generada automáticamente para presentar al contador cuando hay ambigüedad.

Reglas de Integridad del Registro

  • Acceso de Lectura: Abierto para evaluar todas las facturas, recibos y extractos recibidos.
  • Acceso de Escritura: Restringido exclusivamente a creaciones de extractos bancarios de alta certeza (auto-from-bank-statement).
  • Validación SIREN: Utilizado exclusivamente para reforzar coincidencias de cadenas existentes; los números SIREN nunca se inyectan automáticamente ni se usan para decidir los lados de la transacción para evitar contaminación cruzada.

Funciones avanzadas de identification-client

  • Fallbacks de Coincidencia Difusa: Aprovecha algoritmos de distancia de cadena para capturar variaciones tipográficas en nombres corporativos hasta un umbral de similitud de 0.82.
  • Bridging de Human-in-the-Loop: Construye automáticamente preguntas sin jerga para el supervisor cada vez que falla el mapeo de alta confianza, deteniendo las elecciones especulativas hasta que se reciba información humana.
  • Aislamiento de Datos Seguros: Abstrae deliberadamente la lógica de organización de archivos hacia Openclaw Skills descendentes, centrándose únicamente en la clasificación de datos para aplicar una estricta separación de responsabilidades.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*