API de Integraciones de OpenClaw para Openclaw

Un marco de integración integral que permite a los agentes de IA descubrir y ejecutar acciones en plataformas de terceros a través de una API unificada.

tkejr
v1.0.0
Feb 18, 2026
0
1.6k
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 makex

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 makex 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 API de Integraciones de OpenClaw?

La API de Integraciones de OpenClaw es un sofisticado sistema basado en habilidades diseñado para permitir que las aplicaciones creadas en la plataforma MakeX interactúen con un vasto ecosistema de servicios de terceros. Al utilizar Composio como motor subyacente, esta habilidad proporciona una interfaz estandarizada para que los agentes de IA descubran, autentiquen y activen acciones en software como Gmail, Slack y GitHub. Este enfoque centralizado simplifica la complejidad de administrar múltiples firmas de API en un único flujo de trabajo cohesivo dentro del entorno de Openclaw Skills.

Diseñada principalmente para la comunicación entre servidores, la API prioriza la seguridad y la escalabilidad. Omite las cookies de sesión de usuario tradicionales en favor de tokens de servicio a nivel de organización, lo que garantiza que los agentes automatizados puedan operar de forma autónoma y segura en todo el conjunto de herramientas conectadas de una organización. Esto lo convierte en un componente esencial para los desarrolladores que crean automatizaciones de IA complejas y multiherramienta.

Casos de uso de API de Integraciones de OpenClaw

  • Orquestar flujos de trabajo multiplataforma, como enviar una notificación de Slack cuando se abre un PR de GitHub.
  • Permitir que los agentes de IA gestionen las comunicaciones leyendo, redactando y enviando correos electrónicos a través de Gmail.
  • Descubrir dinámicamente las herramientas disponibles en tiempo de ejecución para resolver solicitudes complejas de usuarios utilizando Openclaw Skills.
  • Validar los estados de conexión de integración antes de intentar ejecutar tareas en segundo plano automatizadas.
  • Crear herramientas de desarrollador personalizadas que requieran acceso estructurado a esquemas y parámetros de servicios de terceros.

Cómo funciona API de Integraciones de OpenClaw

  1. El flujo de trabajo comienza llamando al punto final search-actions para identificar las herramientas disponibles en las integraciones especificadas en función de palabras clave.
  2. Una vez que se identifica una acción, el sistema verifica el punto final connected-account para garantizar que la organización tenga un vínculo activo con el servicio requerido.
  3. El agente recupera los requisitos técnicos específicos para la acción utilizando el punto final action-details, que proporciona los parámetros de entrada y salida necesarios.
  4. Luego se invoca el punto final run-action con argumentos estructurados o texto en lenguaje natural para realizar la tarea.
  5. Finalmente, el agente puede usar el punto final output-structure para comprender y analizar los datos de respuesta para su posterior procesamiento dentro de la lógica de IA.

Configuración de API de Integraciones de OpenClaw

Para inicializar esta habilidad, primero debe obtener un token de servicio de organización de la configuración del panel de MakeX. Este token es necesario para todas las llamadas a la API para verificar su identidad dentro del ecosistema de Openclaw Skills. Configure su cliente HTTP para que incluya el siguiente encabezado:

X-Org-Token: <su-token-de-servicio-de-organizacion>

Todas las solicitudes se envían mediante POST a la URL base: \/api\/openclaw\/integrations\/<endpoint>. Asegúrese de que su entorno tenga configuradas las claves de API de Composio necesarias si administra usted mismo las conexiones de servicio subyacentes.

Esquema de datos y taxonomía de API de Integraciones de OpenClaw

La API de Integraciones de OpenClaw organiza los datos en entidades estructuradas para garantizar la coherencia entre los diferentes proveedores de servicios. La siguiente tabla describe los objetos de datos principales utilizados dentro de estas Openclaw Skills:

Entidad Descripción Atributos Clave
Integración El slug del proveedor de servicios. gmail, slack, github
Acción Una función específica a ejecutar. slug, name, description
Cuenta Detalles de una instancia de servicio conectada. accountId, status, userId
Parámetros Esquema para entradas y salidas. type, description, required
Respuesta La salida sin procesar de la ejecución. successful, data, error

Funciones avanzadas de API de Integraciones de OpenClaw

  • Soporte de entrada de lenguaje natural para el punto final run-action, lo que permite al sistema interpretar la intención cuando no hay argumentos estructurados disponibles.
  • Manejo integral de preflight de CORS para una integración segura dentro de las consolas de desarrolladores basadas en la web.
  • Capacidades de rastreo avanzadas para monitorear el ciclo de vida de la ejecución de una acción a través de la infraestructura de Openclaw Skills.
  • Filtros de búsqueda flexibles que permiten el descubrimiento de integraciones amplias o búsquedas de herramientas específicas de un kit de herramientas.
  • Manejo de errores estandarizado para brindar comentarios claros sobre parámetros faltantes, tokens no válidos o fallas en el lado del servicio.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*