OpenClaw es un bucle: lee tu espacio de trabajo, ejecuta comandos de shell a través de su herramienta exec, lee la salida y decide qué hacer a continuación. Entonces, ¿por qué tus pruebas de API no están en ese bucle? Se encuentran en Apidog detrás de una interfaz gráfica, se ejecutan cuando alguien se acuerda de hacer clic. Tu agente nunca las toca.
La solución es un bloque de configuración. La CLI de Apidog es un paquete npm, apidog-cli, que ejecuta los escenarios de prueba que construiste en Apidog directamente desde una terminal. Una vez que la CLI está instalada y OpenClaw sabe que existe, tu agente ejecuta un escenario de Apidog de la misma manera que ejecuta tus pruebas unitarias: dispara el comando, lee el código de salida, corrige el código si está en rojo.
Esta guía cubre la parte específica de OpenClaw que la guía de instalación genérica omite: dónde colocar las reglas de Apidog para que el agente las conserve, cómo la herramienta exec de OpenClaw ejecuta realmente apidog run y cómo leer el resultado.
Si aún no has instalado la CLI, hazlo primero. Cómo instalar la CLI de Apidog con un agente de codificación de IA explica la instalación de npm, la autenticación y la primera ejecución. Este artículo asume que apidog --version imprime un número y que tu cuenta de Apidog ha iniciado sesión.
De qué OpenClaw se trata
OpenClaw es el agente de IA de código abierto, "local-first" que se ejecuta en tu propia máquina. Tiene un espacio de trabajo, un conjunto de habilidades y una herramienta de ejecución que ejecuta comandos de shell reales. No es un plugin de autocompletado de código ni un chatbot alojado. Si has ejecutado openclaw localmente y lo has visto editar archivos y ejecutar comandos, estás en el lugar correcto. Para una configuración más amplia, consulta automatización del flujo de trabajo de desarrollo de OpenClaw y la guía para una instalación segura de OpenClaw antes de entregarle cualquier comando.
La distinción importa porque OpenClaw aprende las reglas del proyecto a partir de los archivos del espacio de trabajo, y ese mecanismo convierte un "ejecutar mis pruebas" único en algo que OpenClaw busca por sí mismo. Ese mecanismo es AGENTS.md.
Paso 1: Añade las reglas de Apidog a AGENTS.md
OpenClaw lee los archivos del espacio de trabajo como instrucciones permanentes y los inyecta en el contexto del agente. El que quieres es AGENTS.md, el manual de reglas procesales que le dice al agente qué hacer y cómo. Piensa en ello como CLAUDE.md para Claude Code; OpenClaw incluso incluye una plantilla predeterminada que puedes copiar en tu espacio de trabajo, y trata un enlace simbólico hermano CLAUDE.md como el mismo archivo. El espacio de trabajo por defecto es ~/.openclaw/workspace, pero puedes apuntar un agente a tu directorio de proyecto con agents.list[].workspace, y OpenClaw soporta archivos AGENTS.md con ámbito por subdirectorio (consulta la referencia de AGENTS.md de OpenClaw).
Añade un bloque corto a tu AGENTS.md:
## Pruebas de API con Apidog
- Para ejecutar pruebas de API, utiliza la CLI de Apidog: `apidog run -t <scenario_id> -e <env_id> -r cli`.
- El código de salida 0 significa que todas las aserciones pasaron. Un valor distinto de cero significa que algo falló. Trátalo como la puerta de aprobación/falla.
- La máquina ya está autenticada con `apidog login`. Nunca añadas una bandera --access-token y nunca pongas un token en este archivo.
- Si una bandera parece desconocida, ejecuta `apidog run --help` en lugar de adivinar.
Por eso escribes la CLI en AGENTS.md en lugar de mencionarla en el chat. Un ID de escenario tecleado en una sesión desaparece cuando la sesión termina. Uno en AGENTS.md está ahí para cada compañero de equipo y cada ejecución de OpenClaw de ahora en adelante.
Paso 2: Obtén el comando de Apidog
No tienes que escribir el ID del escenario a mano. Abre el escenario de prueba en Apidog, ve a su pestaña CI/CD y copia el comando generado. Se ve así:
apidog run -t 1234567 -e 890123 -r cli
El -t es el escenario de prueba, -e es el entorno, y -r cli es el reportero. Pega los IDs reales en el bloque AGENTS.md del Paso 1 para que OpenClaw siempre llame al escenario correcto contra el entorno correcto. La guía completa de la CLI de Apidog y la referencia del comando apidog run cubren cada bandera si quieres ajustarlo.
Paso 3: Haz que el agente ejecute la prueba
Con el bloque en su lugar, inicia OpenClaw en tu proyecto y haz un cambio que afecte tu API, o simplemente pídele que ejecute la verificación. Como AGENTS.md ya está en contexto, el agente sabe que la CLI existe y emite el comando apidog run a través de su herramienta exec.
La herramienta exec ejecuta comandos de shell en el espacio de trabajo, y OpenClaw lo restringe con un modo de permiso. Los modos son deny, allowlist, ask, auto y full (documentados en la página de modos de permiso de OpenClaw). Para un agente de codificación, auto es la configuración sensata: los comandos en la lista de permitidos se ejecutan sin una solicitud, y cualquier otra cosa pasa por revisión antes de que te pregunte. Si tu modo es ask, OpenClaw se detiene y solicita aprobación antes de ejecutar apidog run; aprueba una vez, o añade el comando a tu lista de permitidos para que una prueba de solo lectura contra el entorno de ensayo se ejecute por sí sola. Establece el modo en tools.exec en openclaw.json.
Paso 4: Lee el informe dentro de OpenClaw
El reportero -r cli imprime un resultado paso a paso en la terminal: cada solicitud, cada aserción y cuál falló con el valor esperado versus el real. Ese desglose en línea es lo que OpenClaw lee para decidir su próximo paso, así que mantén cli en la lista.
Cuando quieras un informe que puedas abrir en un navegador o entregar a un compañero de equipo, añade el reportero HTML:
apidog run -t 1234567 -e 890123 -r cli,html
El reportero html escribe un archivo autocontenido en ./apidog-reports. Mantén cli junto a él para que OpenClaw siga obteniendo la salida en línea. Para el formato JUnit que los paneles de CI parsean y cualquier otro reportero, consulta la guía de informes de pruebas de la CLI de Apidog.
Pruebas de OpenClaw dentro de su propio bucle
El punto es lo que sucede cuando dejas de preguntar y OpenClaw ejecuta el escenario por sí mismo porque AGENTS.md se lo indicó.
Imagina a OpenClaw editando un manejador que construye una respuesta de pago. Su bucle cambia: edita el código, luego, en lugar de declarar la victoria, ejecuta tu escenario de Apidog contra el entorno de ensayo, lee el código de salida y actúa en consecuencia. Si es verde, sigue adelante. Si es rojo, abre el informe, lee qué aserción falló (el código de estado, el campo faltante, el valor incorrecto), intenta una corrección y vuelve a ejecutar. La prueba de API se convierte en parte del mismo bucle de editar-probar-corregir por el que OpenClaw ya ejecuta tus pruebas unitarias. Escribiste una instrucción y el agente incorporó el comando a su funcionamiento.
Este es el modelo de delegar-luego-verificar que hace que cualquier flujo de trabajo de agente sea seguro. OpenClaw ejecuta el comando y lee el resultado; tú sigues creando escenarios visualmente en Apidog y verificas que el agente lea los códigos de salida honestamente. Para el patrón más amplio, consulta cómo usar agentes de IA para pruebas de API y el arnés de pruebas de IA de Apidog.
Verifica que OpenClaw realmente está ejecutando la CLI
Los agentes informan éxitos que no lograron, y OpenClaw no es una excepción. Tres comprobaciones, en orden de la frecuencia con la que detectan problemas.
Primero, confirma que el comando se ejecutó en absoluto. La transcripción de OpenClaw muestra los comandos exec que ejecutó y su salida. Busca la línea literal apidog run ... y un resultado debajo. Si OpenClaw dice que ejecutó las pruebas pero no ves el comando, resumió algo que nunca hizo. Pídele que lo ejecute de nuevo y muestre la salida en bruto.
Segundo, confirma el código de salida, el que importa. Pregúntale directamente:
¿Cuál fue el código de salida de ese comando apidog run?
apidog run sale con 0 cuando todas las aserciones pasan y con un valor distinto de cero cuando algo falla. Ese comportamiento único permite a OpenClaw, o a una tubería, tratar la ejecución como una puerta limpia. Cuando la prosa dice "pruebas pasaron" pero el código de salida es distinto de cero, el código de salida es el correcto.
Tercero, confirma que usó el escenario real. Si una ejecución falla con "scenario not found" (escenario no encontrado), OpenClaw puede haber inventado o recordado mal un ID. Vuelve a verificar los valores -t y -e contra AGENTS.md y el comando que Apidog generó en la pestaña CI/CD. Los IDs en AGENTS.md son la verdad.
Opcional: conecta el servidor MCP de Apidog
Ejecutar apidog run a través de la herramienta exec cubre la mayor parte de lo que necesitas. Una ruta va más allá: el Protocolo de Contexto del Modelo (Model Context Protocol).
OpenClaw soporta servidores MCP. Puedes añadir uno con openclaw mcp add <name>, que escribe la definición del servidor en ~/.openclaw/openclaw.json bajo mcp.servers y acepta banderas stdio como --command y --arg (consulta la documentación de MCP de OpenClaw). El servidor MCP de Apidog expone tus especificaciones de API a través de MCP, para que OpenClaw pueda leer tu esquema mientras escribe código, no solo después del hecho. La división del trabajo es limpia: la CLI ejecuta las pruebas, y MCP alimenta al agente con la especificación.
Cuando OpenClaw se equivoca
Algunos fallos aparecen a menudo durante la configuración.
Ignora el bloque AGENTS.md. Si OpenClaw ejecuta un comando genérico o ninguno, el archivo puede no estar cargándose en contexto. Confirma que el bloque se encuentra en el AGENTS.md que pertenece al espacio de trabajo activo del agente, y recuerda que OpenClaw recorre los archivos AGENTS.md con ámbito por directorio, por lo que una regla enterrada en el subárbol incorrecto se omite. Reiniciar la sesión fuerza una lectura fresca.
Nunca ejecuta nada porque exec está bloqueado. Dado que la política predeterminada de OpenClaw se ha vuelto más estricta, la ejecución puede ser denegada o retenida detrás de una lista de permitidos. Si apidog run se omite silenciosamente, verifica tu modo de permiso en tools.exec y cambia a auto o añade apidog a la lista de permitidos. Consulta la guía de instalación segura de OpenClaw para saber cómo habilitar solo este comando sin habilitar todo.
De todos modos, pasa un token de acceso. Si OpenClaw intenta añadir --access-token, está adivinando a partir de ejemplos públicos. El bloque ya le dice que no lo haga, ya que la máquina está autenticada a través de apidog login. Refuerza la línea, y nunca pongas un token real en AGENTS.md; para el patrón correcto, consulta la autenticación de la CLI de Apidog.
Inventa una bandera. Un error de "opción desconocida" significa que OpenClaw adivinó una bandera que tu versión no tiene. Dile que ejecute apidog run --help y copie la bandera exacta de ahí, la cual siempre es correcta para tu versión instalada.
Informa un éxito en una ejecución fallida. El más costoso, y la razón por la que la regla del código de salida está en tu AGENTS.md y en tu paso de verificación. Cuando el resumen y el código de salida no concuerdan, el código de salida es el que prevalece. Si has usado otro agente para esto, la misma regla se mantiene; el enfoque refleja lo que cubrimos en CLI de Apidog en Codex y las diferencias en Claude Code vs OpenClaw.
De un agente diario a un bucle probado
Esa es la configuración. Instala apidog-cli una vez siguiendo la guía de instalación, añade un bloque corto de Apidog a tu AGENTS.md del espacio de trabajo, configura el modo de permiso de ejecución para que el comando pueda ejecutarse, y OpenClaw sabrá cómo ejecutar tus pruebas de API y leer el resultado dentro del mismo bucle que ya usa para editar código. Un endpoint roto se detecta mientras OpenClaw aún está trabajando en el cambio, no después de que se implemente.
Una prueba detrás de una GUI se ejecuta cuando un humano hace clic; un comando de una sola línea se ejecuta cuando OpenClaw lo decide. Sigues construyendo escenarios visualmente en Apidog, y tu agente los ejecuta donde no estás mirando. Descarga Apidog, construye un escenario, inserta su comando apidog run en AGENTS.md, y observa cómo OpenClaw lo toma en el siguiente cambio. Cuando quieras la misma puerta en una tubería sin la presencia del agente, CLI de Apidog en Acciones de GitHub cubre los secretos, reporteros y la verificación del código de salida.