Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

Ayuda de línea de comandos para zeroclaw

Este documento contiene el contenido de ayuda para el programa de línea de comandos zeroclaw.

Descripción general del comando:

zeroclaw

El asistente de IA más rápido y pequeño.

Uso: zeroclaw [OPCIONES] <COMANDO>

Subcomandos:

  • quickstart — Inicio rápido: crea un agente funcional de principio a fin. Reemplaza el flujo de incorporación sección por sección con una única ruta basada en preajustes. Interactivo: los flags siguientes precargan los selectores de la lista de verificación, pero no los omiten; se requiere un terminal
  • onboard — Obsoleto. Use zeroclaw quickstart. Cualquier flag genera error
  • agent — Iniciar el bucle del agente de IA
  • gateway — Iniciar/gestionar el servidor de gateway (webhooks, websockets)
  • acp — Iniciar el servidor ACP (Protocolo de Control de Agentes) a través de stdio
  • daemon — Iniciar el tiempo de ejecución autónomo de larga duración (gateway + canales + latido + programador)
  • service — Administrar el ciclo de vida del servicio del sistema operativo (servicio de usuario de launchd/systemd)
  • doctor — Ejecuta diagnósticos para la frescura del daemon/programador/canal
  • status — Mostrar el estado del sistema (detalles completos)
  • estop —
  • cron — Configurar y gestionar tareas programadas
  • models — Gestionar los catálogos de modelos de model_provider
  • providers — CRUD de alias para proveedores ([providers.<category>.<family>.<alias>]). category es uno de models, tts, transcription
  • channel — Administrar canales (Telegram, Discord, Slack)
  • agents — Gestiona alias de agentes (create/list/rename/delete). Distinto de agent, que ejecuta un agente
  • channels — Gestionar alias de canales (crear/listar/renombrar/eliminar)
  • integrations — Explora más de 50 integraciones
  • skills — Administrar habilidades (capacidades definidas por el usuario)
  • browse — Explora el espacio de trabajo compartido un directorio a la vez
  • sop — Gestionar procedimientos operativos estándar (SOP)
  • migrate — Migrar datos desde otros entornos de ejecución de agentes
  • auth — Gestionar perfiles de autenticación de suscripción de model_provider
  • hardware — Descubrir e inspeccionar el hardware USB
  • peripheral — Gestiona periféricos de hardware (STM32, GPIO de RPi, etc.)
  • memory — Administrar la memoria del agente (listar, obtener, estadísticas, limpiar)
  • config — Administrar la configuración
  • update — Buscar y aplicar actualizaciones
  • self-test — Ejecutar pruebas de diagnóstico
  • completions — Genera el script de autocompletado de shell en stdout
  • desktop — Inicia la aplicación de escritorio complementaria o abre su página de descarga
  • locales — Obtener archivos de configuración regional traducidos (FTL) desde upstream

Opciones:

  • --config-dir <DIRECTORIO_CONFIG>

  • --log-level <LOG_LEVEL> — Severidad mínima registrada en la traza de tiempo de ejecución (y la capa de captura). Inmutable para el proceso. Precedencia: este flag > variable de entorno RUST_LOG > valor predeterminado por comando

    Valores posibles: error, warn, info, debug, trace

  • -v, --verbose — Muestra los registros grabados en la terminal. Desactivado por defecto: los registros van solo al archivo de traza y la terminal muestra únicamente la salida del comando. Cuando está activado, la terminal muestra eventos hasta el nivel mínimo grabado. Inmutable durante el proceso

zeroclaw quickstart

Inicio rápido: crea un agente funcional de principio a fin. Reemplaza el flujo de incorporación sección por sección con una única ruta basada en preajustes. Interactivo: los flags a continuación rellenan previamente los selectores de la lista de verificación, pero no los omiten; se requiere un terminal

Uso: zeroclaw quickstart [OPTIONS]

Opciones:

  • --model-provider <MODEL_PROVIDER> — Tipo de proveedor (anthropic / openai / openrouter / ollama)
  • --model <MODEL> — ID del modelo para la nueva entrada del proveedor
  • --api-key <API_KEY> — Clave de API para la nueva entrada de proveedor (omitir para ollama / local)
  • --agent <AGENT> — Alias para el nuevo agente. De forma predeterminada usa un nombre de proveedor sanitizado

zeroclaw onboard

Obsoleto. Use zeroclaw quickstart. Cualquier flag produce un error

Uso: zeroclaw onboard [COMMAND]

Subcomandos:

  • providers.models — Elige un proveedor de modelos para configurar (Anthropic, OpenAI, OpenRouter, Ollama, gateways personalizados compatibles con OpenAI, etc.). Se admiten múltiples alias por proveedor; por ejemplo, anthropic.production y anthropic.dev pueden coexistir
  • model_routes — Pistas de enrutamiento de modelos con nombre (p. ej., reasoning, fast, code). Cada ruta asigna una pista a una combinación específica de proveedor + modelo. Usa hint:<name> como parámetro del modelo para enviar a través de una ruta
  • embedding_routes — Sugerencias de enrutamiento de embeddings con nombre (p. ej. semantic, archive, faq). Cada ruta asigna una sugerencia a una combinación de proveedor + modelo capaz de generar embeddings. Usa hint:<name> como el parámetro embedding_model
  • risk_profiles — Perfiles de riesgo con nombre que vinculan listas de permitidos, listas de denegados y umbrales de aprobación. Los agentes hacen referencia a uno mediante agents.<alias>.risk_profile
  • runtime_profiles — Perfiles de ajuste de tiempo de ejecución con nombre (límites de tokens, política de reintentos, tiempos de espera). Los agentes hacen referencia a uno mediante agents.<alias>.runtime_profile
  • storage — SQLite es la opción predeterminada segura para instalaciones de un solo nodo (basado en archivos, sin configuración, sin servicios adicionales). Elija Postgres para despliegues compartidos o de múltiples instancias, Qdrant para búsqueda vectorial, Markdown o Lucid para archivos legibles por humanos. Cada backend admite múltiples instancias con alias; los agentes hacen referencia a ellas mediante memory.storage_ref
  • memory — Backend de memoria persistente. SQLite es el predeterminado; selecciona none para deshabilitar por completo la recuperación a largo plazo
  • skills — Configuración de la herramienta de skills: dónde se almacenan los archivos markdown de skills en disco (por defecto, en el directorio de datos) y cómo el cargador de skills gestiona los repositorios de la comunidad. Agrega BUNDLES de skills en skill-bundles más abajo
  • skill_bundles — Paquetes con nombre de archivos de habilidades. Los agentes hacen referencia a un paquete para cargar un conjunto de capacidades al iniciar
  • mcp — Configuración de Model Context Protocol. Activa o desactiva enabled y elige carga diferida o anticipada. Los servidores MCP individuales se encuentran en mcp.servers[]
  • mcp.servers — Servidores individuales de Model Context Protocol. Cada entrada vincula un transporte (stdio, http, sse), el comando o la URL para alcanzarlo, encabezados opcionales y un límite tool_timeout_secs (≤ 600). El name de cada servidor es su clave direccionable: renómbralo mediante la página de sección en lugar de editar el campo directamente. Agrupa servidores en paquetes bajo mcp_bundles a continuación
  • mcp_bundles — Paquetes con nombre de servidores MCP, concedidos a los agentes que incluyan el paquete en su mcp_bundles. Seguro por defecto: un agente obtiene solo los servidores que le conceden sus paquetes; sin ningún paquete, no obtiene ningún servidor MCP
  • knowledge_bundles — Paquetes con nombre de fuentes de conocimiento (índices RAG, carpetas de documentación). Los agentes hacen referencia a un paquete para mostrar fragmentos relevantes en tiempo de inferencia
  • providers.tts: proveedores de texto a voz (OpenAI, ElevenLabs, Google, Edge, Piper). Configura uno por voz/idioma; los agentes los referencian mediante su alias
  • providers.transcription — Proveedores de conversión de voz a texto (OpenAI Whisper, Groq, Deepgram, AssemblyAI, Google, Whisper local). Configura uno por pipeline; los agentes los referencian mediante un alias
  • channels — Elige en qué plataformas de chat debe escuchar ZeroClaw. La configuración global de canales vive en [channels]; cada plataforma configurada sigue recibiendo su propio alias
  • hardware — Opcional: periféricos de hardware (Arduino, STM32, GPIO, etc.). Omítelo si no los necesitas
  • agents — Un agente vincula un proveedor de modelos, perfiles, paquetes y canales en una única unidad despachable. Añade uno por persona; reutiliza el mismo alias en todos los canales para compartir el estado
  • peer_groups — Grupos con nombre que vinculan un canal, agentes miembros y pares externos. Aceptación mutua: dos agentes se convierten en pares solo cuando ambos aparecen en la lista agents del mismo grupo
  • cron — Tareas programadas. Cada entrada de cron vincula una expresión de programación a un prompt, un canal y un destino
  • tunnel — Opcional: expón tu gateway en internet a través de Cloudflare o ngrok. Selecciona none para mantenerlo solo en localhost
  • onboard_state — Estado del ciclo de vida del Quickstart. quickstart_completed cambia a true una vez que el Quickstart finaliza una ejecución exitosa; mientras sea false, la puerta de enlace web y la TUI inician automáticamente el Quickstart al arrancar. completed_sections es un registro heredado por sección que se conserva por compatibilidad con datos anteriores

zeroclaw onboard providers.models

Elige un proveedor de modelos para configurar (Anthropic, OpenAI, OpenRouter, Ollama, gateways compatibles con OpenAI personalizados, etc.). Se admiten varios alias por proveedor; por ejemplo, anthropic.production y anthropic.dev pueden coexistir

Uso: zeroclaw onboard providers.models

zeroclaw onboard model_routes

Sugerencias de enrutamiento de modelo con nombre (p. ej., reasoning, fast, code). Cada ruta asigna una sugerencia a una combinación específica de proveedor + modelo. Use hint:<name> como parámetro del modelo para dirigir a través de una ruta

Uso: zeroclaw onboard model_routes

zeroclaw onboard embedding_routes

Sugerencias de enrutamiento de embeddings con nombre (p. ej., semantic, archive, faq). Cada ruta asigna una sugerencia a una combinación de proveedor + modelo compatible con embeddings. Usa hint:<name> como el parámetro embedding_model

Uso: zeroclaw onboard embedding_routes

zeroclaw onboard risk_profiles

Perfiles de riesgo con nombre que vinculan listas de permitidos, listas de denegados y umbrales de aprobación. Los agentes hacen referencia a uno mediante agents.<alias>.risk_profile

Uso: zeroclaw onboard risk_profiles

zeroclaw onboard runtime_profiles

Perfiles de ajuste de runtime con nombre (límites de tokens, política de reintentos, tiempos de espera). Los agentes hacen referencia a uno mediante agents.<alias>.runtime_profile

Uso: zeroclaw onboard runtime_profiles

zeroclaw onboard storage

SQLite es la opción predeterminada segura para instalaciones de un solo nodo (basada en archivos, sin configuración, sin servicios adicionales). Elija Postgres para implementaciones compartidas o de múltiples instancias, Qdrant para búsqueda vectorial, Markdown o Lucid para archivos legibles por humanos. Cada backend admite múltiples instancias con alias; los agentes hacen referencia a ellas mediante memory.storage_ref

Uso: zeroclaw onboard storage

zeroclaw onboard memory

