# Instrucciones para el agente: OpenHands Agent Canvas: coordina agentes y automatizaciones

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: intermedio
- Proyecto: https://github.com/OpenHands/OpenHands (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/openhands

---

## 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: prepara los requisitos

En macOS o Linux confirma Node.js 24+, npm, uv y Docker. El README documenta esta modalidad:

```bash
npm install -g @openhands/agent-canvas
OH_CONVERSATION_RUNTIME=docker agent-canvas
```

### Paso 2: configura el acceso al modelo

Visita http://localhost:8000 y elige la ruta con el agente OpenHands para esta prueba. Antes de crear la conversación, abre Settings → LLM, selecciona proveedor y modelo y configura su acceso privado. Pulsa Save Changes y confirma que el perfil queda activo para conversaciones nuevas; si eliges uno ya guardado, márcalo con Set as Active. Sigue la [documentación oficial de perfiles](https://docs.openhands.dev/openhands/usage/settings/llm-settings#creating-an-llm-profile). No continúes si el acceso falla o el modelo no está disponible.

Instalar Canvas no autentica los agentes ACP externos, como Claude Code o Codex. Esas variantes requieren sus propios agentes y accesos y quedan fuera de esta prueba.

### Paso 3: comprueba una lectura

Prepara una carpeta de prueba con `nota.txt` que contenga `Prueba Canvas: 4 unidades.`. Crea una conversación nueva con el agente OpenHands, el perfil activo y esa carpeta como espacio de trabajo. La opción Docker no transforma conversaciones locales antiguas en contenedores. Pide: «Lee nota.txt y devuelve su contenido literal y el número de unidades. No modifiques archivos. Si falta el archivo o el acceso al modelo, detente y explica el bloqueo».

## Comprobación

Comprueba el perfil, el backend de la conversación y qué directorio monta. La respuesta debe reproducir `Prueba Canvas: 4 unidades.` e identificar 4 unidades. Confirma que `nota.txt` conserva su contenido. Abrir la interfaz no acredita que el modelo funcione.

## Si algo falla

Si Docker no responde, resuelve el entorno de ejecución antes de iniciar la conversación. Para Windows sigue README.windows.md. Para acceso remoto consulta SELF_HOSTING.md.