Haz que Claw escriba código: exec, parches y aprobaciones
💡 Resumen en una frase: escribe código con OpenClaw y establece un flujo de trabajo de codificación local de «comandos ejecutables, parches revisables y alguien que supervise la aplicación»: exec ejecuta comandos, apply_patch produce parches y la política de aprobaciones vigila los límites.
Qué podrás hacer al terminar
- Hacer que Claw ejecute de verdad comandos como
npm testen tu espacio de trabajo y que entiendas las causas de los fallos. - Hacer que Claw use
apply_patchpara modificar varios archivos y fragmentos de código de una vez, produciendo parches estructurados. - Configurar bien la política de aprobaciones de
tools.exec.mode, de modo que los comandos de alto riesgo se ejecuten solo tras confirmarse uno a uno. - Activar Code Mode cuando sea necesario, para que el modelo escriba pequeños programas en JavaScript que busquen y llamen a herramientas.
Por qué usar OpenClaw y no una IA web
| Capacidad | IA web | OpenClaw |
|---|---|---|
| Ejecutar comandos | ❌ Solo puede dar sugerencias; tú copias y pegas | ✅ exec ejecuta dentro de los límites permitidos por el sistema de archivos del host o sandbox elegido |
| Cambios en varios archivos | ❌ Se pega un archivo a la vez, fácil olvidar algo | ✅ apply_patch un solo parche engloba añadir, modificar, mover y eliminar |
| Control de seguridad | ❌ No existe política local alguna | ✅ policy + allowlist + aprobación opcional del usuario: tres capas de control |
| Autoalojado | ❌ El código debe subirse a servidores de terceros | ✅ El Gateway corre en tu máquina y los comandos se quedan en el espacio de trabajo local |
Tu situación actual
- Cada vez que pides a la IA que cambie código, es «pegar código → copiar de vuelta al editor → ejecutar las pruebas a mano», un ir y venir constante.
- Los cambios que da la IA quedan dispersos en varios tramos de la conversación y no sabes qué archivos modificó exactamente.
- Quieres que la IA ejecute comandos directamente, pero temes que ejecute algo que no debería.
Cuándo usar esta técnica
- Arreglar un bug requiere a la vez tocar el código fuente, añadir pruebas y ejecutar una ronda de verificación.
- Una refactorización implica mover o renombrar varios archivos.
- Quieres que tanto «ejecutar comandos» como «modificar archivos» ocurran en tu propia máquina, con cada paso auditable.
🎒 Preparativos antes de empezar
- El Gateway ya está corriendo en tu máquina y el proveedor del modelo ya está conectado (Node 24.16.0+ o 26.1.0+).
- Ten claro el límite del espacio de trabajo:
execejecuta dentro de lo permitido por el sistema de archivos del host o sandbox elegido, y los comandos pueden crear, editar y eliminar archivos. - Define el nivel de aprobación: las aprobaciones de OpenClaw 2.0 se vinculan a la petición, el comando, la sesión y la persona exactas; lo que se aprueba es «este comando, esta vez», no una autorización general de la herramienta.
Hazlo conmigo
Paso 1: ejecutar comandos con exec
Por qué: primero haz que Claw pueda ejecutar comandos; así la modificación de código y la verificación posteriores tienen una base.
Dile directamente a Claw:
Ejecuta npm test en el espacio de trabajo y recopílame los nombres de las pruebas fallidas y los mensajes de error.Deberías ver: los comandos en primer plano devuelven la salida directamente al terminar. Solo cuando exec indique que el comando sigue en ejecución y proporcione sessionId, usa process para tomar el control; el ID que el propio comando imprime es solo salida normal, no un identificador de proceso. Si el comando falla, el campo message incluye un diagnóstico breve, separado de la salida del comando que aparece en aggregated.
Paso 2: generar y aplicar parches
Por qué: un parche estructurado es más centralizado y auditable que «reescribir archivos concatenando cadenas», y cubre varios archivos de una vez.
Dile a Claw:
Usa apply_patch para arreglar la prueba que acaba de fallar: cambia foo de 1 a 2 en src/index.ts,
y añade una aserción en tests/foo.test.ts.Deberías ver: Claw llama a apply_patch, que acepta un único parámetro obligatorio input, con el formato de parche siguiente:
*** Begin Patch
*** Add File: path/to/file.txt
+line 1
+line 2
*** Update File: src/app.ts
@@
-old line
+new line
*** Update File: src/old-name.ts
*** Move to: src/new-name.ts
*** End of File
*** Delete File: obsolete.txt
*** End PatchLa llamada JSON correspondiente tiene esta forma:
{
"tool": "apply_patch",
"input": "*** Begin Patch\n*** Update File: src/index.ts\n@@\n-const foo = 1\n+const foo = 2\n*** End Patch"
}*** Move to: se escribe en la línea siguiente al encabezado *** Update File: correspondiente; *** End of File marca que ese hunk se extiende hasta el final del archivo. Las rutas de los parches admiten rutas relativas (respecto al directorio del workspace) y absolutas.
💡 Este es el valor exclusivo de OpenClaw
apply_patch es una subherramienta de exec y está habilitada por defecto. tools.exec.applyPatch.workspaceOnly tiene como valor predeterminado false; si se establece en true se puede limitar el parche al workspace; además, se puede usar tools.exec.applyPatch.allowModels para restringir qué modelos pueden usarlo. Nota: establecer tools.exec.mode en "full" no elimina este límite del workspace.
Paso 3: aprobar antes de aplicar
Por qué: el comando va a modificar de verdad tu máquina, y este paso lo supervisa una persona.
Los comandos de alto riesgo pasan por aprobación antes de ejecutarse: la aprobación de exec tiene tres capas: policy + allowlist + (opcional) aprobación del usuario; el comando solo se ejecuta si las tres lo permiten. La escritura de parches no pasa por este panel de aprobación, sino que está sujeta a la política de herramientas, workspaceOnly y el modo de permisos de la sesión (full elimina las restricciones, guarded/workspace las refuerza, read-only directamente niega esta herramienta).
Deberías ver: si en el panel de aprobación eliges Allow Once (o presionas Command-Return), solo autorizas esta única ejecución; Always Allow Here solo aparece cuando la política permite aprobaciones persistentes, y al confirmar se guarda como una regla de permiso persistente vinculada a los argumentos exactos del comando y al directorio de trabajo en el momento de la aprobación.
Paso 4: configurar la política de aprobación
Por qué: la política por defecto no necesariamente se ajusta a tu criterio; defínela con el campo de configuración.
Usa tools.exec.mode en la configuración para definir la política principal:
| Valor | Comportamiento |
|---|---|
deny | Bloquea host exec |
allowlist | Solo ejecuta los comandos de la allowlist, sin preguntar |
ask | Política de allowlist + preguntar cuando no hay coincidencia |
auto | Si hay coincidencia, se ejecuta directamente; si no, se puede allow (una vez), deny (el motivo se devuelve al agent) o ask (aprobación manual) |
full | No pasa por las preguntas de la política convencional |
Campos complementarios: exec.ask (off/on-miss/always, por defecto off), askFallback (respaldo cuando no hay UI accesible o hay timeout, por defecto deny), tools.exec.strictInlineEval (clasifica las formas de evaluación en línea como python -c y node -e como sujetas a aprobación), tools.exec.commandHighlighting (solo afecta el resaltado del panel de aprobación).
Deberías ver: tras modificar la configuración, la política efectiva toma el más estricto entre tools.exec.* y el valor por defecto de approvals: approvals solo refuerza, nunca relaja la política derivada de la configuración.
Paso 5: habilitar Code Mode cuando sea necesario
Por qué: cuantas más herramientas, más schemas ve el modelo; Code Mode le permite escribir pequeños programas en JavaScript para buscar, describir y llamar al catálogo de herramientas.
Cómo habilitarlo: tools.codeMode usa por defecto el nivel "auto" y solo surte efecto en los modelos marcados como preferidos para Code Mode; en Settings → Agents & Tools → Labs → Code Mode se elige el ajuste global, y también se puede activar mediante overrides en las tres capas: global / agent / model.
Deberías ver: tras habilitarlo, el modelo solo ve unas pocas herramientas como exec y wait; exec acepta una carga JSON { code }; ten en cuenta que aquí command es un alias en JavaScript de code, no un comando de shell.
📋 Prompt mágico
🔧 Ejecutar pruebas y corregir
Resultado esperado: Claw primero ejecuta las pruebas para localizar los fallos, luego corrige con parches, y en todo el proceso no toca rutas fuera del workspace.
Rol: asistente de código local
Tarea: ejecutar npm test en el workspace, encontrar las pruebas fallidas y usar apply_patch para corregir el código fuente o las pruebas
Información de entrada:
### Campos obligatorios ###
【Mensajes de error de las pruebas fallidas】
### Campos opcionales ###
【Lista de archivos que no se deben modificar?】
Especificación de salida: primero una frase con la causa del fallo, luego el contenido del parche, y por último reejecutar las pruebas y pegar el resultado
Condiciones de restricción:
✅ Usar solo apply_patch para modificar archivos
✅ Mantener las rutas de los parches dentro del【directorio del workspace】
❌ No usar exec para reescribir el archivo completo
❌ No modificar ninguna ruta fuera del workspace🚀 Refactorización y movimiento
Resultado esperado: un solo parche completa el renombrado y la actualización de referencias.
Rol: asistente de refactorización
Tarea: renombrar src/old-name.ts como src/new-name.ts y actualizar todas las referencias
Información de entrada:
### Campos obligatorios ###
【Ruta del archivo antiguo】【Ruta del archivo nuevo】
### Campos opcionales ###
【Ámbito de directorios que deben actualizarse en sincronía?】
Especificación de salida: un parche de apply_patch, usando Move to para completar el renombrado
Condiciones de restricción:
✅ Renombrado y actualización de referencias en el mismo parche
✅ Ejecutar una vez la compilación para verificar tras los cambios
❌ No dejar el archivo antiguo
❌ No modificar archivos no relacionadosPunto de control ✅
- ¿El comando terminó de verdad? En hosts node sin interfaz, los comandos terminados por señales del sistema incluyen el nombre de la señal en el resultado; que haya habido salida impresa antes de la terminación no significa que el comando haya tenido éxito.
- ¿Ejecutar en segundo plano las tareas largas? En Linux, los comandos en segundo plano gestionados por el Gateway pueden habilitar durable execution y sobrevivir al reinicio del Gateway.
- ¿Hay memoria suficiente? En Linux, el exec gestionado por el Gateway tiene por defecto un límite de memoria: toma el menor entre un cuarto de la memoria del host (o la restricción del cgroup) y la mitad de la memoria restante tras la residencia del propio Gateway, sin necesidad de configuración.
Avisos de errores comunes
execes una superficie de shell mutable: deshabilitarwrite,edityapply_patchno convierteexecen solo lectura. No uses «desactivar herramientas» como respaldo; si hay que configurar un sandbox, configúralo.- La ejecución remota con
host=nodeusasystem.runsíncrono y no crea una sesiónprocess; cuandoprocessestá prohibido, el exec local se ejecuta de forma síncrona, ignorandoyieldMsybackground, y durable execution se rechaza. tools.fs.workspaceOnlyytools.exec.applyPatch.workspaceOnlyincluyenapply_patchcada uno de forma independiente; si eliminas uno, el otro puede seguir vigente.
Resumen de esta lección
Escribiendo código con OpenClaw, en esta lección has completado la cadena íntegra: exec ejecuta comandos en el workspace local y devuelve diagnósticos de fallos, apply_patch modifica varios archivos a la vez con parches estructurados, la política de aprobación (tools.exec.mode + allowlist + confirmación del usuario) protege los comandos de alto riesgo, y Code Mode le da al modelo una vía de llamada más económica cuando hay muchas herramientas. La escritura de parches no pasa por el panel de aprobación, sino que se rige por workspaceOnly, el modo de permisos de la sesión y los límites del sandbox: dos líneas que se ocupan cada una de lo suyo, no las mezcles.
Avance de la próxima lección
Con el código ya modificado, el siguiente paso es que Claw vigile el repositorio: Guardia de GitHub: resúmenes de PR y gestión automática de issues. Para restringir los permisos de herramientas, lee Endurecimiento de seguridad (II): permisos de herramientas y sandbox; si quieres usar modelos nacionales más económicos para codificar, consulta Integración de DeepSeek: configuración práctica de los modelos de la serie V4.