Backend de memoria persistente. SQLite es el valor predeterminado; selecciona none para deshabilitar por completo la recuperación a largo plazo

Uso: zeroclaw onboard memory

zeroclaw onboard skills

Configuración de la herramienta Skills: dónde se almacena el markdown de skills en disco (por defecto en el directorio de datos) y cómo el cargador de skills gestiona los repositorios de la comunidad. Agrega los BUNDLES de skills en skill-bundles a continuación

Uso: zeroclaw onboard skills

zeroclaw onboard skill_bundles

Conjuntos con nombre de archivos de skills. Los agentes hacen referencia a un conjunto para cargar un grupo de capacidades al iniciar

Uso: zeroclaw onboard skill_bundles

zeroclaw onboard mcp

Configuración de Model Context Protocol. Activa enabled y elige carga diferida o anticipada. Los servidores MCP individuales se encuentran en mcp.servers[]

Uso: zeroclaw onboard mcp

zeroclaw onboard mcp.servers

Servidores individuales de Model Context Protocol. Cada entrada vincula un transporte (stdio, http, sse), el comando o URL para alcanzarlo, encabezados opcionales y un límite tool_timeout_secs (≤ 600). El name de cada servidor es su clave direccionable: renómbralo a través de la página de la sección en lugar de editar el campo directamente. Agrupa los servidores en paquetes bajo mcp_bundles a continuación

Uso: zeroclaw onboard mcp.servers

zeroclaw onboard mcp_bundles

Conjuntos con nombre de servidores MCP, concedidos a agentes que incluyan el conjunto en sus mcp_bundles. Seguro por defecto: un agente obtiene solo los servidores que sus conjuntos le conceden; sin ningún conjunto, no obtiene servidores MCP

Uso: zeroclaw onboard mcp_bundles

zeroclaw onboard knowledge_bundles

Paquetes con nombre de fuentes de conocimiento (índices RAG, carpetas de documentos). Los agentes hacen referencia a un paquete para mostrar fragmentos relevantes en el momento de la inferencia

Uso: zeroclaw onboard knowledge_bundles

zeroclaw onboard providers.tts

Proveedores de texto a voz (OpenAI, ElevenLabs, Google, Edge, Piper). Configura uno por voz / idioma; los agentes los referencian por alias

Uso: zeroclaw onboard providers.tts

zeroclaw onboard providers.transcription

Proveedores de voz a texto (OpenAI Whisper, Groq, Deepgram, AssemblyAI, Google, Whisper local). Configura uno por canalización; los agentes los referencian por alias

Uso: zeroclaw onboard providers.transcription

zeroclaw onboard channels

Elige en qué plataformas de chat debe escuchar ZeroClaw. La configuración global de canales vive en [channels]; cada plataforma configurada sigue teniendo su propio alias

Uso: zeroclaw onboard channels

zeroclaw onboard hardware

Opcional: periféricos de hardware (Arduino, STM32, GPIO, etc.). Omítelo si no los necesitas

Uso: zeroclaw onboard hardware

zeroclaw onboard agents

Un agent vincula un proveedor de modelos, perfiles, paquetes y canales en una única unidad despachable. Agrega uno por persona; reutiliza el mismo alias entre canales para compartir el estado

Uso: zeroclaw onboard agents

zeroclaw onboard peer_groups

Grupos con nombre que vinculan un canal, agentes miembros y peers externos. Adhesión mutua: dos agentes se convierten en peers solo cuando ambos aparecen en la lista agents del mismo grupo

Uso: zeroclaw onboard peer_groups

zeroclaw onboard cron

Tareas programadas. Cada entrada cron vincula una expresión de programación a un prompt, un canal y un destino

Uso: zeroclaw onboard cron

zeroclaw onboard tunnel

Opcional: expón tu gateway a través de internet pública mediante Cloudflare o ngrok. Selecciona none para mantenerlo solo en localhost

Uso: zeroclaw onboard tunnel

zeroclaw onboard onboard_state

Estado del ciclo de vida del Quickstart. quickstart_completed cambia a true una vez que el Quickstart finaliza una ejecución exitosa; mientras sea false, la puerta de enlace web y la TUI inician automáticamente el Quickstart al arrancar. completed_sections es un registro heredado por sección que se conserva por compatibilidad con versiones anteriores de los datos

Uso: zeroclaw onboard onboard_state

zeroclaw agent

Iniciar el bucle del agente de IA.

Inicia una sesión de chat interactiva con el model_provider de IA configurado. Usa --message para consultas de un solo envío sin entrar en el modo interactivo.

Ejemplos: zeroclaw agent -a assistant # sesión interactiva zeroclaw agent -a assistant -m “Summarize today’s logs” # mensaje único zeroclaw agent -a assistant -p anthropic –model claude-sonnet-4-20250514 zeroclaw agent -a assistant –peripheral nucleo-f401re:/dev/ttyACM0

Uso: zeroclaw agent [OPTIONS] --agent <AGENT>

Opciones:

  • -a, --agent <AGENT> — Alias del agente configurado con el que ejecutar (debe coincidir con [agents.<alias>]). Obligatorio — no hay agente predeterminado
  • -m, --message <MESSAGE> — Modo de mensaje único (no entrar en modo interactivo)
  • --session-state-file <SESSION_STATE_FILE> — Cargar y guardar el estado de la sesión interactiva en este archivo JSON
  • -p, --model-provider <MODEL_PROVIDER> — Proveedor de modelos a utilizar (openrouter, anthropic, openai, openai-codex)
  • --model <MODEL> — Modelo a utilizar
  • -t, --temperature <TEMPERATURE> — Temperatura (0.0 - 2.0, por defecto providers.models.<type>.<alias>.temperature)
  • --peripheral <PERIPHERAL> — Adjuntar un periférico (placa:ruta, por ejemplo, nucleo-f401re:/dev/ttyACM0)

zeroclaw gateway

Administra el servidor de puerta de enlace (webhooks, websockets).

Iniciar, reiniciar o inspeccionar la puerta de enlace HTTP/WebSocket que acepta eventos de webhook entrantes y conexiones WebSocket.

Ejemplos: zeroclaw gateway start # iniciar gateway zeroclaw gateway restart # reiniciar gateway zeroclaw gateway get-paircode # mostrar código de emparejamiento

Uso: zeroclaw gateway [COMANDO]

Subcomandos:

  • start — Inicia el servidor de puerta de enlace (predeterminado si no se especifica ningún subcomando)
  • restart — Reiniciar el servidor de puerta de enlace
  • get-paircode — Mostrar o generar el código de emparejamiento sin reiniciar

zeroclaw gateway start

Inicia el servidor de puerta de enlace (webhooks, websockets).

Ejecuta la puerta de enlace HTTP/WebSocket que acepta eventos de webhook entrantes y conexiones WebSocket. La dirección de enlace predeterminada corresponde a los valores definidos en tu archivo de configuración (gateway.host / gateway.port).

Ejemplos: zeroclaw gateway start # usar valores predeterminados de configuración zeroclaw gateway start -p 8080 # escuchar en el puerto 8080 zeroclaw gateway start –host 0.0.0.0 # requiere [gateway].allow_public_bind=true o un túnel zeroclaw gateway start -p 0 # puerto aleatorio disponible

Uso: zeroclaw gateway start [OPTIONS]

Opciones:

  • -p, --port <PORT> — Puerto en el que escuchar (usar 0 para un puerto aleatorio disponible); por defecto usa la configuración gateway.port
  • --host <HOST> — Host al que vincularse; por defecto usa gateway.host de la configuración. Nota: Vincularse a 0.0.0.0 requiere gateway.allow_public_bind = true en la configuración.
  • --allow-degraded-security — Arranca incluso cuando secciones de configuración críticas para la seguridad fueron restablecidas a sus valores predeterminados durante la carga (postura debilitada). Desactivado de forma predeterminada

zeroclaw gateway restart

Reinicia el servidor de puerta de enlace.

Detiene la puerta de enlace en ejecución, si está presente, y luego inicia una nueva instancia con la configuración actual.

Ejemplos: zeroclaw gateway restart # reiniciar con valores predeterminados de configuración zeroclaw gateway restart -p 8080 # reiniciar en el puerto 8080

Uso: zeroclaw gateway restart [OPTIONS]

Opciones:

  • -p, --port <PORT> — Puerto en el que escuchar (usar 0 para un puerto aleatorio disponible); por defecto usa la configuración gateway.port
  • --host <HOST> — Host al que vincularse; por defecto usa gateway.host de la configuración. Nota: Vincularse a 0.0.0.0 requiere gateway.allow_public_bind = true en la configuración.
  • --allow-degraded-security — Arranca incluso cuando secciones de configuración críticas para la seguridad fueron restablecidas a sus valores predeterminados durante la carga (postura debilitada). Desactivado de forma predeterminada

zeroclaw gateway get-paircode

Mostrar o generar el código de emparejamiento del gateway.

Muestra el código de emparejamiento para conectar nuevos clientes sin reiniciar la puerta de enlace. Requiere que la puerta de enlace esté en ejecución.

Con –new, genera un código de emparejamiento nuevo incluso si el gateway ya fue emparejado anteriormente (útil para agregar clientes adicionales). Esto NO revoca los tokens existentes.

Con –rotate, revoca TODOS los tokens bearer emparejados, borra el registro de dispositivos y emite un código nuevo. Use esto después de una sospecha de fuga de tokens cuando no sepa qué token fue comprometido; todos los clientes deben volver a emparejarse.

Con –rotate-device ID, revoca solo el token de portador de ese dispositivo y emite un código nuevo para volver a emparejar ese único dispositivo.

Ejemplos: zeroclaw gateway get-paircode # mostrar el código de emparejamiento actual zeroclaw gateway get-paircode –new # agregar otro cliente (sin revocación) zeroclaw gateway get-paircode –rotate # revocar TODOS los tokens, luego emitir un código zeroclaw gateway get-paircode –rotate-device dash-1 # revocar el token de un dispositivo zeroclaw gateway get-paircode –new –port 3001 # apuntar al gateway de puerto alternativo

Uso: zeroclaw gateway get-paircode [OPTIONS]

Opciones:

  • --new — Genera un nuevo código de emparejamiento para agregar un cliente (no revoca los tokens existentes)
  • --rotate — Revoca TODOS los tokens emparejados y borra el registro de dispositivos, luego emite un nuevo código
  • --rotate-device <DEVICE_ID> — Revoca el token de portador de un solo dispositivo por id, luego emite un nuevo código
  • -p, --port <PORT> — Puerto de la puerta de enlace en ejecución que se va a consultar; el valor predeterminado es config gateway.port
  • --host <HOST> — Host de la puerta de enlace en ejecución que se va a consultar; el valor predeterminado es config gateway.host

zeroclaw acp

Inicia el servidor ACP (JSON-RPC 2.0 sobre stdio).

Inicia un servidor JSON-RPC 2.0 en stdin/stdout para la integración con IDE y herramientas. Admite la gestión de sesiones y la transmisión de respuestas del agente como notificaciones.

Métodos: initialize, session/new, session/prompt, session/stop.

Ejemplos: zeroclaw acp # iniciar el servidor ACP zeroclaw acp –max-sessions 5 # limitar las sesiones concurrentes

Uso: zeroclaw acp [OPTIONS]

Opciones:

  • --max-sessions <MAX_SESSIONS> — Número máximo de sesiones simultáneas (predeterminado: 10)
  • --session-timeout <SESSION_TIMEOUT> — Tiempo de inactividad de la sesión en segundos (predeterminado: 3600)

