OpenClawsOpenClaws

Crear Agentes

Guia paso a paso para crear y configurar agentes de IA desde el panel de control de OpenClaws.

Paso 1: Accede al Panel de Control

Inicia sesion en openclaws.mx con tu cuenta de Google. Seras redirigido automaticamente al panel de control donde puedes ver tus agentes existentes y el uso de recursos.

Paso 2: Haz Clic en "Agregar Agente"

En el panel de control, haz clic en el boton "+ Agregar Agente" en la parte superior. Esto te llevara al formulario de creacion de agentes.

Paso 3: Ingresa el Nombre del Agente

Escribe un nombre para tu agente. Las reglas de nomenclatura son:

  • Solo letras minusculas, numeros y guiones
  • Debe empezar con una letra
  • Maximo 31 caracteres
  • Ejemplos: manager, researcher, web-dev-1

Opcionalmente puedes agregar un nombre para mostrar (ej. "Gerente de Proyectos") que aparecera en la interfaz en lugar del ID tecnico.

Paso 4: Selecciona un Rol

Elige un rol predefinido que configura automaticamente el modelo, prompt del sistema y las herramientas del agente. Los roles disponibles son:

Manager

Orquestador principal que delega tareas a otros agentes. Ideal como primer agente.

Desarrollador Web

Especialista en desarrollo de software. Puede ejecutar codigo, leer y escribir archivos.

Creador de Contenido

Genera contenido escrito, articulos, y material de comunicacion.

Marketing

Estratega de marketing digital con acceso a busqueda web y navegador.

Ventas

Asistente de ventas para prospeccion e investigacion de mercado.

Investigador

Especialista en investigacion profunda con busqueda web y analisis.

Analista de Datos

Analiza datos, ejecuta scripts y genera reportes.

Personalizado

Configuracion completamente manual. Tu defines el modelo, prompt y herramientas.

Paso 5: Configura la Clave de API

OpenClaws usa el modelo BYOK (Bring Your Own Key) — tu proporcionas tu propia clave de API del proveedor de LLM. La clave se cifra con Vault Transit (AES-256-GCM) antes de almacenarla.

El campo de clave de API se ajusta automaticamente segun el modelo seleccionado:

ProveedorFormato de ClaveDonde Obtenerla
Anthropicsk-ant-...console.anthropic.com
GoogleAIza...aistudio.google.com
OpenAIsk-proj-...platform.openai.com

Solo necesitas proporcionar la clave para tu primer agente. Los agentes siguientes reusan la misma clave automaticamente.

Paso 6: Configuracion Avanzada (Opcional)

Haz clic en "Configuracion Avanzada" para personalizar:

Modelo

Selecciona el modelo de IA. Los modelos estan agrupados por proveedor:

  • Anthropic: Claude Opus 4.6 (predeterminado), Sonnet 4.6, Haiku 4.5
  • Google: Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.0 Flash
  • OpenAI: GPT-4.1, GPT-4.1 Mini, GPT-4.1 Nano, o3, o4-mini

Prompt del Sistema

Define las instrucciones base del agente. Cada rol incluye un prompt predeterminado que puedes personalizar. Usa el boton "Expandir" para agrandar el campo de texto y trabajar con prompts largos.

Herramientas

Controla las herramientas que el agente puede usar:

  • read / write — Leer y escribir archivos
  • exec — Ejecutar comandos
  • web_search — Buscar en internet
  • browser — Navegar paginas web
  • sessions_spawn — Comunicacion multi-agente

Servidores MCP

Conecta herramientas externas via Model Context Protocol. Agrega la URL del servidor y opcionalmente un token de autenticacion.

Paso 7: Despliega el Agente

Haz clic en "Desplegar Agente". Veras la secuencia de despliegue en tiempo real:

  1. Cifrado de la clave de API via Vault Transit
  2. Almacenamiento de credenciales en Vault KV v2
  3. Creacion de intenciones en el service mesh de Consul
  4. Descarga de la imagen del contenedor OpenClaw
  5. Inicio del contenedor en Nomad
  6. Verificacion de salud del servicio
  7. Registro del sidecar en el service mesh

El despliegue completo toma menos de 60 segundos.

Paso 8: Interactua con Tu Agente

Una vez que el agente muestre el estado "Running", tienes dos formas de interactuar:

  • Chat integrado — Haz clic en el agente y usa la interfaz de chat directamente desde el panel de control.
  • API REST — Envia mensajes programaticamente usando el endpoint POST /api/v1/users/{user}/agents/{agent}/chat.

Patron Recomendado: Multi-Agente

Para sacar el maximo provecho de OpenClaws, te recomendamos el patron Manager + Especialistas:

  1. Crea un agente manager con el rol "Manager" — este sera tu orquestador principal.
  2. Agrega agentes especialistas (ej. researcher, web-dev) con roles especificos.
  3. El manager puede delegar tareas a los especialistas usando sessions_spawn.

Todos los agentes corren en un solo contenedor, asi que la comunicacion entre ellos es instantanea (in-process, sin red).

Siguientes Pasos