# Instrucciones para el agente: OpenWorker: completa tareas de trabajo desde una aplicación de escritorio

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: principiante
- Proyecto: https://github.com/andrewyng/openworker (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/openworker-desktop-agent

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: descarga el paquete adecuado

Usa los enlaces de Download del README oficial o https://openworker.com. Comprueba plataforma y requisitos. Para Windows lee el aviso actual de firma antes de instalar; no confundas ese aviso con una comprobación de integridad superada.

### Paso 2: elige el modelo

Abre la aplicación y configura tu proveedor o apunta a Ollama. Usa la pantalla de ajustes para las claves; no las pegues en la conversación. Si buscas ejecución local, comprueba también que los conectores elegidos no envían datos fuera.

### Paso 3: limita la primera tarea

Selecciona un especialista y una carpeta de prueba. Pide una revisión de un repositorio pequeño y examina los hallazgos antes de aceptar cambios. Para tareas con comandos, consulta docs/openshell.md y configura el aislamiento si tu caso lo necesita.

### Paso 4: revisa el entregable

Abre el resultado, contrasta los hallazgos con el código y revisa el registro de acciones. Incorpora conectores solo cuando una tarea concreta los requiera.

## Comprobación

Comprueba que el proveedor responde, que el agente trabaja sobre la carpeta correcta y que el resultado existe y puede revisarse. En una corrección de código, verifica los cambios de código y las comprobaciones del proyecto antes de aceptarla.

## Si algo falla

Si no hay respuesta del modelo, comprueba el proveedor activo y su configuración. Si una herramienta está bloqueada, revisa la política y el registro antes de ampliar permisos. Para aislamiento de comandos consulta la guía de OpenShell en lugar de asumir que el servidor local lo aporta.

Fuente: [documentación del proyecto](https://github.com/andrewyng/openworker/blob/59151e3b306d9edc2b22e6e2bb4443316f563f47/README.md).