zeroclaw daemon

Iniciar el demonio autónomo de ejecución prolongada.

Inicia el entorno de ejecución completo de ZeroClaw: servidor de puerta de enlace, todos los canales configurados (Telegram, Discord, Slack, etc.), monitor de latidos y programador de tareas programadas. Esta es la forma recomendada de ejecutar ZeroClaw en producción o como un asistente siempre activo.

Utiliza ‘zeroclaw service install’ para registrar el demonio como un servicio del sistema operativo (systemd/launchd) para que se inicie automáticamente al arrancar.

Ejemplos: zeroclaw daemon # usar valores predeterminados de configuración zeroclaw daemon -p 9090 # puerta de enlace en el puerto 9090 zeroclaw daemon –host 127.0.0.1 # solo localhost

Uso: zeroclaw daemon [OPTIONS]

Opciones:

  • -p, --port <PORT> — Puerto en el que escuchar (usar 0 para un puerto aleatorio disponible); por defecto usa la configuración gateway.port
  • --host <HOST> — Host al que vincularse; por defecto usa la configuración gateway.host
  • --ephemeral — Autoterminarse después de que todos los clientes de socket se desconecten (con período de gracia)
  • --allow-degraded-security — Arrancar incluso cuando las secciones de configuración críticas para la seguridad se restablecieron a sus valores predeterminados durante la carga. Sin esta opción, el daemon se niega a iniciar con una postura debilitada; con ella, el daemon arranca para que el operador pueda acceder a las superficies de reparación, emitiendo una advertencia repetitiva

zeroclaw service

Gestiona el ciclo de vida del servicio del sistema operativo (servicio de usuario de launchd/systemd)

Uso: zeroclaw service [OPTIONS] <COMANDO>

Subcomandos:

  • install — Instalar la unidad de servicio del daemon para el inicio automático y el reinicio
  • start — Iniciar el servicio de daemon
  • stop — Detener el servicio del daemon
  • restart — Reiniciar el servicio del daemon para aplicar la configuración más reciente
  • status — Comprobar el estado del servicio del daemon
  • uninstall — Desinstalar la unidad de servicio del daemon
  • logs — Muestra los registros del servicio daemon

Opciones:

  • --service-init <SERVICE_INIT> — Sistema de inicio a utilizar: auto (detectar), systemd o openrc

    Valor predeterminado: auto

    Valores posibles: auto, systemd, openrc

zeroclaw service install

Instalar la unidad de servicio del daemon para el inicio automático y el reinicio

Uso: zeroclaw service install

zeroclaw service start

Iniciar el servicio del daemon

Uso: zeroclaw service start

zeroclaw service stop

Detener el servicio del daemon

Uso: zeroclaw service stop

zeroclaw service restart

Reiniciar el servicio del daemon para aplicar la configuración más reciente

Uso: zeroclaw service restart

zeroclaw service status

Verificar el estado del servicio del daemon

Uso: zeroclaw service status

zeroclaw service uninstall

Desinstalar la unidad del servicio del daemon

Uso: zeroclaw service uninstall

zeroclaw service logs

Registro de servicios de daemon de cola

Uso: zeroclaw service logs [OPCIONES]

Opciones:

  • -n, --lines <LINES> — Número de líneas a mostrar (predeterminado: 50)

    Valor predeterminado: 50

  • -f, --follow — Seguir la salida del registro (como tail -f)

zeroclaw doctor

Ejecutar diagnósticos para la frescura del daemon/programador/canal

Uso: zeroclaw doctor [COMANDO]

Subcomandos:

  • models — Sondea los catálogos de modelos en model_providers e informa la disponibilidad
  • traces — Consultar eventos de seguimiento en tiempo de ejecución (diagnósticos de herramientas y respuestas del modelo)
  • update-context-windows — Actualiza context_window en config.toml desde los endpoints /models del proveedor

zeroclaw doctor models

Sondea catálogos de modelos en model_providers e informa la disponibilidad

Uso: zeroclaw doctor models [OPCIONES]

Opciones:

  • --model-provider <MODEL_PROVIDER> — Probar solo un model_provider específico (predeterminado: todos los model_providers conocidos)
  • --use-cache — Preferir catálogos en caché cuando estén disponibles (omitir la actualización forzada en vivo)

zeroclaw doctor traces

Consultar eventos de seguimiento en tiempo de ejecución (diagnósticos de herramientas y respuestas del modelo)

Uso: zeroclaw doctor traces [OPTIONS]

Opciones:

  • --id <ID> — Mostrar un evento de traza específico por id

  • --event <EVENT> — Filtra la salida de la lista por tipo de evento

  • --contains <CONTAINS> — Coincidencia de texto sin distinción de mayúsculas y minúsculas en el mensaje/payload

  • --limit <LIMIT> — Número máximo de eventos a mostrar

    Valor predeterminado: 20

zeroclaw doctor update-context-windows

Actualiza context_window en config.toml desde los endpoints /models del proveedor

Uso: zeroclaw doctor update-context-windows [OPTIONS]

Opciones:

  • --model-provider <MODEL_PROVIDER> — Actualizar solo un model_provider específico (predeterminado: todos los model_providers conocidos)
  • --dry-run — Muestra qué se actualizaría sin escribir en la configuración

zeroclaw status

Mostrar el estado del sistema (detalles completos)

Uso: zeroclaw status [OPTIONS]

Opciones:

  • --format <FORMAT> — Formato de salida: “exit-code” devuelve 0 si está saludable, 1 en caso contrario (para Docker HEALTHCHECK)

zeroclaw estop

Uso: zeroclaw estop [OPCIONES] [COMANDO]

Subcomandos:

  • status — Imprime el estado actual del estop
  • resume — Reanudar desde un nivel de estop activado

Opciones:

  • --level <LEVEL> — Nivel utilizado al activar el estop desde zeroclaw estop

    Valores posibles: kill-all, network-kill, domain-block, tool-freeze

  • --domain <DOMINIOS> — Patrón(es) de dominio para domain-block (repetible)

  • --tool <TOOLS> — Nombre(s) de la(s) herramienta(s) para tool-freeze (repetible)

zeroclaw estop status

Imprimir el estado actual del estop

Uso: zeroclaw estop status

zeroclaw estop resume

Reanudar desde un nivel de estop activado

Uso: zeroclaw estop resume [OPCIONES]

Opciones:

  • --network — Reanudar solo la interrupción de red
  • --domain <DOMINIOS> — Reanudar uno o más patrones de dominio bloqueados
  • --tool <TOOLS> — Reanudar una o más herramientas congeladas
  • --otp <OTP> — Código OTP. Si se omite y se requiere OTP, se mostrará un mensaje de solicitud.

zeroclaw cron

Configurar y gestionar tareas programadas.

Programe tareas recurrentes, de ejecución única o basadas en intervalos usando expresiones cron, marcas de tiempo RFC3339 con Z explícita o desfases horarios, duraciones o intervalos fijos.

Las expresiones cron usan el formato estándar de 5 campos: ‘min hour day month weekday’. Cuando se omite –tz, las programaciones cron usan la zona horaria local del entorno de ejecución. Para programaciones visibles para el usuario, pase –tz con una zona horaria IANA explícita.

Ejemplos: zeroclaw cron list zeroclaw cron add ‘0 9 * * 1-5’ ‘Good morning’ –agent sentinel –prompt –tz America/New_York zeroclaw cron add ‘*/30 * * * ’ ‘Check system health’ –agent sentinel –prompt zeroclaw cron add ‘/5 * * * *’ ‘echo ok’ –agent sentinel zeroclaw cron add-at 2099-01-15T14:00:00Z ‘Send reminder’ –agent sentinel –prompt zeroclaw cron add-every 60000 ‘Ping heartbeat’ –agent sentinel –prompt zeroclaw cron once 30m ‘Run backup in 30 minutes’ –agent sentinel –prompt zeroclaw cron pause TASK_ID zeroclaw cron update TASK_ID –expression ‘0 8 * * *’ –tz Europe/London

Uso: zeroclaw cron <COMANDO>

Subcomandos:

  • list — Listar todas las tareas programadas
  • add — Agregar una nueva tarea programada
  • add-at — Agrega una tarea programada de ejecución única en una marca de tiempo RFC3339 con Z u offset explícito
  • add-every — Agregar una tarea programada con un intervalo fijo
  • once — Agrega una tarea diferida de un solo disparo (por ejemplo, “30m”, “2h”, “1d”)
  • remove — Eliminar una tarea programada
  • update — Actualizar una tarea programada
  • pause — Pausar una tarea programada
  • resume — Reanudar una tarea en pausa

zeroclaw cron list

Listar todas las tareas programadas

Uso: zeroclaw cron list

zeroclaw cron add

Agrega una nueva tarea programada recurrente.

Usa la sintaxis estándar de cron de 5 campos: ‘min hour day month weekday’. Cuando se omite –tz, las programaciones de cron usan la zona horaria local del entorno de ejecución. Para programaciones visibles para el usuario, pase –tz con una zona horaria IANA explícita.

Ejemplos: zeroclaw cron add ‘0 9 * * 1-5’ ‘Buenos días’ –agent sentinel –prompt –tz America/New_York zeroclaw cron add ‘*/30 * * * ’ ‘Comprobar el estado del sistema’ –agent sentinel –prompt zeroclaw cron add ‘/5 * * * *’ ‘echo ok’ –agent sentinel

Uso: zeroclaw cron add [OPTIONS] --agent <AGENT_ALIAS> <EXPRESSION> <COMMAND>

Argumentos:

  • <EXPRESSION> — Expresión de cron
  • <COMMAND> — Comando (shell) o prompt (con –prompt) que se ejecutará

Opciones:

  • -a, --agent <AGENT_ALIAS> — Alias del agente configurado con el que se ejecuta la tarea cron. Obligatorio: no hay agente predeterminado

  • --tz <TZ> — Zona horaria IANA opcional (por ejemplo, America/Los_Angeles)

  • --prompt — Trata el argumento como un prompt de agente en lugar de un comando de shell

  • --allowed-tool <ALLOWED_TOOLS> — Restringe los trabajos cron del agente a los nombres de herramientas especificados (repetible, solo para prompt)

  • --uses-memory <USES_MEMORY> — Si es false, desactiva el recuerdo de memoria para este trabajo cron del agente (valor predeterminado: true). Establécelo en false para trabajos sin estado de resumen/informe que no deben acumular ni consumir memoria

    Valores posibles: true, false

  • --channel <DELIVERY_CHANNEL> — Anuncia el resultado del trabajo en este canal (p. ej., telegram, discord, slack)

  • --to <DELIVERY_TO> — ID del chat/destinatario de destino para el canal (p. ej., un ID de chat de Telegram).

    allow_hyphen_values es necesario porque los destinatarios compatibles comienzan por un guion: los ID de grupos y canales de Telegram son negativos (-100…), y el destino de un tema de foro es chat:thread (-100…:42), que comienza por un guion, pero no es un número. Sin esta opción, clap trata el valor como una opción y termina antes de que se ejecute cualquier validación de entrega, por lo que solo sigue funcionando la forma indocumentada --to=<value>.

    allow_negative_numbers no basta: acepta -100…, pero sigue rechazando la forma chat:thread. La configuración más amplia por sí sola permitiría que un valor olvidado absorbiera el indicador siguiente, por lo que parse_delivery_recipient rechaza los valores con prefijo --- y nombra el token problemático.

  • --thread <DELIVERY_THREAD> — ID opcional del hilo o la conversación, para canales que enrutan mediante este (webhook)

  • --no-best-effort — Hace que el trabajo falle si la entrega falla (valor predeterminado: los errores de entrega no son fatales)

  • --best-effort — Permite que la tarea se complete correctamente aunque falle la entrega. Restaura el comportamiento predeterminado tras un --no-best-effort anterior.

