English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Guides

Automação da CLI

Use --non-interactive para automatizar OmeniaClaw onboard.

Exemplo básico não interativo

bash
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-skills

Adicione --json para obter um resumo legível por máquina.

Use --skip-bootstrap quando sua automação pré-popula arquivos do workspace e não quer que o onboarding crie os arquivos de bootstrap padrão.

Use --secret-input-mode ref para armazenar referências baseadas em env em perfis de autenticação em vez de valores em texto simples. A seleção interativa entre referências env e referências configuradas do provedor (file ou exec) está disponível no fluxo de onboarding.

No modo ref não interativo, as variáveis de env do provedor devem estar definidas no ambiente do processo. Passar flags de chave inline sem a variável de env correspondente agora falha rapidamente.

Exemplo:

bash
OmeniaClaw onboard --non-interactive \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref \  --accept-risk

Exemplos específicos de provedor

Exemplo de chave de API da Anthropic
bash
OmeniaClaw onboard --non-interactive \  --mode local \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY" \  --gateway-port 18789 \  --gateway-bind loopback
Exemplo do Gemini
bash
OmeniaClaw onboard --non-interactive \  --mode local \  --auth-choice gemini-api-key \  --gemini-api-key "$GEMINI_API_KEY" \  --gateway-port 18789 \  --gateway-bind loopback
Exemplo da Z.AI
bash
OmeniaClaw onboard --non-interactive \  --mode local \  --auth-choice zai-api-key \  --zai-api-key "$ZAI_API_KEY" \  --gateway-port 18789 \  --gateway-bind loopback
Exemplo do Vercel AI Gateway
bash
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 loopback
Exemplo do Cloudflare AI Gateway
bash
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 loopback
Exemplo do Moonshot
bash
OmeniaClaw onboard --non-interactive \  --mode local \  --auth-choice moonshot-api-key \  --moonshot-api-key "$MOONSHOT_API_KEY" \  --gateway-port 18789 \  --gateway-bind loopback
Exemplo do Mistral
bash
OmeniaClaw onboard --non-interactive \  --mode local \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY" \  --gateway-port 18789 \  --gateway-bind loopback
Exemplo do Synthetic
bash
OmeniaClaw onboard --non-interactive \  --mode local \  --auth-choice synthetic-api-key \  --synthetic-api-key "$SYNTHETIC_API_KEY" \  --gateway-port 18789 \  --gateway-bind loopback
Exemplo do OpenCode
bash
OmeniaClaw onboard --non-interactive \  --mode local \  --auth-choice opencode-zen \  --opencode-zen-api-key "$OPENCODE_API_KEY" \  --gateway-port 18789 \  --gateway-bind loopback

Troque para --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" para o catálogo Go.

Exemplo do Ollama
bash
OmeniaClaw onboard --non-interactive \  --mode local \  --auth-choice ollama \  --custom-model-id "qwen3.5:27b" \  --accept-risk \  --gateway-port 18789 \  --gateway-bind loopback
Exemplo de provedor personalizado
bash
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 é opcional. Se omitido, o onboarding verifica CUSTOM_API_KEY. O OmeniaClaw marca IDs comuns de modelos de visão como compatíveis com imagem automaticamente. Adicione --custom-image-input para IDs de visão personalizados desconhecidos, ou --custom-text-input para forçar metadados somente texto.

Variante em modo ref:

bash
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 loopback

Nesse modo, o onboarding armazena apiKey como { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.

O setup-token da Anthropic continua disponível como um caminho de token de onboarding compatível, mas o OmeniaClaw agora prefere reutilizar a Claude CLI quando disponível. Para produção, prefira uma chave de API da Anthropic.

Adicionar outro agente

Use OmeniaClaw agents add <name> para criar um agente separado com seu próprio workspace, sessões e perfis de autenticação. Executar sem --workspace inicia o assistente.

bash
OmeniaClaw agents add work \  --workspace ~/.OmeniaClaw/workspace-work \  --model openai/gpt-5.5 \  --bind whatsapp:biz \  --non-interactive \  --json

O que ele define:

  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir

Observações:

  • Workspaces padrão seguem ~/.OmeniaClaw/workspace-<agentId>.
  • Adicione bindings para rotear mensagens de entrada (o assistente pode fazer isso).
  • Flags não interativas: --model, --agent-dir, --bind, --non-interactive.

Documentação relacionada

Was this useful?
On this page

On this page