Conceptos

Estos son los términos que la Guía rápida y la referencia de configuración dan por sentados. Cada uno tiene una página más detallada enlazada al final de su definición.

Alias. Un alias es el nombre que asignas a una instancia configurada, y que luego referencias en otros lugares para apuntar a ella. Eliges el nombre libremente; otras partes de la configuración conectan los elementos mediante ese nombre. Los alias están compuestos por letras ASCII en minúscula, dígitos y guiones bajos simples, deben comenzar y terminar con una letra o dígito, y no pueden contener __ ni guiones. En la configuración aparecen como el segmento <alias> del encabezado de una sección, como [agents.<alias>] o [providers.models.<type>.<alias>]. Consulta Referencia → Variables de entorno → Gramática de alias.

Proveedor de modelos. Un proveedor de modelos es la abstracción de ZeroClaw sobre un endpoint de LLM. Toda solicitud de chat-completion pasa por un proveedor, ya sea que el destino sea una API remota, un servidor autoalojado o un modelo local de Ollama. Los proveedores se tipifican por familia de proveedor, y puedes ejecutar varias instancias con nombre de la misma familia. En la configuración, cada uno reside en [providers.models.<type>.<alias>]. Consulta Model Providers → Overview.

Perfil de riesgo. Un perfil de riesgo es una postura de autonomía y sandbox con nombre. Su nivel es readonly, supervised (el predeterminado) o full, y controla si las herramientas se ejecutan automáticamente, solicitan aprobación o se bloquean. Cada agente hace referencia exactamente a un perfil de riesgo. En la configuración se encuentra en [risk_profiles.<alias>]. Consulte Seguridad → Niveles de autonomía.

Perfil de runtime. Un perfil de runtime es un ajuste operativo reutilizable: modo agéntico, límites de iteraciones de herramientas, presupuestos de acciones y costos, tiempos de espera, límites de contexto y política de delegación. Es independiente del perfil de riesgo, que rige la autonomía. Quickstart instala el preset unbounded para agentes nuevos; ajuste los campos después. En la configuración se ubica en [runtime_profiles.<alias>]. Consulte Reference → Config.

Multiagente. ZeroClaw ejecuta muchos agentes desde una sola instalación. Cada agente tiene su propio conjunto de referencias (perfil de riesgo, proveedor de modelo, canales), su propio directorio de espacio de trabajo y su propio backend de memoria. Un agente puede generar un SubAgent efímero que hereda la identidad y la política de seguridad de su padre, y los agentes pueden comunicarse entre sí cuando comparten un peer group. En la configuración, cada agente es un bloque [agents.<alias>]. Consulte Agentes → Detalles internos del runtime.

Grupo de pares. Un grupo de pares declara un conjunto de comunicación entre agentes con suscripción voluntaria en un solo canal. La membresía es mutua: dos agentes son pares solo cuando ambos aparecen en la lista de miembros del mismo grupo. En la configuración se encuentra en [peer_groups.<name>]. Consulte Agents → Runtime internals.

Paquete de habilidades. Un paquete de habilidades es un grupo reutilizable de habilidades adjunto a un agente o canal mediante un alias. Controla qué habilidades se cargan y desde dónde: un directorio de origen más listas opcionales de inclusión y exclusión. Las habilidades en sí son instrucciones reutilizables y definiciones opcionales de herramientas. En la configuración, un paquete se ubica en [skill_bundles.<alias>]. Consulte Tools → Skills.