zeroclaw cron add-at

Agregue una tarea de ejecución única que se active en una marca de tiempo RFC3339 específica con Z u offset explícito.

La marca de tiempo debe incluir una Z explícita o un desplazamiento numérico (p. ej., 2099-01-15T14:00:00Z o 2099-01-15T09:00:00-05:00).

Examples: zeroclaw cron add-at –agent morning-shift –prompt 2099-01-15T14:00:00Z ‘Send reminder’ zeroclaw cron add-at –agent morning-shift –prompt 2099-12-31T23:59:00Z ‘Happy New Year!’

Uso: zeroclaw cron add-at [OPTIONS] --agent <AGENT_ALIAS> <AT> <COMMAND>

Argumentos:

  • <AT> — Marca de tiempo RFC3339 de ejecución única con Z u offset explícito
  • <COMMAND> — Comando (shell) o prompt (con –prompt) que se ejecutará

Opciones:

  • -a, --agent <AGENT_ALIAS> — Alias del agente configurado con el que se ejecuta el cron job

  • --prompt — Trata el argumento como un prompt de agente en lugar de un comando de shell

  • --allowed-tool <ALLOWED_TOOLS> — Restringe los trabajos cron del agente a los nombres de herramientas especificados (repetible, solo para prompt)

  • --uses-memory <USES_MEMORY> — Si es falso, deshabilita el recuerdo de memoria para este trabajo cron del agente (valor predeterminado: true)

    Valores posibles: true, false

  • --channel <DELIVERY_CHANNEL> — Anuncia el resultado del trabajo en este canal (p. ej., telegram, discord, slack)

  • --to <DELIVERY_TO> — ID del chat/destinatario de destino para el canal (p. ej., un ID de chat de Telegram).

    allow_hyphen_values es necesario porque los destinatarios compatibles comienzan por un guion: los ID de grupos y canales de Telegram son negativos (-100…), y el destino de un tema de foro es chat:thread (-100…:42), que comienza por un guion, pero no es un número. Sin esta opción, clap trata el valor como una opción y termina antes de que se ejecute cualquier validación de entrega, por lo que solo sigue funcionando la forma indocumentada --to=<value>.

    allow_negative_numbers no basta: acepta -100…, pero sigue rechazando la forma chat:thread. La configuración más amplia por sí sola permitiría que un valor olvidado absorbiera el indicador siguiente, por lo que parse_delivery_recipient rechaza los valores con prefijo --- y nombra el token problemático.

  • --thread <DELIVERY_THREAD> — ID opcional del hilo o la conversación, para canales que enrutan mediante este (webhook)

  • --no-best-effort — Hace que el trabajo falle si la entrega falla (valor predeterminado: los errores de entrega no son fatales)

  • --best-effort — Permite que la tarea se complete correctamente aunque falle la entrega. Restaura el comportamiento predeterminado tras un --no-best-effort anterior.

zeroclaw cron add-every

Agrega una tarea que se repita a intervalos fijos.

El intervalo se especifica en milisegundos. Por ejemplo, 60000 = 1 minuto.

Examples: zeroclaw cron add-every –agent triage –prompt 60000 ‘Ping heartbeat’ zeroclaw cron add-every –agent triage –prompt 3600000 ‘Hourly report’

Uso: zeroclaw cron add-every [OPTIONS] --agent <AGENT_ALIAS> <EVERY_MS> <COMMAND>

Argumentos:

  • <EVERY_MS> — Intervalo en milisegundos
  • <COMMAND> — Comando (shell) o prompt (con –prompt) que se ejecutará

Opciones:

  • -a, --agent <AGENT_ALIAS> — Alias del agente configurado con el que se ejecuta el cron job

  • --prompt — Trata el argumento como un prompt de agente en lugar de un comando de shell

  • --allowed-tool <ALLOWED_TOOLS> — Restringe los trabajos cron del agente a los nombres de herramientas especificados (repetible, solo para prompt)

  • --uses-memory <USES_MEMORY> — Si es falso, deshabilita el recuerdo de memoria para este trabajo cron del agente (valor predeterminado: true)

    Valores posibles: true, false

  • --channel <DELIVERY_CHANNEL> — Anuncia el resultado del trabajo en este canal (p. ej., telegram, discord, slack)

  • --to <DELIVERY_TO> — ID del chat/destinatario de destino para el canal (p. ej., un ID de chat de Telegram).

    allow_hyphen_values es necesario porque los destinatarios compatibles comienzan por un guion: los ID de grupos y canales de Telegram son negativos (-100…), y el destino de un tema de foro es chat:thread (-100…:42), que comienza por un guion, pero no es un número. Sin esta opción, clap trata el valor como una opción y termina antes de que se ejecute cualquier validación de entrega, por lo que solo sigue funcionando la forma indocumentada --to=<value>.

    allow_negative_numbers no basta: acepta -100…, pero sigue rechazando la forma chat:thread. La configuración más amplia por sí sola permitiría que un valor olvidado absorbiera el indicador siguiente, por lo que parse_delivery_recipient rechaza los valores con prefijo --- y nombra el token problemático.

  • --thread <DELIVERY_THREAD> — ID opcional del hilo o la conversación, para canales que enrutan mediante este (webhook)

  • --no-best-effort — Hace que el trabajo falle si la entrega falla (valor predeterminado: los errores de entrega no son fatales)

  • --best-effort — Permite que la tarea se complete correctamente aunque falle la entrega. Restaura el comportamiento predeterminado tras un --no-best-effort anterior.

zeroclaw cron once

Agrega una tarea de una sola ejecución que se active después de un retraso desde ahora.

Acepta duraciones legibles por humanos: s (segundos), m (minutos), h (horas), d (días).

Ejemplos: zeroclaw cron once –agent ops-bot –prompt 30m ‘Run backup in 30 minutes’ zeroclaw cron once –agent researcher –prompt 2h ‘Follow up on deployment’

Uso: zeroclaw cron once [OPTIONS] --agent <AGENT_ALIAS> <DELAY> <COMMAND>

Argumentos:

  • <DELAY> — Duración del retraso
  • <COMMAND> — Comando (shell) o prompt (con –prompt) que se ejecutará

Opciones:

  • -a, --agent <AGENT_ALIAS> — Alias del agente configurado con el que se ejecuta el cron job

  • --prompt — Trata el argumento como un prompt de agente en lugar de un comando de shell

  • --allowed-tool <ALLOWED_TOOLS> — Restringe los trabajos cron del agente a los nombres de herramientas especificados (repetible, solo para prompt)

  • --uses-memory <USES_MEMORY> — Si es falso, deshabilita el recuerdo de memoria para este trabajo cron del agente (valor predeterminado: true)

    Valores posibles: true, false

  • --channel <DELIVERY_CHANNEL> — Anuncia el resultado del trabajo en este canal (p. ej., telegram, discord, slack)

  • --to <DELIVERY_TO> — ID del chat/destinatario de destino para el canal (p. ej., un ID de chat de Telegram).

    allow_hyphen_values es necesario porque los destinatarios compatibles comienzan por un guion: los ID de grupos y canales de Telegram son negativos (-100…), y el destino de un tema de foro es chat:thread (-100…:42), que comienza por un guion, pero no es un número. Sin esta opción, clap trata el valor como una opción y termina antes de que se ejecute cualquier validación de entrega, por lo que solo sigue funcionando la forma indocumentada --to=<value>.

    allow_negative_numbers no basta: acepta -100…, pero sigue rechazando la forma chat:thread. La configuración más amplia por sí sola permitiría que un valor olvidado absorbiera el indicador siguiente, por lo que parse_delivery_recipient rechaza los valores con prefijo --- y nombra el token problemático.

  • --thread <DELIVERY_THREAD> — ID opcional del hilo o la conversación, para canales que enrutan mediante este (webhook)

  • --no-best-effort — Hace que el trabajo falle si la entrega falla (valor predeterminado: los errores de entrega no son fatales)

  • --best-effort — Permite que la tarea se complete correctamente aunque falle la entrega. Restaura el comportamiento predeterminado tras un --no-best-effort anterior.

zeroclaw cron remove

Eliminar una tarea programada

Uso: zeroclaw cron remove <ID>

Argumentos:

  • <ID> — ID de la tarea

zeroclaw cron update

Actualiza uno o más campos de una tarea programada existente.

Solo se modifican los campos que especificas; los demás permanecen sin cambios.

Ejemplos: zeroclaw cron update TASK_ID –expression ‘0 8 * * *’ zeroclaw cron update TASK_ID –tz Europe/London –name ‘Morning check’ zeroclaw cron update TASK_ID –command ‘Updated message’

Uso: zeroclaw cron update [OPTIONS] --agent <AGENT_ALIAS> <ID>

Argumentos:

  • <ID> — ID de la tarea

Opciones:

  • -a, --agent <AGENT_ALIAS> — Alias del agente configurado. Obligatorio. El perfil de riesgo del alias controla los comandos de shell para los trabajos de shell

  • --expression <EXPRESSION> — Nueva expresión cron

  • --tz <TZ> — Nueva zona horaria IANA

  • --command <COMMAND> — Nuevo comando de shell o nuevo prompt del agente cuando el trabajo es de agente

  • --name <NAME> — Nuevo nombre del trabajo

  • --allowed-tool <ALLOWED_TOOLS> — Reemplaza la lista permitida de herramientas del agente de trabajo con los nombres de herramientas especificados (repetible)

  • --uses-memory <USES_MEMORY> — Si es falso, deshabilita el recuerdo de memoria para este trabajo cron del agente (valor predeterminado: true)

    Valores posibles: true, false

  • --channel <DELIVERY_CHANNEL> — Anuncia el resultado del trabajo en este canal (p. ej., telegram, discord, slack)

  • --to <DELIVERY_TO> — ID del chat/destinatario de destino para el canal (p. ej., un ID de chat de Telegram).

    allow_hyphen_values es necesario porque los destinatarios compatibles comienzan por un guion: los ID de grupos y canales de Telegram son negativos (-100…), y el destino de un tema de foro es chat:thread (-100…:42), que comienza por un guion, pero no es un número. Sin esta opción, clap trata el valor como una opción y termina antes de que se ejecute cualquier validación de entrega, por lo que solo sigue funcionando la forma indocumentada --to=<value>.

    allow_negative_numbers no basta: acepta -100…, pero sigue rechazando la forma chat:thread. La configuración más amplia por sí sola permitiría que un valor olvidado absorbiera el indicador siguiente, por lo que parse_delivery_recipient rechaza los valores con prefijo --- y nombra el token problemático.

  • --thread <DELIVERY_THREAD> — ID opcional del hilo o la conversación, para canales que enrutan mediante este (webhook)

  • --no-best-effort — Hace que el trabajo falle si la entrega falla (valor predeterminado: los errores de entrega no son fatales)

  • --best-effort — Permite que la tarea se complete correctamente aunque falle la entrega. Restaura el comportamiento predeterminado tras un --no-best-effort anterior.

zeroclaw cron pause

