Guides
Automatización de la CLI
Use --non-interactive para automatizar OmeniaClaw onboard.
Ejemplo base no interactivo
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice apiKey \ --anthropic-api-key "$ANTHROPIC_API_KEY" \ --secret-input-mode plaintext \ --gateway-port 18789 \ --gateway-bind loopback \ --install-daemon \ --daemon-runtime node \ --skip-bootstrap \ --skip-skillsAgrega --json para obtener un resumen legible por máquina.
Usa --skip-bootstrap cuando tu automatización precargue archivos de espacio de trabajo y no quieras que la incorporación cree los archivos bootstrap predeterminados.
Usa --secret-input-mode ref para almacenar referencias respaldadas por env en perfiles de autenticación en lugar de valores en texto sin formato.
La selección interactiva entre referencias env y referencias de proveedor configuradas (file o exec) está disponible en el flujo de incorporación.
En modo ref no interactivo, las variables env del proveedor deben estar definidas en el entorno del proceso.
Pasar flags de clave en línea sin la variable env correspondiente ahora falla rápido.
Ejemplo:
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice openai-api-key \ --secret-input-mode ref \ --accept-riskEjemplos específicos de proveedor
Ejemplo de clave de API de Anthropic
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice apiKey \ --anthropic-api-key "$ANTHROPIC_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackEjemplo de Gemini
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice gemini-api-key \ --gemini-api-key "$GEMINI_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackEjemplo de Z.AI
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice zai-api-key \ --zai-api-key "$ZAI_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackEjemplo de Vercel AI Gateway
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice ai-gateway-api-key \ --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackEjemplo de Cloudflare AI Gateway
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice cloudflare-ai-gateway-api-key \ --cloudflare-ai-gateway-account-id "your-account-id" \ --cloudflare-ai-gateway-gateway-id "your-gateway-id" \ --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackEjemplo de Moonshot
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice moonshot-api-key \ --moonshot-api-key "$MOONSHOT_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackEjemplo de Mistral
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice mistral-api-key \ --mistral-api-key "$MISTRAL_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackEjemplo de Synthetic
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice synthetic-api-key \ --synthetic-api-key "$SYNTHETIC_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackEjemplo de OpenCode
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice opencode-zen \ --opencode-zen-api-key "$OPENCODE_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopbackCambia a --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" para el catálogo de Go.
Ejemplo de Ollama
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice ollama \ --custom-model-id "qwen3.5:27b" \ --accept-risk \ --gateway-port 18789 \ --gateway-bind loopbackEjemplo de proveedor personalizado
OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice custom-api-key \ --custom-base-url "https://llm.example.com/v1" \ --custom-model-id "foo-large" \ --custom-api-key "$CUSTOM_API_KEY" \ --custom-provider-id "my-custom" \ --custom-compatibility anthropic \ --custom-image-input \ --gateway-port 18789 \ --gateway-bind loopback--custom-api-key es opcional. Si se omite, la incorporación comprueba CUSTOM_API_KEY.
OmeniaClaw marca automáticamente los ID de modelo de visión comunes como compatibles con imágenes. Agrega --custom-image-input para ID de visión personalizados desconocidos, o --custom-text-input para forzar metadatos solo de texto.
Variante en modo ref:
export CUSTOM_API_KEY="your-key"OmeniaClaw onboard --non-interactive \ --mode local \ --auth-choice custom-api-key \ --custom-base-url "https://llm.example.com/v1" \ --custom-model-id "foo-large" \ --secret-input-mode ref \ --custom-provider-id "my-custom" \ --custom-compatibility anthropic \ --custom-image-input \ --gateway-port 18789 \ --gateway-bind loopbackEn este modo, la incorporación almacena apiKey como { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.
El setup-token de Anthropic sigue disponible como ruta de token de incorporación compatible, pero OmeniaClaw ahora prefiere reutilizar Claude CLI cuando esté disponible. Para producción, prefiere una clave de API de Anthropic.
Agregar otro agente
Usa OmeniaClaw agents add <name> para crear un agente separado con su propio espacio de trabajo,
sesiones y perfiles de autenticación. Ejecutarlo sin --workspace inicia el asistente.
OmeniaClaw agents add work \ --workspace ~/.OmeniaClaw/workspace-work \ --model openai/gpt-5.5 \ --bind whatsapp:biz \ --non-interactive \ --jsonLo que define:
agents.list[].nameagents.list[].workspaceagents.list[].agentDir
Notas:
- Los espacios de trabajo predeterminados siguen
~/.OmeniaClaw/workspace-<agentId>. - Agrega
bindingspara enrutar mensajes entrantes (el asistente puede hacerlo). - Flags no interactivos:
--model,--agent-dir,--bind,--non-interactive.
Documentos relacionados
- Centro de incorporación: Incorporación (CLI)
- Referencia completa: Referencia de configuración de CLI
- Referencia de comandos:
OmeniaClaw onboard