Pausar una tarea programada

Uso: zeroclaw cron pause <ID>

Argumentos:

  • <ID> — ID de la tarea

zeroclaw cron resume

Reanudar una tarea en pausa

Uso: zeroclaw cron resume <ID>

Argumentos:

  • <ID> — ID de la tarea

zeroclaw models

Administrar catálogos de modelos de model_provider

Uso: zeroclaw models <COMANDO>

Subcomandos:

  • refresh — Actualiza y almacena en caché los modelos de model_provider
  • list — Lista los modelos configurados en config.toml
  • set — Establece el modelo predeterminado en la configuración
  • status — Mostrar la configuración actual del modelo y el estado de la caché

zeroclaw models refresh

Actualizar y almacenar en caché los modelos de model_provider

Uso: zeroclaw models refresh [OPTIONS]

Opciones:

  • --model-provider <MODEL_PROVIDER> — Nombre de ModelProvider (por defecto usa el model_provider predeterminado configurado)
  • --all — Actualiza todos los model_providers que admiten la detección de modelos en vivo
  • --force — Forzar la actualización en vivo e ignorar la caché reciente

zeroclaw models list

Listar los modelos configurados en config.toml

Uso: zeroclaw models list [OPTIONS]

Opciones:

  • --model-provider <MODEL_PROVIDER> — Nombre de ModelProvider (por defecto, todas las entradas configuradas)
  • --check — Verifica cada modelo configurado con el catálogo en vivo del proveedor

zeroclaw models set

Establece el modelo predeterminado en la configuración

Uso: zeroclaw models set <MODEL>

Argumentos:

  • <MODEL> — Nombre del modelo que se establecerá como predeterminado

zeroclaw models status

Mostrar la configuración actual del modelo y el estado de la caché

Uso: zeroclaw models status

zeroclaw providers

CRUD de alias para proveedores ([providers.<category>.<family>.<alias>]). category es uno de models, tts, transcription

Uso: zeroclaw providers [COMMAND]

Subcomandos:

  • list — Lista los alias de proveedores (opcionalmente filtrados por categoría)
  • create — Crear un nuevo alias de proveedor con la configuración predeterminada
  • rename — Renombrar un alias de proveedor, reescribiendo cada referencia
  • delete — Eliminar un alias de proveedor, depurando las referencias

zeroclaw providers list

Listar alias de proveedor (opcionalmente filtrados por categoría)

Uso: zeroclaw providers list [OPTIONS]

Opciones:

  • --category <CATEGORY> — Categoría: models | tts | transcription

zeroclaw providers create

Crear un nuevo alias de proveedor con la configuración predeterminada

Uso: zeroclaw providers create <CATEGORY> <FAMILY> <ALIAS>

Argumentos:

  • <CATEGORY> — Categoría: models | tts | transcription
  • <FAMILY> — Familia del proveedor (p. ej. anthropic, openai, elevenlabs)
  • <ALIAS> — Nuevo alias

zeroclaw providers rename

Renombrar un alias de proveedor, reescribiendo cada referencia

Uso: zeroclaw providers rename <CATEGORY> <FAMILY> <FROM> <TO>

Argumentos:

  • <CATEGORY>
  • <FAMILY>
  • <FROM>
  • <TO>

zeroclaw providers delete

Eliminar un alias de proveedor, depurando las referencias

Uso: zeroclaw providers delete [OPTIONS] <CATEGORY> <FAMILY> <ALIAS>

Argumentos:

  • <CATEGORY>
  • <FAMILY>
  • <ALIAS>

Opciones:

  • --dry-run
  • --yes

zeroclaw channel

Gestionar los canales de comunicación.

Agrega, elimina, lista, envía y realiza comprobaciones de estado en los canales que conectan ZeroClaw con plataformas de mensajería. Tipos de canales compatibles: telegram, discord, slack, whatsapp, matrix, imessage, email.

Examples: zeroclaw channel list zeroclaw channel doctor zeroclaw channel add telegram ‘{“bot_token”:“…”,“name”:“my-bot”}’ zeroclaw channel remove my-bot zeroclaw channel bind-telegram zeroclaw_user zeroclaw channel send ‘Alert!’ –channel-id telegram –recipient 123456789

Uso: zeroclaw channel <COMANDO>

Subcomandos:

  • list — Lista todos los canales configurados
  • start — Iniciar todos los canales configurados (manejado en main.rs para async)
  • doctor — Ejecuta comprobaciones de salud para los canales configurados (gestionado en main.rs para async)
  • add — Agrega una nueva configuración de canal
  • remove — Eliminar la configuración de un canal
  • bind-telegram — Vincula una identidad de Telegram (nombre de usuario o ID numérico de usuario) a la lista de permitidos
  • send — Enviar un mensaje a un canal configurado

zeroclaw channel list

Lista todos los canales configurados

Uso: zeroclaw channel list

zeroclaw channel start

Inicia todos los canales configurados (manejados en main.rs para async)

Uso: zeroclaw channel start

zeroclaw channel doctor

Ejecutar comprobaciones de estado para los canales configurados (gestionado en main.rs para async)

Uso: zeroclaw channel doctor

zeroclaw channel add

Agregar una nueva configuración de canal.

Proporciona el tipo de canal y un objeto JSON con las claves de configuración requeridas para ese tipo de canal.

Tipos compatibles: telegram, discord, slack, whatsapp, matrix, imessage, email.

Ejemplos: zeroclaw channel add telegram ‘{“bot_token”:“…”,“name”:“my-bot”}’ zeroclaw channel add discord ‘{“bot_token”:“…”,“name”:“my-discord”}’

Uso: zeroclaw channel add <TIPO_CANAL> <CONFIG>

Argumentos:

  • <CHANNEL_TYPE> — Tipo de canal (telegram, discord, slack, whatsapp, matrix, imessage, email)
  • <CONFIG> — Configuración opcional en formato JSON

zeroclaw channel remove

Eliminar una configuración de canal

Uso: zeroclaw channel remove <NAME>

Argumentos:

  • <NAME> — Nombre del canal a eliminar

zeroclaw channel bind-telegram

Vincula una identidad de Telegram en la lista de permitidos.

Agrega un nombre de usuario de Telegram (sin el prefijo ‘@’) o un ID numérico de usuario a la lista permitida del canal para que el agente responda a los mensajes de esa identidad.

Usa –alias para apuntar a un canal de Telegram no predeterminado — debe coincidir con el alias en la sección channels.telegram.<alias> que usa el agente. Sin él, la identidad queda vinculada al alias default y un agente no predeterminado seguirá solicitando aprobación.

Ejemplos: zeroclaw channel bind-telegram zeroclaw_user zeroclaw channel bind-telegram 123456789 zeroclaw channel bind-telegram 123456789 –alias alerts

Uso: zeroclaw channel bind-telegram [OPTIONS] <IDENTITY>

Argumentos:

  • <IDENTITY> — Identidad de Telegram para permitir (nombre de usuario sin ‘@’ o ID numérico de usuario)

Opciones:

  • --alias <ALIAS> — Alias del canal Telegram al que vincular (el <alias> en channels.telegram.<alias>). Por defecto es default

    Valor predeterminado: default

zeroclaw channel send

Enviar un mensaje único a un canal configurado.

Envía un mensaje de texto a través del canal especificado sin iniciar el bucle completo del agente. Útil para notificaciones programadas, alertas de sensores de hardware y pipelines de automatización.

La opción --channel-id selecciona el canal por su nombre de sección de configuración (por ejemplo, ‘telegram’, ‘discord’, ‘slack’). La opción --recipient es el destino específico de la plataforma (por ejemplo, un ID de chat de Telegram).

Ejemplos: zeroclaw channel send ‘Alguien está cerca de tu dispositivo.’ –channel-id telegram –recipient 123456789 zeroclaw channel send ‘¡Compilación exitosa!’ –channel-id discord –recipient 987654321

Uso: zeroclaw channel send --channel-id <CHANNEL_ID> --recipient <RECIPIENT> <MESSAGE>

Argumentos:

  • <MESSAGE> — Texto del mensaje a enviar

Opciones:

  • --channel-id <CHANNEL_ID> — Nombre de la configuración del canal (por ejemplo, telegram, discord, slack)
  • --recipient <RECIPIENT> — Identificador del destinatario (específico de la plataforma, por ejemplo, ID de chat de Telegram)

zeroclaw agents

Gestionar alias de agentes (crear/listar/renombrar/eliminar). Distinto de agent, que ejecuta un agente

Uso: zeroclaw agents <COMMAND>

Subcomandos:

  • list — Listar los alias de agente configurados
  • create — Crear un nuevo alias de agente con la configuración predeterminada
  • rename — Renombrar un alias de agente, reescribiendo todas las referencias a él
  • delete — Elimina un alias de agente, depurando referencias y propagando en cascada el estado asociado

zeroclaw agents list

Listar alias de agente configurados

Uso: zeroclaw agents list

zeroclaw agents create

Crear un nuevo alias de agente con la configuración predeterminada

Uso: zeroclaw agents create <ALIAS>

Argumentos:

  • <ALIAS> — Nuevo alias del agente (alfanumérico en minúsculas + guion bajo simple)

zeroclaw agents rename

Renombrar un alias de agente, reescribiendo todas las referencias a él

Uso: zeroclaw agents rename <FROM> <TO>

Argumentos:

  • <FROM> — Alias actual
  • <TO> — Nuevo alias

zeroclaw agents delete

Eliminar un alias de agente, depurando las referencias y propagando en cascada el estado asociado

Uso: zeroclaw agents delete [OPTIONS] <ALIAS>

Argumentos:

  • <ALIAS> — Alias a eliminar

Opciones:

  • --dry-run — Muestra el impacto (referencias que se eliminarían) sin borrar
  • --yes — Omitir el mensaje de confirmación

zeroclaw channels

Gestionar alias de canales (crear/listar/renombrar/eliminar)

Uso: zeroclaw channels <COMMAND>

Subcomandos:

  • list — Listar alias de canales (opcionalmente filtrados por tipo)
  • create — Crea un nuevo alias de canal con la configuración predeterminada
  • rename — Renombra un alias de canal, reescribiendo todas las referencias
  • delete — Eliminar un alias de canal, depurando las referencias

zeroclaw channels list

Listar alias de canales (opcionalmente filtrados por tipo)

Uso: zeroclaw channels list [OPTIONS]

Opciones:

  • --channel-type <CHANNEL_TYPE> — Tipo de canal, p. ej. discord, telegram

zeroclaw channels create

Crear un nuevo alias de canal con la configuración predeterminada

Uso: zeroclaw channels create <CHANNEL_TYPE> <ALIAS>

Argumentos:

  • <CHANNEL_TYPE> — Tipo de canal (discord, telegram, slack, …)
  • <ALIAS> — Nuevo alias

zeroclaw channels rename

Renombrar un alias de canal, reescribiendo todas las referencias

Uso: zeroclaw channels rename <CHANNEL_TYPE> <FROM> <TO>

Argumentos:

  • <CHANNEL_TYPE>
  • <FROM>
  • <TO>

zeroclaw channels delete

Eliminar un alias de canal, depurando las referencias

Uso: zeroclaw channels delete [OPTIONS] <CHANNEL_TYPE> <ALIAS>

Argumentos:

  • <CHANNEL_TYPE>
  • <ALIAS>

Opciones:

  • --dry-run
  • --yes

zeroclaw integrations

Explora más de 50 integraciones

Uso: zeroclaw integrations <COMANDO>

Subcomandos:

  • info — Mostrar detalles sobre una integración específica

zeroclaw integrations info

Mostrar detalles sobre una integración específica

Uso: zeroclaw integrations info <NAME>

Argumentos:

  • <NAME> — Nombre de la integración

zeroclaw skills

Gestionar habilidades (capacidades definidas por el usuario)

Uso: zeroclaw skills <COMANDO>

Subcomandos:

  • list — Lista todas las habilidades instaladas
  • add — Genera la estructura de una nueva skill desde cero (SKILL.md canónico + subdirectorios opcionales)
  • edit — Abre el SKILL.md de una skill (o un archivo del mismo directorio) en $EDITOR
  • bundle — Gestionar paquetes de skills (los directorios con nombre donde residen las skills)
  • audit — Audita un directorio de origen de habilidad o un nombre de habilidad instalado
  • install — Instalar una nueva habilidad desde una URL o ruta local
  • remove — Eliminar una habilidad instalada
  • test — Ejecuta la validación de TEST.sh para una habilidad (o todas las habilidades)

zeroclaw skills list

Lista todas las habilidades instaladas

Uso: zeroclaw skills list [OPTIONS]

Opciones:

  • --agent <AGENT> — Muestra exactamente lo que este agente carga en tiempo de ejecución (su espacio de trabajo + open-skills + plugins + bundles asignados). –bundle tiene prioridad cuando se pasan ambos
  • --bundle <BUNDLE> — Restringe a un solo bundle. Omitir para listar en todos los bundles

zeroclaw skills add

Genera la estructura de una nueva skill dentro de un bundle de skills. Escribe <bundle.directory>/<name>/SKILL.md además de los subdirectorios opcionales canónicos (scripts/, references/, assets/). El nombre debe estar en minúsculas + guiones; la descripción es obligatoria (se solicita en TTY si se omite).

Ejemplos: zeroclaw skills add code-review –bundle official –description “Review PRs.” zeroclaw skills add ops-runbook –description “Triage prod incidents.” –edit

Uso: zeroclaw skills add [OPTIONS] <NAME>

Argumentos:

  • <NAME> — Nombre de la skill (solo minúsculas y guiones)

Opciones:

  • --bundle <BUNDLE> — Alias del paquete de destino. Opcional cuando hay exactamente un paquete configurado
  • --description <DESCRIPTION> — Qué hace la skill y cuándo usarla (frontmatter description). Obligatorio; se solicita en TTY cuando falta
  • --license <LICENSE> — Identificador de licencia SPDX (p. ej. MIT)
  • --author <AUTHOR> — Identificador del autor de la skill
  • --version <VERSION> — versión SemVer (predeterminada: 0.1.0)
  • --category <CATEGORY> — Categoría de la skill para la agrupación en el registro
  • --no-scaffold — Omitir la creación de la estructura scripts/, references/, assets/
  • --edit — Abrir SKILL.md en $EDITOR después del scaffold

zeroclaw skills edit

Abre el archivo SKILL.md de una skill (o un archivo similar) en $EDITOR

Uso: zeroclaw skills edit [OPTIONS] <NAME>

Argumentos:

  • <NAME> — Nombre de la skill

Opciones:

  • --bundle <BUNDLE> — Alias del bundle de destino. Opcional cuando el nombre es único en todos los bundles
  • --file <FILE> — Edita un archivo del mismo nivel en lugar de SKILL.md (p. ej. scripts/runner.sh)

zeroclaw skills bundle

Gestionar paquetes de skills (los directorios con nombre donde residen las skills)

Uso: zeroclaw skills bundle <COMMAND>

Subcomandos:

  • list — Lista los paquetes de skills configurados y sus directorios resueltos
  • add — Agrega un nuevo paquete de habilidades. El directorio predeterminado es shared/skills/<alias>/
  • remove — Elimina un paquete de habilidades configurado (archiva su directorio y lo quita de la lista skill_bundles de cada agente)
  • rename — Renombra un paquete de skills (mueve su directorio + reescribe las referencias del agente)
  • show — Mostrar metadatos y lista de skills de un bundle

zeroclaw skills bundle list

Lista los paquetes de skills configurados y sus directorios resueltos

Uso: zeroclaw skills bundle list

zeroclaw skills bundle add

Agrega un nuevo paquete de habilidades. El directorio predeterminado es shared/skills/<alias>/

Uso: zeroclaw skills bundle add [OPTIONS] <ALIAS>

Argumentos:

  • <ALIAS> — Alias del bundle (minúsculas + guiones; misma convención que agents/channels)

Opciones:

  • --directory <DIRECTORY> — Sobrescribe el directorio (relativo a la raíz de instalación o absoluto). Debe resolverse dentro de <install>/shared/

zeroclaw skills bundle remove

Elimina un paquete de habilidades configurado (archiva su directorio y lo quita de la lista skill_bundles de cada agente)

Uso: zeroclaw skills bundle remove [OPTIONS] <ALIAS>

Argumentos:

  • <ALIAS> — Alias del bundle

Opciones:

  • --yes — Omitir el mensaje de confirmación

zeroclaw skills bundle rename

Renombra un paquete de skill (mueve su directorio + reescribe las referencias de agente)

Uso: zeroclaw skills bundle rename <FROM> <TO>

Argumentos:

  • <FROM> — Alias actual
  • <TO> — Nuevo alias

zeroclaw skills bundle show

Mostrar metadatos + lista de skills para un paquete

Uso: zeroclaw skills bundle show <ALIAS>

Argumentos:

  • <ALIAS> — Alias del bundle

zeroclaw skills audit

Auditar un directorio de origen de habilidades o un nombre de habilidad instalado

Uso: zeroclaw skills audit <SOURCE>

Argumentos:

  • <SOURCE> — Ruta de habilidades o nombre de la habilidad instalada

zeroclaw skills install

Instalar una nueva habilidad desde una URL o ruta local

Uso: zeroclaw skills install [OPTIONS] <SOURCE>

Argumentos:

  • <SOURCE> — URL de origen o ruta local

Opciones:

  • --agent <AGENT> — Instalar en el paquete asignado a este agente (por defecto, el agente activo). Cuando el agente no tiene paquete, recurre al directorio global
  • --bundle <BUNDLE> — Instalar en este bundle directamente. Tiene prioridad sobre –agent
  • --no-tier-banner — Suprime solo el banner de nivel durante la instalación; el resto de la salida del progreso de instalación (resolución, instalación, auditoría) no se ve afectado
  • --skill <SKILL> — Instala una única skill con nombre desde un repositorio de catálogo git (su directorio skills/<name>/)

zeroclaw skills remove

Eliminar una habilidad instalada

Uso: zeroclaw skills remove [OPTIONS] <NAME>

Argumentos:

  • <NAME> — Nombre de la habilidad a eliminar

Opciones:

  • --agent <AGENT> — Limita la búsqueda a los bundles asignados a este agente
  • --bundle <BUNDLE> — Eliminar de este bundle directamente (desambigua duplicados)

zeroclaw skills test

Ejecuta la validación de TEST.sh para una habilidad (o todas las habilidades)

Uso: zeroclaw skills test [OPTIONS] [NAME]

Argumentos:

  • <NAME> — Nombre de la habilidad a probar; omítelo para todas las habilidades

Opciones:

  • --verbose — Mostrar salida detallada

zeroclaw browse

Lista los elementos secundarios de un directorio bajo <install>/shared/. Las rutas son relativas a la raíz del espacio de trabajo compartido; se rechaza el recorrido con .. que escape de la raíz. Lo utilizan el selector de directorios de paquetes de habilidades del panel de control y los operadores que desean inspeccionar lo que está instalado.

Ejemplos: zeroclaw browse # listar la raíz shared/ zeroclaw browse skills # listar shared/skills/ zeroclaw browse skills/coding # listar shared/skills/coding/

Uso: zeroclaw browse [PATH]

Argumentos:

  • <PATH> — Ruta relativa a <install>/shared/. Vacío = raíz

    Valor predeterminado: ``

zeroclaw sop

Gestionar procedimientos operativos estándar (SOP)

Uso: zeroclaw sop <COMANDO>

Subcomandos:

  • list — Listar SOPs cargados
  • validate — Validar definiciones de SOP
  • show — Mostrar detalles de un SOP
  • approve — Aprobar una ejecución de SOP que espera aprobación fuera de banda (habla con el daemon en ejecución)
  • deny — Denegar (cancelar) una ejecución de SOP en espera de aprobación (se comunica con el daemon en ejecución)
  • pending — Lista las ejecuciones de SOP que están actualmente esperando aprobación (se comunica con el daemon en ejecución)
  • graph — Renderiza el grafo de nodos de un SOP como texto
  • delete — Eliminar una definición de SOP del disco

zeroclaw sop list

Listar SOPs cargados

Uso: zeroclaw sop list

zeroclaw sop validate

Validar definiciones de SOP

Uso: zeroclaw sop validate [NAME]

Argumentos:

  • <NAME> — Nombre de SOP a validar (todos si se omite)

zeroclaw sop show

Mostrar detalles de un SOP

Uso: zeroclaw sop show <NAME>

Argumentos:

  • <NAME> — Nombre del SOP a mostrar

zeroclaw sop approve

Aprueba una ejecución de SOP en espera de aprobación fuera de banda (se comunica con el daemon en ejecución)

Uso: zeroclaw sop approve <RUN_ID>

Argumentos:

  • <RUN_ID> — El ID de ejecución para aprobar

zeroclaw sop deny

Denegar (cancelar) una ejecución de SOP en espera de aprobación (se comunica con el daemon en ejecución)

Uso: zeroclaw sop deny <RUN_ID> [REASON]

Argumentos:

  • <RUN_ID> — El ID de ejecución que denegar
  • <REASON> — Motivo opcional registrado en el libro mayor de aprobación

zeroclaw sop pending

Lista las ejecuciones de SOP que están esperando aprobación actualmente (se comunica con el daemon en ejecución)

Uso: zeroclaw sop pending

zeroclaw sop graph

Representa el grafo de nodos de un SOP como texto

Uso: zeroclaw sop graph [OPTIONS] <NAME>

Argumentos:

  • <NAME> — Nombre del SOP a renderizar

Opciones:

  • --format <FORMAT> — Formato de salida

    Valor predeterminado: outline

    Valores posibles:

    • outline: Una línea por nodo con sus aristas de flujo salientes
    • adjacency: adyacencia from -> to [role], una arista por línea
    • json: JSON con formato bonito de toda la proyección

zeroclaw sop delete

Elimina una definición de SOP del disco

Uso: zeroclaw sop delete <NAME>

Argumentos:

  • <NAME> — Nombre del SOP que se va a eliminar

zeroclaw migrate

Migrar datos desde otros entornos de ejecución de agentes

Uso: zeroclaw migrate <COMANDO>

Subcomandos:

  • openclaw — Importa la memoria desde un espacio de trabajo de OpenClaw a este espacio de trabajo de ZeroClaw

zeroclaw migrate openclaw

Importar memoria desde un espacio de trabajo de OpenClaw a este espacio de trabajo de ZeroClaw

Uso: zeroclaw migrate openclaw [OPTIONS]

Opciones:

  • --source <SOURCE> — Ruta opcional al espacio de trabajo de OpenClaw (por defecto, ~/.openclaw/workspace)
  • --dry-run — Validar y previsualizar la migración sin escribir ningún dato
  • --reindex — Reconstruir los índices del backend después de importar entradas

zeroclaw auth

Administrar perfiles de autenticación de suscripción de model_provider

Uso: zeroclaw auth <COMANDO>

Subcomandos:

  • login — Iniciar sesión con OAuth (OpenAI Codex, Gemini o xAI)
  • paste-redirect — Complea el OAuth pegando la URL de redirección o el código de autenticación
  • paste-token — Pegar el token de configuración / token de autenticación (para la autenticación de suscripción de Anthropic)
  • setup-token — Alias de paste-token (interactivo por defecto)
  • refresh — Renovar el token de acceso OAuth usando el token de actualización
  • logout — Eliminar el perfil de autenticación
  • use — Establece el perfil activo para un model_provider
  • list — Listar perfiles de autenticación
  • status — Muestra el estado de autenticación con el perfil activo y la información de expiración del token
  • email-login — Autentica un canal de correo electrónico mediante el flujo de código de dispositivo OAuth2

zeroclaw auth login

Inicia sesión con OAuth (OpenAI Codex, Gemini o xAI)

Uso: zeroclaw auth login [OPTIONS] --model-provider <MODEL_PROVIDER>

Opciones:

  • --model-provider <MODEL_PROVIDER> — ModelProvider (openai-codex, gemini, or xai)

  • --profile <PERFIL> — Nombre del perfil (predeterminado: default)

    Valor predeterminado: default

  • --device-code — Utilizar el flujo de código de dispositivo OAuth

  • --import <PATH> — Importar un archivo auth.json existente en lugar de iniciar un nuevo flujo de inicio de sesión. Compatible con openai-codex (~/.codex/auth.json) y xai (~/.grok/auth.json)

zeroclaw auth paste-redirect

Completa OAuth pegando la URL de redirección o el código de autenticación

Uso: zeroclaw auth paste-redirect [OPTIONS] --model-provider <MODEL_PROVIDER>

Opciones:

  • --model-provider <MODEL_PROVIDER> — ModelProvider (openai-codex, gemini, or xai)

  • --profile <PERFIL> — Nombre del perfil (predeterminado: default)

    Valor predeterminado: default

  • --input <INPUT> — URL de redirección completa o código OAuth sin procesar

zeroclaw auth paste-token

Pega el token de configuración / token de autenticación (para la autenticación de suscripción de Anthropic)

Uso: zeroclaw auth paste-token [OPTIONS] --model-provider <MODEL_PROVIDER>

Opciones:

  • --model-provider <MODEL_PROVIDER> — ModelProvider (anthropic)

  • --profile <PERFIL> — Nombre del perfil (predeterminado: default)

    Valor predeterminado: default

  • --token <TOKEN> — Valor del token (si se omite, se leerá de forma interactiva)

  • --auth-kind <AUTH_KIND> — Anulación del tipo de autenticación (authorization o api-key)

zeroclaw auth setup-token

Alias para paste-token (interactivo por defecto)

Uso: zeroclaw auth setup-token [OPTIONS] --model-provider <MODEL_PROVIDER>

Opciones:

  • --model-provider <MODEL_PROVIDER> — ModelProvider (anthropic)

  • --profile <PERFIL> — Nombre del perfil (predeterminado: default)

    Valor predeterminado: default

zeroclaw auth refresh

Actualizar el token de acceso de OAuth usando el token de actualización

Uso: zeroclaw auth refresh [OPTIONS] --model-provider <MODEL_PROVIDER>

Opciones:

  • --model-provider <MODEL_PROVIDER> — ModelProvider (openai-codex, gemini, or xai)
  • --profile <PERFIL> — Nombre o identificador del perfil

zeroclaw auth logout

Eliminar perfil de autenticación

Uso: zeroclaw auth logout [OPTIONS] --model-provider <MODEL_PROVIDER>

Opciones:

  • --model-provider <MODEL_PROVIDER> — ModelProvider

  • --profile <PERFIL> — Nombre del perfil (predeterminado: default)

    Valor predeterminado: default

zeroclaw auth use

Establecer el perfil activo para un model_provider

Uso: zeroclaw auth use --model-provider <MODEL_PROVIDER> --profile <PROFILE>

Opciones:

  • --model-provider <MODEL_PROVIDER> — ModelProvider
  • --profile <PERFIL> — Nombre del perfil o identificador completo del perfil

zeroclaw auth list

Listar perfiles de autenticación

Uso: zeroclaw auth list

zeroclaw auth status

Mostrar el estado de autenticación con el perfil activo y la información de expiración del token

Uso: zeroclaw auth status

zeroclaw auth email-login

Autentica un canal de correo electrónico mediante el flujo de código de dispositivo OAuth2

Uso: zeroclaw auth email-login [OPTIONS] --channel <CHANNEL>

Opciones:

  • --channel <CHANNEL> — Alias de canal de correo electrónico de [channels.email.<alias>] (p. ej. ‘hotmail’)

  • --profile <PERFIL> — Nombre del perfil (predeterminado: default)

    Valor predeterminado: default

zeroclaw hardware

Descubre e inspecciona el hardware USB.

Enumera los dispositivos USB conectados, identifica las placas de desarrollo conocidas (STM32 Nucleo, Arduino, ESP32) y obtén información del chip a través de probe-rs / ST-Link.

Ejemplos: zeroclaw hardware discover zeroclaw hardware introspect /dev/ttyACM0 zeroclaw hardware info –chip STM32F401RETx

Uso: zeroclaw hardware <COMANDO>

Subcomandos:

  • discover — Enumerar dispositivos USB (VID/PID) y mostrar las placas conocidas
  • introspect — Introspeccionar un dispositivo por ruta (por ejemplo, /dev/ttyACM0)
  • info — Obtener información del chip a través de USB (probe-rs sobre ST-Link). No se necesita firmware en el objetivo

zeroclaw hardware discover

Enumera los dispositivos USB y muestra las placas conocidas.

Escanea los dispositivos USB conectados por VID/PID y los compara con las placas de desarrollo conocidas (STM32 Nucleo, Arduino, ESP32).

Examples: zeroclaw hardware discover

Uso: zeroclaw hardware discover

zeroclaw hardware introspect

Inspeccionar un dispositivo por su número de serie o ruta del dispositivo.

Abre la ruta del dispositivo especificada y consulta la información de la placa, la versión del firmware y las capacidades compatibles.

Ejemplos: zeroclaw hardware introspect /dev/ttyACM0 zeroclaw hardware introspect COM3

Uso: zeroclaw hardware introspect <PATH>

Argumentos:

  • <PATH> — Ruta serie o ruta del dispositivo

zeroclaw hardware info

Obtener información del chip a través de USB utilizando probe-rs con ST-Link.

Consulta directamente el MCU objetivo a través de la sonda de depuración sin requerir ningún firmware en la placa objetivo.

Ejemplos: zeroclaw hardware info zeroclaw hardware info –chip STM32F401RETx

Uso: zeroclaw hardware info [OPCIONES]

Opciones:

  • --chip <CHIP> — Nombre del chip (por ejemplo, STM32F401RETx). Predeterminado: STM32F401RETx para Nucleo-F401RE

    Valor predeterminado: STM32F401RETx

zeroclaw peripheral

Gestionar periféricos de hardware.

Agrega, lista, muestra y configura placas de hardware que exponen herramientas al agente (GPIO, sensores, actuadores). Placas compatibles: nucleo-f401re, rpi-gpio, esp32, arduino-uno.

Ejemplos: zeroclaw peripheral list zeroclaw peripheral add nucleo-f401re /dev/ttyACM0 zeroclaw peripheral add rpi-gpio native zeroclaw peripheral flash –port /dev/cu.usbmodem12345 zeroclaw peripheral flash-nucleo

Uso: zeroclaw peripheral <COMANDO>

Subcomandos:

  • list — Lista los periféricos configurados
  • add — Agrega un periférico (ruta de la placa, por ejemplo, nucleo-f401re /dev/ttyACM0)
  • flash — Flash ZeroClaw firmware to Arduino (creates .ino, installs arduino-cli if needed, uploads)
  • setup-uno-q — Configurar la aplicación de puente de Arduino Uno Q (implementar el puente GPIO para el control del agente)
  • flash-nucleo — Flash ZeroClaw firmware to Nucleo-F401RE (builds + probe-rs run)

zeroclaw peripheral list

Lista de periféricos configurados

Uso: zeroclaw peripheral list

zeroclaw peripheral add

Agrega un periférico por tipo de placa y ruta de transporte.

Registra una placa de hardware para que el agente pueda utilizar sus herramientas (GPIO, sensores, actuadores). Utiliza ‘native’ como ruta para el GPIO local en computadoras de placa única como Raspberry Pi.

Placas compatibles: nucleo-f401re, rpi-gpio, esp32, arduino-uno.

Ejemplos: zeroclaw peripheral add nucleo-f401re /dev/ttyACM0 zeroclaw peripheral add rpi-gpio native zeroclaw peripheral add esp32 /dev/ttyUSB0

Uso: zeroclaw peripheral add <BOARD> <PATH>

Argumentos:

  • <BOARD> — Tipo de placa (nucleo-f401re, rpi-gpio, esp32)
  • <PATH> — Ruta para el transporte serial (/dev/ttyACM0) o “native” para GPIO local

zeroclaw peripheral flash

Flash ZeroClaw firmware to an Arduino board.

Genera el archivo .ino, instala arduino-cli si no está disponible, compila y carga el firmware.

Ejemplos: zeroclaw peripheral flash zeroclaw peripheral flash –port /dev/cu.usbmodem12345 zeroclaw peripheral flash -p COM3

Uso: zeroclaw peripheral flash [OPCIONES]

Opciones:

  • -p, --port <PORT> — Puerto serie (por ejemplo, /dev/cu.usbmodem12345). Si se omite, utiliza el primer arduino-uno de la configuración.

zeroclaw peripheral setup-uno-q

Configurar la aplicación Arduino Uno Q Bridge (implementar el puente GPIO para el control del agente)

Uso: zeroclaw peripheral setup-uno-q [OPCIONES]

Opciones:

  • --host <HOST> — IP de Uno Q (por ejemplo, 192.168.0.48). Si se omite, asume que se está ejecutando EN el Uno Q

zeroclaw peripheral flash-nucleo

Flash ZeroClaw firmware to Nucleo-F401RE (builds + probe-rs run)

Uso: zeroclaw peripheral flash-nucleo

zeroclaw memory

Gestionar las entradas de memoria del agente.

Listar, inspeccionar y limpiar las entradas de memoria almacenadas por el agente. Admite filtrado por categoría y sesión, paginación y borrado por lotes con confirmación.

Ejemplos: zeroclaw memory stats zeroclaw memory list zeroclaw memory list –category core –limit 10 zeroclaw memory get KEY zeroclaw memory clear –category conversation –yes

Uso: zeroclaw memory <COMANDO>

Subcomandos:

  • list — Lista las entradas de memoria con filtros opcionales
  • get — Obtener una entrada de memoria específica por clave
  • stats — Mostrar estadísticas y estado de salud del backend de memoria
  • clear — Limpiar memorias por categoría, por clave o limpiar todas
  • reindex —

zeroclaw memory list

Listar entradas de memoria con filtros opcionales

Uso: zeroclaw memory list [OPCIONES]

Opciones:

  • --category <CATEGORÍA>

  • --session <SESSION>

  • --limit <LIMIT>

    Valor predeterminado: 50

  • --offset <OFFSET>

    Valor predeterminado: 0

zeroclaw memory get

Obtener una entrada de memoria específica por clave

Uso: zeroclaw memory get <KEY>

Argumentos:

  • <KEY>

zeroclaw memory stats

Mostrar estadísticas y estado del backend de memoria

Uso: zeroclaw memory stats

zeroclaw memory clear

Borrar memorias por categoría, por clave o borrar todas

Uso: zeroclaw memory clear [OPCIONES]

Opciones:

  • --key <KEY> — Elimina una única entrada por clave (admite coincidencia de prefijo)
  • --category <CATEGORÍA>
  • --yes — Omitir la solicitud de confirmación

zeroclaw memory reindex

Uso: zeroclaw memory reindex

zeroclaw config

Gestionar la configuración de ZeroClaw.

Ver, establecer o inicializar propiedades de configuración mediante una ruta con puntos. Usa ‘schema’ para volcar el esquema JSON completo del archivo de configuración.

Las propiedades se direccionan mediante una ruta con puntos (por ejemplo, channels.matrix.mencionar-solo). Los campos de secretos (claves API, tokens) utilizan automáticamente una entrada enmascarada. Los campos de enumeración ofrecen una selección interactiva cuando el valor está omitido.

Ejemplos: zeroclaw config list # listar todas las propiedades zeroclaw config list –secrets # listar solo los secretos zeroclaw config list –filter channels.matrix # filtrar por prefijo zeroclaw config get channels.matrix.mention-only # obtener un valor zeroclaw config set channels.matrix.mention-only true # establecer un valor zeroclaw config set channels.matrix.access-token # secreto: entrada enmascarada zeroclaw config set channels.matrix.stream-mode # enumeración: selección interactiva zeroclaw config init channels.matrix # inicializar la sección con valores predeterminados zeroclaw config init risk_profiles.strict # crear un nuevo alias de mapa dinámico zeroclaw config schema # imprimir el esquema JSON en stdout zeroclaw config schema > schema.json

La finalización automática de rutas de propiedades se incluye automáticamente en zeroclaw completions <shell>.

Uso: zeroclaw config <COMANDO>

Subcomandos:

  • schema — Vuelca el JSON Schema completo de la configuración a stdout. Con --path, devuelve solo el fragmento del esquema para esa propiedad — el mismo payload que OPTIONS /api/config/prop?path=... devuelve por HTTP
  • list — Muestra todas las propiedades de configuración con sus valores actuales
  • get — Obtener el valor de una propiedad de configuración
  • set — Establece una propiedad de configuración (los campos secretos solicitan automáticamente una entrada enmascarada)
  • init — Inicializa las secciones no configuradas con los valores predeterminados (enabled=false)
  • migrate — Migra la configuración en disco a la versión actual del esquema (conserva los comentarios)
  • patch — Aplica un documento JSON Patch (RFC 6902) de forma atómica. Refleja PATCH /api/config. Lee las operaciones desde el archivo indicado, o desde stdin cuando la ruta es - o se omite. Operaciones admitidas: add, replace, remove, test. move y copy son rechazadas
  • docs — Muestra la URL del explorador de API (más una sugerencia si el daemon no se está ejecutando)
  • generate: generar

zeroclaw config schema

Vuelca el JSON Schema completo de configuración a stdout. Con --path, devuelve el fragmento del esquema únicamente para esa propiedad — la misma respuesta que OPTIONS /api/config/prop?path=... devuelve por HTTP

Uso: zeroclaw config schema [OPTIONS]

Opciones:

  • --path <PATH> — Ruta de propiedad para acotar el volcado del esquema (p. ej. agents.researcher.model_provider). Sin esta opción, vuelca el esquema de configuración completo

zeroclaw config list

Listar todas las propiedades de configuración con sus valores actuales

Uso: zeroclaw config list [OPTIONS]

Opciones:

  • -f, --filter <FILTER> — Filtrar por prefijo de ruta (por ejemplo, “channels.telegram”)
  • --secrets — Mostrar solo los campos secretos (encriptados)

zeroclaw config get

Obtener el valor de una propiedad de configuración

Uso: zeroclaw config get [OPTIONS] <PATH>

Argumentos:

  • <PATH> — Ruta de la propiedad (por ejemplo, channels.telegram.mention-only)

Opciones:

  • --json — Emite una estructura JSON ({path, value} o {path, populated}) en lugar de texto plano

zeroclaw config set

Establece una propiedad de configuración (los campos secretos se auto-solicitan para entrada enmascarada)

Uso: zeroclaw config set [OPTIONS] <PATH> [VALUE]

Argumentos:

  • <PATH> — Ruta de propiedad
  • <VALUE> — Nuevo valor (omitir para campos de secreto y obtener entrada enmascarada)

Opciones:

  • --no-interactive — Omitir las preguntas interactivas — requiere un valor en la línea de comandos, acepta cadenas sin procesar para enumeraciones
  • --comment <COMMENT> — Comentario opcional para escribir junto al valor en TOML (se conserva en futuras ediciones)
  • --json — Emite un sobre JSON estructurado al completarse correctamente

zeroclaw config init

Inicializar las secciones no configuradas con valores predeterminados (enabled=false)

Uso: zeroclaw config init [OPTIONS] [SECTION]

Argumentos:

  • <SECTION> — Prefijo de sección (p. ej. channels.matrix), o <section>.<alias> para crear un nuevo alias de mapa dinámico (p. ej. risk_profiles.strict). Omitir para inicializar todo

Opciones:

  • --json — Emite un envoltorio JSON estructurado ({initialized: […]}) en lugar de texto sin formato

zeroclaw config migrate

Migra la configuración en disco a la versión actual del esquema (conserva los comentarios)

Uso: zeroclaw config migrate [OPTIONS]

Opciones:

  • --json — Emitir un sobre JSON estructurado ({migrated, backup_path?, schema_version, valid?, error?}) en lugar de texto plano

zeroclaw config patch

Aplica atómicamente un documento JSON Patch (RFC 6902). Refleja PATCH /api/config. Lee las operaciones del archivo indicado o de la entrada estándar cuando la ruta es - o se omite. Operaciones compatibles: add, replace, remove, test. Se rechazan move y copy

Uso: zeroclaw config patch [OPTIONS] [INPUT]

Argumentos:

  • <INPUT> — Ruta a un documento JSON Patch, o - para stdin (predeterminado)

Opciones:

  • --json — Imprime los resultados como JSON (un objeto por operación aplicada) en lugar de texto legible

zeroclaw config docs

Imprime la URL del explorador de la API (más una sugerencia si el daemon no está en ejecución)

Uso: zeroclaw config docs

zeroclaw config generate

Uso: zeroclaw config generate [OPTIONS] [VERSION]

Argumentos:

  • <VERSION> — Versión de esquema de destino (p. ej. 1, 2, 3). Por defecto, la actual

Opciones:

  • --encrypt — Cifra los valores de cadena que contienen secretos en la salida (api_key, bot_token, access_token, password, refresh_token, etc.). Funciona en cualquier versión del esquema mediante un recorrido basado en nombres de claves. Utiliza el .secret_key del config-dir resuelto (crea uno si no existe)

zeroclaw update

Verificar y aplicar actualizaciones de ZeroClaw.

De forma predeterminada, descarga e instala la versión más reciente mediante una canalización de 6 fases: preflight, descarga, copia de seguridad, validación, cambio y prueba de humo. Realiza una reversión automática en caso de fallo.

Utiliza –check para solo verificar actualizaciones sin instalar. Usa –force para omitir el mensaje de confirmación. Usa –version para dirigirse a una versión específica en lugar de la última.

Ejemplos: zeroclaw update # descargar e instalar la última actualización de zeroclaw zeroclaw update –check # solo verificar, no instalar zeroclaw update –force # instalar sin confirmación zeroclaw update –version 0.6.0 # instalar una versión específica

Uso: zeroclaw update [OPTIONS]

Opciones:

  • --check — Solo verifica las actualizaciones, no instala
  • --force — Instalar incluso si el destino no es más nuevo (reinstalar o degradar/fijar a –version)
  • --version <VERSION> — Versión objetivo (predeterminado: última)
  • --json — Con –check, emite JSON legible por máquina en lugar de texto para humanos

zeroclaw self-test

Ejecuta las pruebas de diagnóstico para verificar la instalación de ZeroClaw.

Por defecto, ejecuta el conjunto completo de pruebas, incluidas las comprobaciones de red (estado del gateway, ida y vuelta de memoria). Usa –quick para omitir las comprobaciones de red y realizar una validación sin conexión más rápida.

Ejemplos: zeroclaw self-test # suite completa
zeroclaw self-test –quick # solo verificaciones rápidas (sin red)

Uso: zeroclaw self-test [OPCIONES]

Opciones:

  • --quick — Ejecutar solo comprobaciones rápidas (sin red)

zeroclaw completions

Genera scripts de finalización de shell para zeroclaw.

El script se imprime en stdout para que pueda ser fuente directamente:

Ejemplos (shells de Unix): source <(zeroclaw completions bash) zeroclaw completions zsh > ~/.zfunc/_zeroclaw zeroclaw completions fish > ~/.config/fish/completions/zeroclaw.fish

Ejemplos (Windows PowerShell): zeroclaw completions powershell | Out-String | Invoke-Expression zeroclaw completions powershell > $PROFILE.CurrentUserAllHosts

Uso: zeroclaw completions <SHELL>

Argumentos:

  • <SHELL> — Shell de destino

    Valores posibles: bash, fish, zsh, powershell, elvish

zeroclaw desktop

Inicia la aplicación de escritorio complementaria ZeroClaw.

La aplicación complementaria es una aplicación ligera de la barra de menús / bandeja del sistema que se conecta al mismo gateway que la CLI. Proporciona acceso rápido al panel de control, monitoreo de estado y emparejamiento de dispositivos.

Usa –install para abrir la página de descarga de tu plataforma. No instala nada por sí solo.

Ejemplos: zeroclaw desktop # inicia la aplicación complementaria zeroclaw desktop –install # abre la página de descarga

Uso: zeroclaw desktop [OPTIONS]

Opciones:

  • --install — Abrir la página de descarga de la aplicación complementaria

zeroclaw locales

Obtiene los catálogos Fluent (.ftl) traducidos para una configuración regional desde el repositorio upstream y los instala en <config-dir>/data/ftl/<locale>/, donde los cargadores de runtime y zerocode los leen.

Pasa una sola configuración regional. De forma predeterminada se obtienen todos los catálogos; restrínjalo con –catalog (separados por comas): cli, tools, zerocode.

Ejemplos: zeroclaw locales fetch ja zeroclaw locales fetch fr –catalog cli,tools zeroclaw locales fetch zh-CN –catalog zerocode

Uso: zeroclaw locales <COMMAND>

Subcomandos:

  • fetch — Descarga archivos FTL traducidos para una configuración regional desde el repositorio remoto

zeroclaw locales fetch

Descargar archivos FTL traducidos para una configuración regional desde upstream

Uso: zeroclaw locales fetch [OPTIONS] <LOCALE>

Argumentos:

  • <LOCALE> — Código de configuración regional a obtener (p. ej. ja, fr, zh-CN)

Opciones:

  • --catalog <CATALOG> — Catálogos a obtener separados por comas: cli, tools, zerocode. Omita esta opción para obtenerlos todos

Este documento fue generado automáticamente por clap-markdown.