diff --git a/docs/pt-BR/cli/cron.md b/docs/pt-BR/cli/cron.md index 835eb4599..c3cb2d391 100644 --- a/docs/pt-BR/cli/cron.md +++ b/docs/pt-BR/cli/cron.md @@ -1,24 +1,24 @@ --- read_when: - Você quer tarefas agendadas e ativações - - Você está depurando a execução do Cron e os logs -summary: Referência da CLI para `openclaw cron` (agendar e executar trabalhos em segundo plano) + - Você está depurando a execução do Cron e os registros +summary: Referência da CLI para `openclaw cron` (agendar e executar tarefas em segundo plano) title: Cron x-i18n: - generated_at: "2026-05-02T05:43:01Z" + generated_at: "2026-05-05T06:15:57Z" model: gpt-5.5 provider: openai - source_hash: 298ac3fc868462eb301febbc1aa5296d8087cad7fdc466870487081444c5856f + source_hash: 804efac75b8653b03cec197247be847498e084b50b00fb7bd3fbd94067ef25d4 source_path: cli/cron.md workflow: 16 --- # `openclaw cron` -Gerencie tarefas cron para o agendador do Gateway. +Gerencie jobs de Cron para o agendador do Gateway. -Execute `openclaw cron --help` para ver toda a superfície de comandos. Consulte [Tarefas cron](/pt-BR/automation/cron-jobs) para o guia conceitual. +Execute `openclaw cron --help` para ver toda a superfície de comandos. Consulte [Jobs de Cron](/pt-BR/automation/cron-jobs) para o guia conceitual. ## Sessões @@ -28,142 +28,140 @@ Execute `openclaw cron --help` para ver toda a superfície de comandos. Consulte - `main` vincula à sessão principal do agente. - - `isolated` cria uma transcrição e um id de sessão novos para cada execução. + - `isolated` cria uma transcrição e um ID de sessão novos para cada execução. - `current` vincula à sessão ativa no momento da criação. - `session:` fixa uma chave de sessão persistente explícita. - Execuções isoladas redefinem o contexto de conversa ambiente. Roteamento de canal e grupo, política de envio/fila, elevação, origem e vinculação de runtime ACP são redefinidos para a nova execução. Preferências seguras e substituições explícitas de modelo ou autenticação selecionadas pelo usuário podem ser mantidas entre execuções. + Execuções isoladas redefinem o contexto de conversa ambiente. Roteamento de canal e grupo, política de envio/fila, elevação, origem e vinculação de runtime ACP são redefinidos para a nova execução. Preferências seguras e substituições explícitas de modelo ou autenticação selecionadas pelo usuário podem ser preservadas entre execuções. ## Entrega -`openclaw cron list` e `openclaw cron show ` mostram uma prévia da rota de entrega resolvida. Para `channel: "last"`, a prévia mostra se a rota foi resolvida a partir da sessão principal ou atual, ou se falhará em modo fechado. +`openclaw cron list` e `openclaw cron show ` mostram uma prévia da rota de entrega resolvida. Para `channel: "last"`, a prévia mostra se a rota foi resolvida a partir da sessão principal ou atual, ou se falhará fechada. -Destinos prefixados por provedor podem desambiguar canais de anúncio não resolvidos. Por exemplo, `to: "telegram:123"` seleciona Telegram quando `delivery.channel` é omitido ou `last`. Somente prefixos anunciados pelo plugin carregado são seletores de provedor. Se `delivery.channel` for explícito, o prefixo deve corresponder a esse canal; `channel: "whatsapp"` com `to: "telegram:123"` é rejeitado. Prefixos de serviço como `imessage:` e `sms:` continuam sendo sintaxe de destino pertencente ao canal. +Destinos com prefixo de provedor podem desambiguar canais de anúncio não resolvidos. Por exemplo, `to: "telegram:123"` seleciona Telegram quando `delivery.channel` é omitido ou é `last`. Somente prefixos anunciados pelo plugin carregado são seletores de provedor. Se `delivery.channel` for explícito, o prefixo deve corresponder a esse canal; `channel: "whatsapp"` com `to: "telegram:123"` é rejeitado. Prefixos de serviço como `imessage:` e `sms:` permanecem como sintaxe de destino pertencente ao canal. -Tarefas `cron add` isoladas usam entrega `--announce` por padrão. Use `--no-deliver` para manter a saída interna. `--deliver` permanece como um alias obsoleto para `--announce`. +Jobs isolados de `cron add` usam entrega `--announce` por padrão. Use `--no-deliver` para manter a saída interna. `--deliver` permanece como um alias obsoleto de `--announce`. ### Propriedade da entrega -A entrega de chat de cron isolado é compartilhada entre o agente e o executor: +A entrega de chat de Cron isolado é compartilhada entre o agente e o executor: - O agente pode enviar diretamente usando a ferramenta `message` quando uma rota de chat está disponível. -- `announce` faz a entrega final de fallback apenas quando o agente não enviou diretamente para o destino resolvido. +- `announce` entrega o fallback da resposta final somente quando o agente não enviou diretamente ao destino resolvido. - `webhook` publica o payload concluído em uma URL. -- `none` desabilita a entrega de fallback do executor. +- `none` desativa a entrega de fallback do executor. -`--announce` é a entrega de fallback do executor para a resposta final. `--no-deliver` desabilita esse fallback, mas não remove a ferramenta `message` do agente quando uma rota de chat está disponível. +`--announce` é a entrega de fallback do executor para a resposta final. `--no-deliver` desativa esse fallback, mas não remove a ferramenta `message` do agente quando uma rota de chat está disponível. -Lembretes criados a partir de um chat ativo preservam o destino de entrega do chat ao vivo para entrega de anúncio de fallback. Chaves de sessão internas podem estar em minúsculas; não as use como fonte de verdade para IDs de provedor sensíveis a maiúsculas e minúsculas, como IDs de sala do Matrix. +Lembretes criados a partir de um chat ativo preservam o destino de entrega do chat ao vivo para entrega de anúncio de fallback. Chaves de sessão internas podem estar em minúsculas; não as use como fonte da verdade para IDs de provedor sensíveis a maiúsculas e minúsculas, como IDs de salas do Matrix. -### Entrega de falhas +### Entrega de falha Notificações de falha são resolvidas nesta ordem: -1. `delivery.failureDestination` na tarefa. +1. `delivery.failureDestination` no job. 2. `cron.failureDestination` global. -3. O destino principal de anúncio da tarefa (quando nenhum destino de falha explícito está definido). +3. O destino de anúncio primário do job (quando nenhum destino de falha explícito está definido). -Tarefas de sessão principal só podem usar `delivery.failureDestination` quando o modo de entrega principal é `webhook`. Tarefas isoladas o aceitam em todos os modos. +Jobs de sessão principal só podem usar `delivery.failureDestination` quando o modo de entrega primário é `webhook`. Jobs isolados o aceitam em todos os modos. -Observação: execuções de cron isolado tratam falhas de agente no nível da execução como erros de tarefa mesmo quando -nenhum payload de resposta é produzido, portanto falhas de modelo/provedor ainda incrementam contadores -de erro e acionam notificações de falha. +Observação: execuções isoladas de Cron tratam falhas de agente no nível da execução como erros de job mesmo quando nenhum payload de resposta é produzido, então falhas de modelo/provedor ainda incrementam contadores de erro e acionam notificações de falha. ## Agendamento -### Tarefas de execução única +### Jobs únicos -`--at ` agenda uma execução única. Datas e horas sem deslocamento são tratadas como UTC, a menos que você também passe `--tz `, que interpreta o horário de relógio na timezone informada. +`--at ` agenda uma execução única. Datas e horas sem offset são tratadas como UTC, a menos que você também passe `--tz `, que interpreta o horário de relógio na timezone fornecida. -Tarefas de execução única são excluídas após sucesso por padrão. Use `--keep-after-run` para preservá-las. +Jobs únicos são excluídos após o sucesso por padrão. Use `--keep-after-run` para preservá-los. -### Tarefas recorrentes +### Jobs recorrentes -Tarefas recorrentes usam backoff exponencial de nova tentativa após erros consecutivos: 30s, 1m, 5m, 15m, 60m. A agenda volta ao normal após a próxima execução bem-sucedida. +Jobs recorrentes usam backoff exponencial de nova tentativa após erros consecutivos: 30s, 1m, 5m, 15m, 60m. O agendamento volta ao normal após a próxima execução bem-sucedida. -Execuções ignoradas são rastreadas separadamente de erros de execução. Elas não afetam o backoff de nova tentativa, mas `openclaw cron edit --failure-alert-include-skipped` pode fazer alertas de falha incluírem notificações repetidas de execução ignorada. +Execuções ignoradas são rastreadas separadamente dos erros de execução. Elas não afetam o backoff de nova tentativa, mas `openclaw cron edit --failure-alert-include-skipped` pode incluir notificações repetidas de execuções ignoradas nos alertas de falha. -Para tarefas isoladas que têm como destino um provedor de modelo configurado localmente, o cron executa um preflight leve do provedor antes de iniciar o turno do agente. Provedores `api: "ollama"` em loopback, rede privada e `.local` são sondados em `/api/tags`; provedores locais compatíveis com OpenAI, como vLLM, SGLang e LM Studio, são sondados em `/models`. Se o endpoint estiver inacessível, a execução é registrada como `skipped` e tentada novamente em uma agenda posterior; endpoints inativos correspondentes são armazenados em cache por 5 minutos para evitar que muitas tarefas sobrecarreguem o mesmo servidor local. +Para jobs isolados que têm como destino um provedor de modelo local configurado, o Cron executa uma pré-verificação leve do provedor antes de iniciar o turno do agente. Provedores `api: "ollama"` em loopback, rede privada e `.local` são verificados em `/api/tags`; provedores locais compatíveis com OpenAI, como vLLM, SGLang e LM Studio, são verificados em `/models`. Se o endpoint estiver inacessível, a execução é registrada como `skipped` e tentada novamente em um agendamento posterior; endpoints inativos correspondentes são armazenados em cache por 5 minutos para evitar que muitos jobs sobrecarreguem o mesmo servidor local. -Observação: definições de tarefas cron ficam em `jobs.json`, enquanto o estado de runtime pendente fica em `jobs-state.json`. Se `jobs.json` for editado externamente, o Gateway recarrega agendas alteradas e limpa slots pendentes obsoletos; regravações apenas de formatação não limpam o slot pendente. +Observação: definições de jobs de Cron ficam em `jobs.json`, enquanto o estado de runtime pendente fica em `jobs-state.json`. Se `jobs.json` for editado externamente, o Gateway recarrega agendamentos alterados e limpa slots pendentes obsoletos; regravações apenas de formatação não limpam o slot pendente. ### Execuções manuais `openclaw cron run` retorna assim que a execução manual é enfileirada. Respostas bem-sucedidas incluem `{ ok: true, enqueued: true, runId }`. Use `openclaw cron runs --id ` para acompanhar o resultado eventual. -`openclaw cron run ` força a execução por padrão. Use `--due` para manter o comportamento antigo de "executar somente se estiver vencida". +`openclaw cron run ` força a execução por padrão. Use `--due` para manter o comportamento antigo de "executar somente se estiver vencido". ## Modelos -`cron add|edit --model ` seleciona um modelo permitido para a tarefa. +`cron add|edit --model ` seleciona um modelo permitido para o job. -Se o modelo não for permitido ou não puder ser resolvido, o cron falha a execução com um erro de validação explícito, em vez de recorrer ao agente da tarefa ou à seleção de modelo padrão. +Se o modelo não for permitido ou não puder ser resolvido, o Cron falha a execução com um erro de validação explícito em vez de recorrer ao agente do job ou à seleção de modelo padrão. -Cron `--model` é um **primário da tarefa**, não uma substituição de `/model` de sessão de chat. Isso significa: +`--model` do Cron é um **primário do job**, não uma substituição `/model` de sessão de chat. Isso significa: -- Fallbacks de modelo configurados ainda se aplicam quando o modelo da tarefa selecionado falha. -- `fallbacks` no payload por tarefa substitui a lista de fallbacks configurada quando presente. -- Uma lista de fallbacks por tarefa vazia (`fallbacks: []` no payload/API da tarefa) torna a execução cron estrita. -- Quando uma tarefa tem `--model`, mas nenhuma lista de fallbacks está configurada, o OpenClaw passa uma substituição de fallback vazia explícita para que o primário do agente não seja anexado como destino oculto de nova tentativa. +- Fallbacks de modelo configurados ainda se aplicam quando o modelo selecionado do job falha. +- `fallbacks` no payload por job substitui a lista de fallback configurada quando presente. +- Uma lista de fallback vazia por job (`fallbacks: []` no payload/API do job) torna a execução do Cron estrita. +- Quando um job tem `--model`, mas nenhuma lista de fallback está configurada, o OpenClaw passa uma substituição explícita de fallback vazia para que o primário do agente não seja anexado como um destino oculto de nova tentativa. -### Precedência de modelo de cron isolado +### Precedência de modelo do Cron isolado -O cron isolado resolve o modelo ativo nesta ordem: +O Cron isolado resolve o modelo ativo nesta ordem: -1. Substituição de hook do Gmail. -2. `--model` por tarefa. -3. Substituição de modelo de sessão cron armazenada (quando o usuário selecionou uma). +1. Substituição do hook do Gmail. +2. `--model` por job. +3. Substituição de modelo armazenada da sessão de Cron (quando o usuário selecionou uma). 4. Seleção de modelo do agente ou padrão. ### Modo rápido -O modo rápido de cron isolado segue a seleção de modelo ao vivo resolvida. A configuração de modelo `params.fastMode` se aplica por padrão, mas uma substituição `fastMode` de sessão armazenada ainda prevalece sobre a configuração. +O modo rápido do Cron isolado segue a seleção de modelo ao vivo resolvida. A configuração de modelo `params.fastMode` se aplica por padrão, mas uma substituição `fastMode` de sessão armazenada ainda tem precedência sobre a configuração. ### Novas tentativas de troca de modelo ao vivo -Se uma execução isolada lançar `LiveSessionModelSwitchError`, o cron persiste o provedor e o modelo trocados (e a substituição de perfil de autenticação trocada quando presente) para a execução ativa antes de tentar novamente. O loop externo de novas tentativas é limitado a duas tentativas de troca após a tentativa inicial e então aborta, em vez de ficar em loop para sempre. +Se uma execução isolada lançar `LiveSessionModelSwitchError`, o Cron persiste o provedor e o modelo trocados (e a substituição de perfil de autenticação trocada, quando presente) para a execução ativa antes de tentar novamente. O loop externo de nova tentativa é limitado a duas novas tentativas de troca após a tentativa inicial e então aborta em vez de repetir para sempre. -## Saída de execução e negações +## Saída da execução e recusas ### Supressão de confirmação obsoleta -Turnos de cron isolado suprimem respostas obsoletas que contêm apenas confirmação. Se o primeiro resultado for apenas uma atualização de status intermediária e nenhuma execução de subagente descendente for responsável pela resposta eventual, o cron solicita novamente uma vez o resultado real antes da entrega. +Turnos de Cron isolado suprimem respostas obsoletas que são apenas confirmações. Se o primeiro resultado for apenas uma atualização de status provisória e nenhuma execução de subagente descendente for responsável pela resposta eventual, o Cron solicita novamente uma vez pelo resultado real antes da entrega. ### Supressão de token silencioso -Se uma execução de cron isolado retornar apenas o token silencioso (`NO_REPLY` ou `no_reply`), o cron suprime tanto a entrega direta de saída quanto o caminho de resumo enfileirado de fallback, para que nada seja publicado de volta no chat. +Se uma execução isolada de Cron retornar apenas o token silencioso (`NO_REPLY` ou `no_reply`), o Cron suprime tanto a entrega direta de saída quanto o caminho de resumo enfileirado de fallback, então nada é publicado de volta no chat. -### Negações estruturadas +### Recusas estruturadas -Execuções de cron isolado preferem metadados estruturados de negação de execução da execução incorporada e então recorrem a marcadores de negação conhecidos na saída final, como `SYSTEM_RUN_DENIED`, `INVALID_REQUEST` e frases de recusa de vinculação de aprovação. +Execuções isoladas de Cron preferem metadados estruturados de recusa de execução da execução incorporada e então recorrem a marcadores de recusa conhecidos na saída final, como `SYSTEM_RUN_DENIED`, `INVALID_REQUEST` e frases de recusa de vinculação de aprovação. -`cron list` e o histórico de execuções exibem o motivo da negação em vez de relatar um comando bloqueado como `ok`. +`cron list` e o histórico de execuções expõem o motivo da recusa em vez de relatar um comando bloqueado como `ok`. ## Retenção -Retenção e poda são controladas na configuração: +Retenção e limpeza são controladas na configuração: -- `cron.sessionRetention` (padrão `24h`) poda sessões de execução isolada concluídas. -- `cron.runLog.maxBytes` e `cron.runLog.keepLines` podam `~/.openclaw/cron/runs/.jsonl`. +- `cron.sessionRetention` (padrão `24h`) limpa sessões concluídas de execuções isoladas. +- `cron.runLog.maxBytes` e `cron.runLog.keepLines` limpam `~/.openclaw/cron/runs/.jsonl`. -## Migrando tarefas antigas +## Migrando jobs antigos -Se você tiver tarefas cron de antes do formato atual de entrega e armazenamento, execute `openclaw doctor --fix`. O Doctor normaliza campos cron legados (`jobId`, `schedule.cron`, campos de entrega de nível superior incluindo `threadId` legado, aliases de entrega `provider` de payload) e migra tarefas simples de fallback de webhook `notify: true` para entrega webhook explícita quando `cron.webhook` está configurado. +Se você tem jobs de Cron de antes do formato atual de entrega e armazenamento, execute `openclaw doctor --fix`. O Doctor normaliza campos legados de Cron (`jobId`, `schedule.cron`, campos de entrega de nível superior incluindo `threadId` legado, aliases de entrega `provider` no payload) e migra jobs simples de fallback de webhook `notify: true` para entrega explícita por webhook quando `cron.webhook` está configurado. ## Edições comuns @@ -174,31 +172,31 @@ Atualize configurações de entrega sem alterar a mensagem: openclaw cron edit --announce --channel telegram --to "123456789" ``` -Desabilite a entrega para uma tarefa isolada: +Desative a entrega para um job isolado: ```bash openclaw cron edit --no-deliver ``` -Habilite contexto leve de bootstrap para uma tarefa isolada: +Ative contexto leve de bootstrap para um job isolado: ```bash openclaw cron edit --light-context ``` -Anuncie em um canal específico: +Anuncie para um canal específico: ```bash openclaw cron edit --announce --channel slack --to "channel:C1234567890" ``` -Anuncie em um tópico de fórum do Telegram: +Anuncie para um tópico de fórum do Telegram: ```bash openclaw cron edit --announce --channel telegram --to "-1001234567890" --thread-id 42 ``` -Crie uma tarefa isolada com contexto leve de bootstrap: +Crie um job isolado com contexto leve de bootstrap: ```bash openclaw cron add \ @@ -210,7 +208,7 @@ openclaw cron add \ --no-deliver ``` -`--light-context` se aplica apenas a tarefas de turno de agente isoladas. Para execuções cron, o modo leve mantém o contexto de bootstrap vazio em vez de injetar o conjunto completo de bootstrap do espaço de trabalho. +`--light-context` se aplica somente a jobs isolados de turno de agente. Para execuções de Cron, o modo leve mantém o contexto de bootstrap vazio em vez de injetar o conjunto completo de bootstrap do workspace. ## Comandos administrativos comuns @@ -218,13 +216,16 @@ Execução manual e inspeção: ```bash openclaw cron list +openclaw cron list --agent ops openclaw cron show openclaw cron run openclaw cron run --due openclaw cron runs --id --limit 50 ``` -Entradas de `cron runs` incluem diagnósticos de entrega com o destino cron pretendido, o destino resolvido, envios pela ferramenta de mensagem, uso de fallback e estado entregue. +`openclaw cron list` mostra todos os jobs correspondentes por padrão. Passe `--agent ` para mostrar somente jobs cujo ID de agente normalizado efetivo corresponda; jobs sem um ID de agente armazenado contam como o agente padrão configurado. + +Entradas de `cron runs` incluem diagnósticos de entrega com o destino pretendido do Cron, o destino resolvido, envios pela ferramenta de mensagem, uso de fallback e estado entregue. Redirecionamento de agente e sessão: @@ -235,7 +236,7 @@ openclaw cron edit --session current openclaw cron edit --session "session:daily-brief" ``` -`openclaw cron add` avisa quando `--agent` é omitido em tarefas de turno de agente e recorre ao agente padrão (`main`). Passe `--agent ` no momento da criação para fixar um agente específico. +`openclaw cron add` avisa quando `--agent` é omitido em jobs de turno de agente e recorre ao agente padrão (`main`). Passe `--agent ` no momento da criação para fixar um agente específico. Ajustes de entrega: @@ -246,7 +247,7 @@ openclaw cron edit --no-best-effort-deliver openclaw cron edit --no-deliver ``` -## Relacionado +## Relacionados - [Referência da CLI](/pt-BR/cli) - [Tarefas agendadas](/pt-BR/automation/cron-jobs) diff --git a/docs/pt-BR/cli/status.md b/docs/pt-BR/cli/status.md index 9fb596918..badffb631 100644 --- a/docs/pt-BR/cli/status.md +++ b/docs/pt-BR/cli/status.md @@ -1,14 +1,14 @@ --- read_when: - Você quer um diagnóstico rápido da integridade do canal + destinatários recentes da sessão - - Você quer um status “all” para depuração que possa ser colado + - Você quer um status “all” que possa ser colado para depuração summary: Referência da CLI para `openclaw status` (diagnósticos, sondagens, instantâneos de uso) title: Status x-i18n: - generated_at: "2026-04-30T09:43:11Z" + generated_at: "2026-05-05T06:15:56Z" model: gpt-5.5 provider: openai - source_hash: a85613e1830dc24253847e6517d3e155c175bb39ff6b01031ac5cb4291e276fa + source_hash: 5025ed99d351a43adc60b6896349366b225fd7ecb8ab422dba376f2d157f0033 source_path: cli/status.md workflow: 16 --- @@ -24,25 +24,26 @@ openclaw status --deep openclaw status --usage ``` -Notas: +Observações: -- `--deep` executa sondagens ao vivo (WhatsApp Web + Telegram + Discord + Slack + Signal). -- `openclaw status` simples permanece no caminho rápido somente leitura e marca a memória como `not checked` em vez de indisponível quando pula a inspeção de memória. Auditoria de segurança pesada, compatibilidade de plugins e sondagens de vetores de memória ficam para `openclaw status --all`, `openclaw status --deep`, `openclaw security audit` e `openclaw memory status --deep`. -- `status --json --all` relata detalhes de memória do runtime do Plugin de memória ativo selecionado por `plugins.slots.memory`. Plugins de memória personalizados podem deixar o `agents.defaults.memorySearch.enabled` integrado desabilitado e ainda relatar seus próprios arquivos, chunks, vetores e estado de FTS. +- `--deep` executa verificações ao vivo (WhatsApp Web + Telegram + Discord + Slack + Signal). +- `openclaw status` simples permanece no caminho rápido somente leitura e marca a memória como `not checked` em vez de indisponível quando pula a inspeção de memória. Auditoria de segurança pesada, compatibilidade de Plugin e verificações de vetor de memória ficam para `openclaw status --all`, `openclaw status --deep`, `openclaw security audit` e `openclaw memory status --deep`. +- `status --json --all` relata detalhes de memória do runtime do Plugin de memória ativo selecionado por `plugins.slots.memory`. Plugins de memória personalizados podem deixar `agents.defaults.memorySearch.enabled` integrado desativado e ainda relatar seus próprios arquivos, fragmentos, vetor e estado de FTS. - `--usage` imprime janelas normalizadas de uso do provedor como `X% left`. -- A saída de status da sessão separa `Execution:` de `Runtime:`. `Execution` é o caminho de sandbox (`direct`, `docker/*`), enquanto `Runtime` informa se a sessão está usando `OpenClaw Pi Default`, `OpenAI Codex`, um backend de CLI ou um backend ACP, como `codex (acp/acpx)`. Consulte [Runtimes de agentes](/pt-BR/concepts/agent-runtimes) para ver a distinção entre provedor/modelo/runtime. -- Os campos brutos `usage_percent` / `usagePercent` do MiniMax são a cota restante, então o OpenClaw os inverte antes da exibição; campos baseados em contagem prevalecem quando presentes. Respostas de `model_remains` dão preferência à entrada de modelo de chat, derivam o rótulo da janela a partir de timestamps quando necessário e incluem o nome do modelo no rótulo do plano. -- Quando o snapshot da sessão atual é esparso, `/status` pode preencher contadores de tokens e cache a partir do log de uso da transcrição mais recente. Valores ao vivo existentes e não zero ainda prevalecem sobre valores de fallback da transcrição. -- O fallback da transcrição também pode recuperar o rótulo do modelo de runtime ativo quando a entrada da sessão ao vivo não o contém. Se esse modelo da transcrição for diferente do modelo selecionado, o status resolve a janela de contexto em relação ao modelo de runtime recuperado, em vez do selecionado. -- Para contabilização do tamanho do prompt, o fallback da transcrição prefere o total maior orientado a prompt quando os metadados da sessão estão ausentes ou são menores, para que sessões de provedores personalizados não caiam para exibições de `0` tokens. -- A saída inclui stores de sessão por agente quando vários agentes estão configurados. -- A visão geral inclui o status de instalação/runtime do Gateway + serviço de host do node quando disponível. -- A visão geral inclui canal de atualização + SHA do git (para checkouts de código-fonte). +- A saída de status da sessão separa `Execution:` de `Runtime:`. `Execution` é o caminho do sandbox (`direct`, `docker/*`), enquanto `Runtime` informa se a sessão está usando `OpenClaw Pi Default`, `OpenAI Codex`, um backend de CLI ou um backend de ACP, como `codex (acp/acpx)`. Consulte [Runtimes de agentes](/pt-BR/concepts/agent-runtimes) para a distinção entre provedor/modelo/runtime. +- Os campos brutos `usage_percent` / `usagePercent` da MiniMax são a cota restante, então o OpenClaw os inverte antes da exibição; campos baseados em contagem prevalecem quando presentes. Respostas de `model_remains` preferem a entrada do modelo de chat, derivam o rótulo da janela de carimbos de data/hora quando necessário e incluem o nome do modelo no rótulo do plano. +- Quando o snapshot da sessão atual é esparso, `/status` pode preencher retroativamente os contadores de tokens e cache a partir do log de uso da transcrição mais recente. Valores ao vivo existentes e diferentes de zero ainda prevalecem sobre valores de fallback da transcrição. +- `/status` inclui tempo de atividade compacto do processo do Gateway e tempo de atividade do sistema host. +- O fallback da transcrição também pode recuperar o rótulo do modelo de runtime ativo quando a entrada da sessão ao vivo não o contém. Se esse modelo da transcrição for diferente do modelo selecionado, o status resolve a janela de contexto usando o modelo de runtime recuperado em vez do selecionado. +- Para contabilização de tamanho do prompt, o fallback da transcrição prefere o maior total orientado a prompt quando os metadados da sessão estão ausentes ou são menores, para que sessões de provedores personalizados não sejam reduzidas a exibições de `0` token. +- A saída inclui armazenamentos de sessão por agente quando vários agentes estão configurados. +- A visão geral inclui o status de instalação/runtime do serviço do Gateway + host do Node quando disponível. +- A visão geral inclui o canal de atualização + SHA do git (para checkouts de código-fonte). - Informações de atualização aparecem na Visão geral; se houver uma atualização disponível, o status imprime uma dica para executar `openclaw update` (consulte [Atualização](/pt-BR/install/updating)). - Superfícies de status somente leitura (`status`, `status --json`, `status --all`) resolvem SecretRefs compatíveis para seus caminhos de configuração direcionados quando possível. -- Se um SecretRef de canal compatível estiver configurado, mas indisponível no caminho do comando atual, o status permanece somente leitura e relata saída degradada em vez de travar. A saída humana mostra avisos como “token configurado indisponível neste caminho de comando”, e a saída JSON inclui `secretDiagnostics`. -- Quando a resolução de SecretRef local ao comando é bem-sucedida, o status prefere o snapshot resolvido e limpa marcadores transitórios de “secret indisponível” do canal na saída final. -- `status --all` inclui uma linha de visão geral de Segredos e uma seção de diagnóstico que resume diagnósticos de segredos (truncados para facilitar a leitura) sem interromper a geração do relatório. +- Se uma SecretRef de canal compatível estiver configurada, mas indisponível no caminho do comando atual, o status permanece somente leitura e relata saída degradada em vez de falhar. A saída humana mostra avisos como “token configurado indisponível neste caminho de comando”, e a saída JSON inclui `secretDiagnostics`. +- Quando a resolução de SecretRef local ao comando é bem-sucedida, o status prefere o snapshot resolvido e limpa marcadores transitórios de “segredo indisponível” do canal na saída final. +- `status --all` inclui uma linha de visão geral de Segredos e uma seção de diagnóstico que resume diagnósticos de segredo (truncados para legibilidade) sem interromper a geração do relatório. ## Relacionado diff --git a/docs/pt-BR/tools/media-overview.md b/docs/pt-BR/tools/media-overview.md index e6aca5bad..cc219edc5 100644 --- a/docs/pt-BR/tools/media-overview.md +++ b/docs/pt-BR/tools/media-overview.md @@ -1,22 +1,22 @@ --- read_when: - Procurando uma visão geral dos recursos de mídia do OpenClaw - - Decidindo qual provedor de mídia configurar + - Como decidir qual provedor de mídia configurar - Entendendo como funciona a geração assíncrona de mídia sidebarTitle: Media overview -summary: Visão geral dos recursos de imagem, vídeo, música, fala e compreensão de mídia -title: Visão geral da mídia +summary: Visão geral das capacidades de imagem, vídeo, música, fala e compreensão de mídia +title: Visão geral de mídia x-i18n: - generated_at: "2026-05-05T05:44:48Z" + generated_at: "2026-05-05T06:15:57Z" model: gpt-5.5 provider: openai - source_hash: c57781188ca8a2dbcf378ef82dcea6645c56ed5c5dbb3222c9e4b58ab1398bf1 + source_hash: fd02d4418fe294fda5f1437dd3a07c4aeb4de3b46a1b70bfe36914bc27123cc4 source_path: tools/media-overview.md workflow: 16 --- -O OpenClaw gera imagens, vídeos e música, entende mídia recebida -(imagens, áudio, vídeo) e fala respostas em voz alta com síntese de fala. Todos +OpenClaw gera imagens, vídeos e música, entende mídia recebida +(imagens, áudio, vídeo) e fala respostas em voz alta com texto para fala. Todos os recursos de mídia são orientados por ferramentas: o agente decide quando usá-los com base na conversa, e cada ferramenta só aparece quando pelo menos um provedor de suporte está configurado. @@ -24,122 +24,122 @@ está configurado. ## Recursos - + Crie e edite imagens a partir de prompts de texto ou imagens de referência via `image_generate`. Síncrono — conclui junto com a resposta. - + Texto para vídeo, imagem para vídeo e vídeo para vídeo via `video_generate`. - Assíncrono — executa em segundo plano e publica o resultado quando estiver pronto. + Assíncrono — roda em segundo plano e publica o resultado quando estiver pronto. - - Gere música ou faixas de áudio via `music_generate`. Assíncrono em provedores - compartilhados; o caminho de workflow do ComfyUI executa de forma síncrona. + + Gere música ou faixas de áudio via `music_generate`. Assíncrono em + provedores compartilhados; o caminho de workflow do ComfyUI roda de forma síncrona. - - Converta respostas de saída em áudio falado via a ferramenta `tts` mais a + + Converta respostas enviadas em áudio falado via a ferramenta `tts` mais a configuração `messages.tts`. Síncrono. - + Resuma imagens, áudio e vídeo recebidos usando provedores de modelo com - capacidade de visão e Plugins dedicados de compreensão de mídia. + capacidade de visão e plugins dedicados de entendimento de mídia. - - Transcreva mensagens de voz recebidas por meio de provedores de STT em lote ou de - STT por streaming de Chamada de voz. + + Transcreva mensagens de voz recebidas por meio de provedores de STT em lote ou STT + por streaming de chamada de voz. ## Matriz de recursos por provedor -| Provedor | Imagem | Vídeo | Música | TTS | STT | Voz em tempo real | Compreensão de mídia | -| ----------- | :----: | :---: | :----: | :-: | :-: | :---------------: | :------------------: | -| Alibaba | | ✓ | | | | | | -| BytePlus | | ✓ | | | | | | -| ComfyUI | ✓ | ✓ | ✓ | | | | | -| DeepInfra | ✓ | ✓ | | ✓ | ✓ | | ✓ | -| Deepgram | | | | | ✓ | ✓ | | -| ElevenLabs | | | | ✓ | ✓ | | | -| fal | ✓ | ✓ | | | | | | -| Google | ✓ | ✓ | ✓ | ✓ | | ✓ | ✓ | -| Gradium | | | | ✓ | | | | -| CLI local | | | | ✓ | | | | -| Microsoft | | | | ✓ | | | | -| MiniMax | ✓ | ✓ | ✓ | ✓ | | | | -| Mistral | | | | | ✓ | | | -| OpenAI | ✓ | ✓ | | ✓ | ✓ | ✓ | ✓ | -| OpenRouter | ✓ | ✓ | | ✓ | | | ✓ | -| Qwen | | ✓ | | | | | | -| Runway | | ✓ | | | | | | -| SenseAudio | | | | | ✓ | | | -| Together | | ✓ | | | | | | -| Vydra | ✓ | ✓ | | ✓ | | | | -| xAI | ✓ | ✓ | | ✓ | ✓ | | ✓ | -| Xiaomi MiMo | ✓ | | | ✓ | | | ✓ | +| Provedor | Imagem | Vídeo | Música | TTS | STT | Voz em tempo real | Entendimento de mídia | +| ----------- | :----: | :---: | :----: | :-: | :-: | :---------------: | :-------------------: | +| Alibaba | | ✓ | | | | | | +| BytePlus | | ✓ | | | | | | +| ComfyUI | ✓ | ✓ | ✓ | | | | | +| DeepInfra | ✓ | ✓ | | ✓ | ✓ | | ✓ | +| Deepgram | | | | | ✓ | ✓ | | +| ElevenLabs | | | | ✓ | ✓ | | | +| fal | ✓ | ✓ | | | | | | +| Google | ✓ | ✓ | ✓ | ✓ | | ✓ | ✓ | +| Gradium | | | | ✓ | | | | +| Local CLI | | | | ✓ | | | | +| Microsoft | | | | ✓ | | | | +| MiniMax | ✓ | ✓ | ✓ | ✓ | | | | +| Mistral | | | | | ✓ | | | +| OpenAI | ✓ | ✓ | | ✓ | ✓ | ✓ | ✓ | +| OpenRouter | ✓ | ✓ | | ✓ | | | ✓ | +| Qwen | | ✓ | | | | | | +| Runway | | ✓ | | | | | | +| SenseAudio | | | | | ✓ | | | +| Together | | ✓ | | | | | | +| Vydra | ✓ | ✓ | | ✓ | | | | +| xAI | ✓ | ✓ | | ✓ | ✓ | | ✓ | +| Xiaomi MiMo | ✓ | | | ✓ | | | ✓ | -A compreensão de mídia usa qualquer modelo com capacidade de visão ou áudio registrado -na sua configuração de provedor. A matriz acima lista provedores com suporte -dedicado de compreensão de mídia; a maioria dos provedores de LLM multimodal (Anthropic, Google, +O entendimento de mídia usa qualquer modelo com capacidade de visão ou áudio registrado +na configuração do seu provedor. A matriz acima lista provedores com suporte dedicado +a entendimento de mídia; a maioria dos provedores de LLM multimodais (Anthropic, Google, OpenAI etc.) também consegue entender mídia recebida quando configurada como o modelo de resposta ativo. ## Assíncrono vs. síncrono -| Recurso | Modo | Motivo | -| ---------------- | ----------- | ----------------------------------------------------------------- | -| Imagem | Síncrono | Respostas do provedor retornam em segundos; conclui junto com a resposta. | -| Síntese de fala | Síncrono | Respostas do provedor retornam em segundos; anexadas ao áudio da resposta. | -| Vídeo | Assíncrono | O processamento do provedor leva de 30 s a vários minutos. | -| Música (compartilhado) | Assíncrono | Mesma característica de processamento do provedor que vídeo. | -| Música (ComfyUI) | Síncrono | O workflow local executa junto com o servidor ComfyUI configurado. | +| Recurso | Modo | Motivo | +| ---------------- | ------------ | ---------------------------------------------------------------------------------------------------- | +| Imagem | Síncrono | As respostas do provedor retornam em segundos; conclui junto com a resposta. | +| Texto para fala | Síncrono | As respostas do provedor retornam em segundos; anexadas ao áudio da resposta. | +| Vídeo | Assíncrono | O processamento do provedor leva de 30 s a vários minutos; filas lentas podem rodar até o timeout configurado. | +| Música (compartilhada) | Assíncrono | Mesma característica de processamento do provedor que vídeo. | +| Música (ComfyUI) | Síncrono | O workflow local roda de forma inline contra o servidor ComfyUI configurado. | -Para ferramentas assíncronas, o OpenClaw envia a solicitação ao provedor, retorna um id de tarefa -imediatamente e acompanha o job no livro-razão de tarefas. O agente continua -respondendo a outras mensagens enquanto o job executa. Quando o provedor termina, +Para ferramentas assíncronas, o OpenClaw envia a solicitação ao provedor, retorna um id +de tarefa imediatamente e acompanha o job no ledger de tarefas. O agente continua +respondendo a outras mensagens enquanto o job roda. Quando o provedor termina, o OpenClaw desperta o agente com os caminhos da mídia gerada para que ele possa avisar o usuário e, quando exigido pela política de entrega da origem, retransmitir o resultado pela ferramenta de mensagem. Para rotas de grupo/canal somente com ferramenta de mensagem, o OpenClaw trata -evidência ausente de entrega por ferramenta de mensagem como uma tentativa de conclusão com falha e envia -o fallback da mídia gerada diretamente ao canal original. +a ausência de evidência de entrega pela ferramenta de mensagem como uma tentativa de conclusão com falha e envia +o fallback de mídia gerada diretamente ao canal original. -## Transcrição de fala e Chamada de voz +## Fala para texto e chamada de voz Deepgram, DeepInfra, ElevenLabs, Mistral, OpenAI, SenseAudio e xAI conseguem transcrever áudio recebido pelo caminho em lote `tools.media.audio` quando configurados. -Plugins de canal que fazem preflight de uma nota de voz para controle de menção ou análise de -comando marcam o anexo transcrito no contexto recebido, para que a etapa compartilhada de -compreensão de mídia reutilize essa transcrição em vez de fazer uma segunda -chamada de STT para o mesmo áudio. +Plugins de canal que fazem preflight de uma nota de voz para controle de menções ou análise de +comandos marcam o anexo transcrito no contexto recebido, para que a etapa compartilhada de +entendimento de mídia reutilize essa transcrição em vez de fazer uma segunda +chamada STT para o mesmo áudio. -Deepgram, ElevenLabs, Mistral, OpenAI e xAI também registram provedores de STT por -streaming de Chamada de voz, para que áudio telefônico ao vivo possa ser encaminhado ao fornecedor -selecionado sem esperar por uma gravação concluída. +Deepgram, ElevenLabs, Mistral, OpenAI e xAI também registram provedores de STT por streaming +de chamada de voz, para que áudio telefônico ao vivo possa ser encaminhado ao fornecedor selecionado +sem aguardar uma gravação concluída. -## Mapeamentos de provedores (como fornecedores se dividem entre superfícies) +## Mapeamentos de provedores (como os fornecedores se dividem entre superfícies) Superfícies de imagem, vídeo, música, TTS em lote, voz em tempo real de backend e - compreensão de mídia. + entendimento de mídia. - Superfícies de imagem, vídeo, TTS em lote, STT em lote, STT por streaming de Chamada de voz, voz em tempo real de backend + Superfícies de imagem, vídeo, TTS em lote, STT em lote, STT por streaming de chamada de voz, voz em tempo real de backend e embeddings de memória. Superfícies de roteamento de chat/modelo, geração/edição de imagens, texto para vídeo, TTS em lote, - STT em lote, compreensão de mídia de imagem e embeddings de memória. - Modelos nativos da DeepInfra de rerank/classificação/detecção de objetos não são + STT em lote, entendimento de mídia de imagem e embeddings de memória. + Modelos nativos da DeepInfra de reranqueamento/classificação/detecção de objetos não são registrados até que o OpenClaw tenha contratos de provedor dedicados para essas categorias. - Imagem, vídeo, busca, execução de código, TTS em lote, STT em lote e STT por streaming de Chamada de voz. - A voz em tempo real da xAI é um recurso upstream, mas não é - registrada no OpenClaw até que o contrato compartilhado de voz em tempo real consiga - representá-la. + Imagem, vídeo, busca, execução de código, TTS em lote, STT em lote e STT por streaming de chamada de voz. + Voz em tempo real da xAI é um recurso upstream, mas não é + registrado no OpenClaw até que o contrato compartilhado de voz em tempo real possa + representá-lo. @@ -148,6 +148,6 @@ selecionado sem esperar por uma gravação concluída. - [Geração de imagens](/pt-BR/tools/image-generation) - [Geração de vídeos](/pt-BR/tools/video-generation) - [Geração de música](/pt-BR/tools/music-generation) -- [Síntese de fala](/pt-BR/tools/tts) -- [Compreensão de mídia](/pt-BR/nodes/media-understanding) +- [Texto para fala](/pt-BR/tools/tts) +- [Entendimento de mídia](/pt-BR/nodes/media-understanding) - [Nós de áudio](/pt-BR/nodes/audio) diff --git a/docs/pt-BR/tools/slash-commands.md b/docs/pt-BR/tools/slash-commands.md index eed437d05..b571010ca 100644 --- a/docs/pt-BR/tools/slash-commands.md +++ b/docs/pt-BR/tools/slash-commands.md @@ -1,42 +1,42 @@ --- read_when: - - Usando ou configurando comandos de chat - - Depuração de roteamento de comandos ou permissões + - Usar ou configurar comandos de chat + - Depuração do roteamento de comandos ou das permissões sidebarTitle: Slash commands -summary: 'Comandos de barra: texto versus nativo, configuração e comandos compatíveis' +summary: 'Comandos de barra: texto vs nativos, configuração e comandos compatíveis' title: Comandos de barra x-i18n: - generated_at: "2026-05-04T05:55:26Z" + generated_at: "2026-05-05T06:15:55Z" model: gpt-5.5 provider: openai - source_hash: 49eb41674c8d0a01dbd28a2df783eb9aba3dde18d8425951a266cede825e9a84 + source_hash: 8a0234bd94cafe242fc692a5b9d457047e483e2a434cc92ab26046e6ddec55ce source_path: tools/slash-commands.md workflow: 16 --- -Os comandos são gerenciados pelo Gateway. A maioria dos comandos deve ser enviada como uma mensagem **independente** que começa com `/`. O comando de chat bash somente do host usa `! ` (com `/bash ` como alias). +Os comandos são tratados pelo Gateway. A maioria dos comandos deve ser enviada como uma mensagem **independente** que começa com `/`. O comando de chat bash somente do host usa `! ` (com `/bash ` como alias). -Quando uma conversa ou thread está vinculada a uma sessão ACP, o texto normal de acompanhamento é roteado para esse harness ACP. Os comandos de gerenciamento do Gateway ainda permanecem locais: `/acp ...` sempre chega ao manipulador de comandos ACP do OpenClaw, e `/status` mais `/unfocus` permanecem locais sempre que o gerenciamento de comandos está habilitado para a superfície. +Quando uma conversa ou thread está vinculada a uma sessão ACP, o texto normal de acompanhamento é roteado para esse harness ACP. Os comandos de gerenciamento do Gateway continuam locais: `/acp ...` sempre chega ao manipulador de comandos ACP do OpenClaw, e `/status` mais `/unfocus` permanecem locais sempre que o tratamento de comandos está habilitado para a superfície. Há dois sistemas relacionados: - + Mensagens `/...` independentes. - + `/think`, `/fast`, `/verbose`, `/trace`, `/reasoning`, `/elevated`, `/exec`, `/model`, `/queue`. - - As diretivas são removidas da mensagem antes que o modelo a veja. - - Em mensagens normais de chat (não apenas diretivas), elas são tratadas como "dicas inline" e **não** persistem as configurações da sessão. - - Em mensagens somente de diretivas (a mensagem contém apenas diretivas), elas persistem na sessão e respondem com uma confirmação. - - As diretivas só são aplicadas para **remetentes autorizados**. Se `commands.allowFrom` estiver definido, ele é a única lista de permissões usada; caso contrário, a autorização vem das listas de permissões/pareamento do canal mais `commands.useAccessGroups`. Remetentes não autorizados veem as diretivas tratadas como texto simples. + - As diretivas são removidas da mensagem antes de o modelo vê-la. + - Em mensagens de chat normais (não apenas diretivas), elas são tratadas como "dicas inline" e **não** persistem as configurações da sessão. + - Em mensagens somente com diretivas (a mensagem contém apenas diretivas), elas persistem na sessão e respondem com uma confirmação. + - Diretivas são aplicadas apenas para **remetentes autorizados**. Se `commands.allowFrom` estiver definido, ele será a única lista de permissão usada; caso contrário, a autorização vem das listas de permissão/pareamento do canal mais `commands.useAccessGroups`. Remetentes não autorizados veem as diretivas tratadas como texto simples. - - Apenas remetentes em lista de permissões/autorizados: `/help`, `/commands`, `/status`, `/whoami` (`/id`). + + Apenas remetentes permitidos/autorizados: `/help`, `/commands`, `/status`, `/whoami` (`/id`). - Eles são executados imediatamente, são removidos antes que o modelo veja a mensagem, e o texto restante continua pelo fluxo normal. + Eles são executados imediatamente, são removidos antes de o modelo ver a mensagem, e o texto restante continua pelo fluxo normal. @@ -69,20 +69,20 @@ Há dois sistemas relacionados: ``` - Habilita a análise de `/...` em mensagens de chat. Em superfícies sem comandos nativos (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams), comandos de texto ainda funcionam mesmo se você definir isto como `false`. + Habilita o parsing de `/...` em mensagens de chat. Em superfícies sem comandos nativos (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams), comandos de texto ainda funcionam mesmo que você defina isto como `false`. - Registra comandos nativos. Auto: ativado para Discord/Telegram; desativado para Slack (até você adicionar comandos de barra); ignorado para provedores sem suporte nativo. Defina `channels.discord.commands.native`, `channels.telegram.commands.native` ou `channels.slack.commands.native` para sobrescrever por provedor (bool ou `"auto"`). No Discord, `false` ignora o registro de comandos de barra e a limpeza durante a inicialização; comandos registrados anteriormente podem permanecer visíveis até você removê-los do app do Discord. Comandos do Slack são gerenciados no app do Slack e não são removidos automaticamente. + Registra comandos nativos. Auto: ativado para Discord/Telegram; desativado para Slack (até você adicionar comandos slash); ignorado para provedores sem suporte nativo. Defina `channels.discord.commands.native`, `channels.telegram.commands.native` ou `channels.slack.commands.native` para substituir por provedor (bool ou `"auto"`). No Discord, `false` ignora o registro e a limpeza de comandos slash durante a inicialização; comandos registrados anteriormente podem permanecer visíveis até você removê-los do app do Discord. Comandos do Slack são gerenciados no app do Slack e não são removidos automaticamente. -No Discord, as especificações de comandos nativos podem incluir `descriptionLocalizations`, que o OpenClaw publica como `description_localizations` do Discord e inclui nas comparações de reconciliação. +No Discord, especificações de comandos nativos podem incluir `descriptionLocalizations`, que o OpenClaw publica como `description_localizations` do Discord e inclui nas comparações de reconciliação. - Registra comandos de **skill** nativamente quando houver suporte. Auto: ativado para Discord/Telegram; desativado para Slack (o Slack exige a criação de um comando de barra por skill). Defina `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` ou `channels.slack.commands.nativeSkills` para sobrescrever por provedor (bool ou `"auto"`). + Registra comandos de **skill** nativamente quando houver suporte. Auto: ativado para Discord/Telegram; desativado para Slack (o Slack exige a criação de um comando slash por skill). Defina `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` ou `channels.slack.commands.nativeSkills` para substituir por provedor (bool ou `"auto"`). - Habilita `! ` para executar comandos de shell do host (`/bash ` é um alias; requer listas de permissões `tools.elevated`). + Habilita `! ` para executar comandos de shell do host (`/bash ` é um alias; requer listas de permissão `tools.elevated`). - Controla por quanto tempo o bash espera antes de alternar para o modo em segundo plano (`0` envia imediatamente para segundo plano). + Controla por quanto tempo o bash espera antes de alternar para o modo em segundo plano (`0` coloca em segundo plano imediatamente). Habilita `/config` (lê/grava `openclaw.json`). @@ -91,19 +91,19 @@ No Discord, as especificações de comandos nativos podem incluir `descriptionLo Habilita `/mcp` (lê/grava a configuração MCP gerenciada pelo OpenClaw em `mcp.servers`). - Habilita `/plugins` (descoberta/status de Plugin mais controles de instalação e ativação/desativação). + Habilita `/plugins` (descoberta/status de plugins mais controles de instalação e ativação/desativação). - Habilita `/debug` (sobrescritas somente em runtime). + Habilita `/debug` (substituições somente em runtime). - Habilita `/restart` mais ações de ferramenta para reiniciar o Gateway. + Habilita `/restart` mais ações de ferramenta para reiniciar o gateway. - Define a lista explícita de permissões de proprietário para superfícies de comando/ferramenta somente de proprietário. Esta é a conta do operador humano que pode aprovar ações perigosas e executar comandos como `/diagnostics`, `/export-trajectory` e `/config`. Ela é separada de `commands.allowFrom` e do acesso por pareamento de DM. + Define a lista de permissão explícita de proprietário para superfícies de comando/ferramenta somente de proprietário. Esta é a conta do operador humano que pode aprovar ações perigosas e executar comandos como `/diagnostics`, `/export-trajectory` e `/config`. Ela é separada de `commands.allowFrom` e do acesso de pareamento por DM. - Por canal: faz com que comandos somente de proprietário exijam **identidade de proprietário** para serem executados nessa superfície. Quando `true`, o remetente deve corresponder a um candidato de proprietário resolvido (por exemplo, uma entrada em `commands.ownerAllowFrom` ou metadados de proprietário nativos do provedor) ou ter escopo interno `operator.admin` em um canal interno de mensagens. Uma entrada curinga em `allowFrom` do canal, ou uma lista vazia/não resolvida de candidatos a proprietário, **não** é suficiente — comandos somente de proprietário falham de forma fechada nesse canal. Deixe isto desativado se você quiser que comandos somente de proprietário sejam protegidos apenas por `ownerAllowFrom` e pelas listas de permissões padrão de comandos. + Por canal: faz com que comandos somente de proprietário exijam **identidade de proprietário** para serem executados nessa superfície. Quando `true`, o remetente deve corresponder a um candidato a proprietário resolvido (por exemplo, uma entrada em `commands.ownerAllowFrom` ou metadados de proprietário nativos do provedor) ou ter o escopo interno `operator.admin` em um canal de mensagens interno. Uma entrada curinga em `allowFrom` do canal, ou uma lista vazia/não resolvida de candidatos a proprietário, **não** é suficiente — comandos somente de proprietário falham fechados nesse canal. Deixe isto desativado se você quiser que comandos somente de proprietário sejam protegidos apenas por `ownerAllowFrom` e pelas listas de permissão de comandos padrão. Controla como ids de proprietário aparecem no prompt do sistema. @@ -112,65 +112,65 @@ No Discord, as especificações de comandos nativos podem incluir `descriptionLo Opcionalmente define o segredo HMAC usado quando `commands.ownerDisplay="hash"`. - Lista de permissões por provedor para autorização de comandos. Quando configurada, ela é a única fonte de autorização para comandos e diretivas (listas de permissões/pareamento de canal e `commands.useAccessGroups` são ignorados). Use `"*"` para um padrão global; chaves específicas de provedor o sobrescrevem. + Lista de permissão por provedor para autorização de comandos. Quando configurada, ela é a única fonte de autorização para comandos e diretivas (listas de permissão/pareamento de canais e `commands.useAccessGroups` são ignorados). Use `"*"` para um padrão global; chaves específicas de provedor o substituem. - Aplica listas de permissões/políticas para comandos quando `commands.allowFrom` não está definido. + Impõe listas de permissão/políticas para comandos quando `commands.allowFrom` não está definido. ## Lista de comandos Fonte da verdade atual: -- comandos integrados principais vêm de `src/auto-reply/commands-registry.shared.ts` -- comandos dock gerados vêm de `src/auto-reply/commands-registry.data.ts` -- comandos de Plugin vêm de chamadas `registerCommand()` de Plugin -- a disponibilidade real no seu gateway ainda depende de flags de configuração, superfície de canal e Plugins instalados/habilitados +- comandos internos do core vêm de `src/auto-reply/commands-registry.shared.ts` +- comandos de dock gerados vêm de `src/auto-reply/commands-registry.data.ts` +- comandos de plugins vêm de chamadas `registerCommand()` de plugins +- a disponibilidade real no seu gateway ainda depende de flags de configuração, superfície do canal e plugins instalados/habilitados -### Comandos integrados principais +### Comandos internos do core - + - `/new [model]` inicia uma nova sessão; `/reset` é o alias de redefinição. - - A Control UI intercepta `/new` digitado para criar e alternar para uma nova sessão de dashboard; `/reset` digitado ainda executa a redefinição in-place do Gateway. - - `/reset soft [message]` mantém a transcrição atual, descarta ids de sessão reutilizados do backend CLI e executa novamente o carregamento de inicialização/prompt do sistema in-place. + - A Control UI intercepta `/new` digitado para criar e alternar para uma nova sessão de dashboard; `/reset` digitado ainda executa a redefinição no local do Gateway. + - `/reset soft [message]` mantém a transcrição atual, descarta ids de sessão de backend CLI reutilizados e reexecuta o carregamento de inicialização/prompt do sistema no local. - `/compact [instructions]` compacta o contexto da sessão. Consulte [Compaction](/pt-BR/concepts/compaction). - `/stop` aborta a execução atual. - - `/session idle ` e `/session max-age ` gerenciam a expiração de vínculo de thread. + - `/session idle ` e `/session max-age ` gerenciam a expiração do vínculo de thread. - `/export-session [path]` exporta a sessão atual para HTML. Alias: `/export`. - - `/export-trajectory [path]` solicita aprovação de exec e depois exporta um [pacote de trajetória](/pt-BR/tools/trajectory) JSONL para a sessão atual. Use quando precisar da linha do tempo de prompt, ferramenta e transcrição para uma sessão do OpenClaw. Em chats de grupo, o prompt de aprovação e o resultado da exportação vão para o proprietário em privado. Alias: `/trajectory`. + - `/export-trajectory [path]` solicita aprovação de exec e, em seguida, exporta um [pacote de trajetória](/pt-BR/tools/trajectory) JSONL para a sessão atual. Use-o quando você precisar da linha do tempo de prompt, ferramenta e transcrição para uma sessão do OpenClaw. Em chats de grupo, o prompt de aprovação e o resultado da exportação vão para o proprietário em privado. Alias: `/trajectory`. - - - `/think ` define o nível de pensamento. As opções vêm do perfil de provedor do modelo ativo; níveis comuns são `off`, `minimal`, `low`, `medium` e `high`, com níveis personalizados como `xhigh`, `adaptive`, `max` ou binário `on` apenas onde houver suporte. Aliases: `/thinking`, `/t`. + + - `/think ` define o nível de raciocínio. As opções vêm do perfil de provedor do modelo ativo; níveis comuns são `off`, `minimal`, `low`, `medium` e `high`, com níveis personalizados como `xhigh`, `adaptive`, `max` ou binário `on` apenas onde houver suporte. Aliases: `/thinking`, `/t`. - `/verbose on|off|full` alterna a saída detalhada. Alias: `/v`. - - `/trace on|off` alterna a saída de trace de Plugin para a sessão atual. + - `/trace on|off` alterna a saída de trace de plugin para a sessão atual. - `/fast [status|on|off]` mostra ou define o modo rápido. - `/reasoning [on|off|stream]` alterna a visibilidade do raciocínio. Alias: `/reason`. - `/elevated [on|off|ask|full]` alterna o modo elevado. Alias: `/elev`. - - `/exec host= security= ask= node=` mostra ou define os padrões de exec. + - `/exec host= security= ask= node=` mostra ou define padrões de exec. - `/model [name|#|status]` mostra ou define o modelo. - - `/models [provider] [page] [limit=|size=|all]` lista provedores configurados/disponíveis por autenticação ou modelos de um provedor; adicione `all` para navegar pelo catálogo completo desse provedor. - - `/queue ` gerencia o comportamento da fila (`steer`, `queue` legado, `followup`, `collect`, `steer-backlog`, `interrupt`) mais opções como `debounce:0.5s cap:25 drop:summarize`; `/queue default` ou `/queue reset` limpa a sobrescrita da sessão. Consulte [Fila de comandos](/pt-BR/concepts/queue) e [Fila de direcionamento](/pt-BR/concepts/queue-steering). - - `/steer ` injeta orientação na execução ativa para a sessão atual, independentemente do modo `/queue`. Ele não inicia uma nova execução quando a sessão está ociosa. Alias: `/tell`. Consulte [Steer](/pt-BR/tools/steer). + - `/models [provider] [page] [limit=|size=|all]` lista provedores ou modelos configurados/com autenticação disponível para um provedor; adicione `all` para navegar pelo catálogo completo desse provedor. + - `/queue ` gerencia o comportamento da fila (`steer`, legado `queue`, `followup`, `collect`, `steer-backlog`, `interrupt`) mais opções como `debounce:0.5s cap:25 drop:summarize`; `/queue default` ou `/queue reset` limpa a substituição da sessão. Consulte [Fila de comandos](/pt-BR/concepts/queue) e [Fila de direcionamento](/pt-BR/concepts/queue-steering). + - `/steer ` injeta orientação na execução ativa para a sessão atual, independentemente do modo `/queue`. Ele não inicia uma nova execução quando a sessão está ociosa. Alias: `/tell`. Consulte [Direcionar](/pt-BR/tools/steer). - + - `/help` mostra o resumo curto de ajuda. - `/commands` mostra o catálogo de comandos gerado. - `/tools [compact|verbose]` mostra o que o agente atual pode usar agora. - - `/status` mostra o status de execução/runtime, incluindo rótulos `Execution`/`Runtime` e uso/cota de provedor quando disponível. - - `/diagnostics [note]` é o fluxo de relatório de suporte somente de proprietário para bugs do Gateway e execuções do harness Codex. Ele solicita aprovação explícita de exec todas as vezes antes de executar `openclaw gateway diagnostics export --json`; não aprove diagnósticos com uma regra allow-all. Após a aprovação, ele envia um relatório colável com o caminho do pacote local, resumo do manifesto, notas de privacidade e ids de sessão relevantes. Em chats de grupo, o prompt de aprovação e o relatório vão para o proprietário em privado. Quando a sessão ativa usa o harness OpenAI Codex, a mesma aprovação também envia feedback relevante do Codex para servidores da OpenAI e a resposta concluída lista os ids de sessão do OpenClaw, ids de thread do Codex e comandos `codex resume `. Consulte [Exportação de Diagnósticos](/pt-BR/gateway/diagnostics). + - `/status` mostra status de execução/runtime, uptime do Gateway e do sistema, além de uso/cota do provedor quando disponível. + - `/diagnostics [note]` é o fluxo de relatório de suporte somente do proprietário para bugs do Gateway e execuções do harness Codex. Ele solicita aprovação explícita de exec todas as vezes antes de executar `openclaw gateway diagnostics export --json`; não aprove diagnósticos com uma regra de permitir tudo. Após a aprovação, ele envia um relatório colável com o caminho do pacote local, resumo do manifesto, notas de privacidade e ids de sessão relevantes. Em chats de grupo, o prompt de aprovação e o relatório vão para o proprietário em privado. Quando a sessão ativa usa o harness OpenAI Codex, a mesma aprovação também envia feedback relevante do Codex para servidores da OpenAI, e a resposta concluída lista os ids de sessão do OpenClaw, ids de thread do Codex e comandos `codex resume `. Consulte [Exportação de diagnósticos](/pt-BR/gateway/diagnostics). - `/crestodian ` executa o auxiliar de configuração e reparo Crestodian a partir de uma DM do proprietário. - `/tasks` lista tarefas em segundo plano ativas/recentes para a sessão atual. - `/context [list|detail|json]` explica como o contexto é montado. - `/whoami` mostra seu id de remetente. Alias: `/id`. - - `/usage off|tokens|full|cost` controla o rodapé de uso por resposta ou imprime um resumo local de custos. + - `/usage off|tokens|full|cost` controla o rodapé de uso por resposta ou imprime um resumo local de custo. - - - `/skill [input]` executa uma skill pelo nome. - - `/allowlist [list|add|remove] ...` gerencia entradas da lista de permissões. Somente texto. + + - `/skill [input]` executa uma skill por nome. + - `/allowlist [list|add|remove] ...` gerencia entradas da lista de permissão. Somente texto. - `/approve ` resolve prompts de aprovação de exec. - `/btw ` faz uma pergunta paralela sem alterar o contexto futuro da sessão. Alias: `/side`. Consulte [BTW](/pt-BR/tools/btw). @@ -178,59 +178,61 @@ Fonte da verdade atual: - `/subagents list|kill|log|info|send|steer|spawn` gerencia execuções de subagentes para a sessão atual. - `/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help` gerencia sessões ACP e opções de runtime. - - `/focus ` vincula a thread atual do Discord ou o tópico/conversa do Telegram a um destino de sessão. + - `/focus ` vincula o thread atual do Discord ou o tópico/conversa do Telegram a um destino de sessão. - `/unfocus` remove o vínculo atual. - - `/agents` lista agentes vinculados à thread para a sessão atual. - - `/kill ` aborta um ou todos os subagentes em execução. - - `/subagents steer ` envia orientação para um subagente em execução. Consulte [Orientar](/pt-BR/tools/steer). + - `/agents` lista agentes vinculados ao thread para a sessão atual. + - `/kill ` interrompe um ou todos os subagentes em execução. + - `/subagents steer ` envia direcionamento para um subagente em execução. Consulte [Direcionar](/pt-BR/tools/steer). - - - `/config show|get|set|unset` lê ou grava `openclaw.json`. Somente pelo owner. Requer `commands.config: true`. - - `/mcp show|get|set|unset` lê ou grava a configuração de servidor MCP gerenciada pelo OpenClaw em `mcp.servers`. Somente pelo owner. Requer `commands.mcp: true`. - - `/plugins list|inspect|show|get|install|enable|disable` inspeciona ou altera o estado de plugins. `/plugin` é um alias. Somente pelo owner para gravações. Requer `commands.plugins: true`. - - `/debug show|set|unset|reset` gerencia substituições de configuração somente de runtime. Somente pelo owner. Requer `commands.debug: true`. + + - `/config show|get|set|unset` lê ou grava `openclaw.json`. Somente proprietário. Exige `commands.config: true`. + - `/mcp show|get|set|unset` lê ou grava a configuração de servidor MCP gerenciada pelo OpenClaw em `mcp.servers`. Somente proprietário. Exige `commands.mcp: true`. + - `/plugins list|inspect|show|get|install|enable|disable` inspeciona ou altera o estado de plugins. `/plugin` é um alias. Gravações somente pelo proprietário. Exige `commands.plugins: true`. + - `/debug show|set|unset|reset` gerencia substituições de configuração apenas de runtime. Somente proprietário. Exige `commands.debug: true`. - `/restart` reinicia o OpenClaw quando habilitado. Padrão: habilitado; defina `commands.restart: false` para desabilitar. - - `/send on|off|inherit` define a política de envio. Somente pelo owner. + - `/send on|off|inherit` define a política de envio. Somente proprietário. - + - `/tts on|off|status|chat|latest|provider|limit|summary|audio|help` controla TTS. Consulte [TTS](/pt-BR/tools/tts). - `/activation mention|always` define o modo de ativação em grupo. - - `/bash ` executa um comando shell no host. Somente texto. Alias: `! `. Requer `commands.bash: true` mais allowlists de `tools.elevated`. - - `!poll [sessionId]` verifica um job bash em segundo plano. - - `!stop [sessionId]` interrompe um job bash em segundo plano. + - `/bash ` executa um comando de shell do host. Somente texto. Alias: `! `. Exige `commands.bash: true` mais allowlists de `tools.elevated`. + - `!poll [sessionId]` verifica uma tarefa bash em segundo plano. + - `!stop [sessionId]` interrompe uma tarefa bash em segundo plano. -### Comandos dock gerados +### Comandos de encaixe gerados -Comandos dock alternam a rota de resposta da sessão atual para outro canal vinculado. Consulte [Ancoragem de canal](/pt-BR/concepts/channel-docking) para configuração, exemplos e solução de problemas. +Comandos de encaixe alternam a rota de resposta da sessão atual para outro +canal vinculado. Consulte [Encaixe de canais](/pt-BR/concepts/channel-docking) para configuração, +exemplos e solução de problemas. -Comandos dock são gerados a partir de plugins de canal com suporte a comandos nativos. Conjunto integrado atual: +Comandos de encaixe são gerados a partir de plugins de canal com suporte a comandos nativos. Conjunto empacotado atual: - `/dock-discord` (alias: `/dock_discord`) - `/dock-mattermost` (alias: `/dock_mattermost`) - `/dock-slack` (alias: `/dock_slack`) - `/dock-telegram` (alias: `/dock_telegram`) -Use comandos dock em um chat direto para alternar a rota de resposta da sessão atual para outro canal vinculado. O agente mantém o mesmo contexto de sessão, mas respostas futuras dessa sessão são entregues ao par de canal selecionado. +Use comandos de encaixe em uma conversa direta para alternar a rota de resposta da sessão atual para outro canal vinculado. O agente mantém o mesmo contexto de sessão, mas as respostas futuras dessa sessão são entregues ao par do canal selecionado. -Comandos dock exigem `session.identityLinks`. O remetente de origem e o par de destino devem estar no mesmo grupo de identidade, por exemplo `["telegram:123", "discord:456"]`. Se um usuário do Telegram com id `123` enviar `/dock_discord`, o OpenClaw armazena `lastChannel: "discord"` e `lastTo: "456"` na sessão ativa. Se o remetente não estiver vinculado a um par do Discord, o comando responde com uma dica de configuração em vez de cair no chat normal. +Comandos de encaixe exigem `session.identityLinks`. O remetente de origem e o par de destino devem estar no mesmo grupo de identidades, por exemplo `["telegram:123", "discord:456"]`. Se um usuário do Telegram com id `123` enviar `/dock_discord`, o OpenClaw armazena `lastChannel: "discord"` e `lastTo: "456"` na sessão ativa. Se o remetente não estiver vinculado a um par do Discord, o comando responde com uma dica de configuração em vez de seguir para o chat normal. -A ancoragem altera apenas a rota da sessão ativa. Ela não cria contas de canal, concede acesso, contorna allowlists de canal nem move o histórico de transcrição para outra sessão. Use `/dock-telegram`, `/dock-slack`, `/dock-mattermost` ou outro comando dock gerado para alternar a rota novamente. +O encaixe altera apenas a rota da sessão ativa. Ele não cria contas de canal, concede acesso, ignora allowlists de canais nem move o histórico de transcrição para outra sessão. Use `/dock-telegram`, `/dock-slack`, `/dock-mattermost` ou outro comando de encaixe gerado para alternar a rota novamente. -### Comandos de plugins integrados +### Comandos de plugins empacotados -Plugins integrados podem adicionar mais comandos de barra. Comandos integrados atuais neste repo: +Plugins empacotados podem adicionar mais comandos de barra. Comandos empacotados atuais neste repositório: -- `/dreaming [on|off|status|help]` alterna o dreaming de memória. Consulte [Dreaming](/pt-BR/concepts/dreaming). -- `/pair [qr|status|pending|approve|cleanup|notify]` gerencia o fluxo de pareamento/configuração de dispositivo. Consulte [Pareamento](/pt-BR/channels/pairing). -- `/phone status|arm [duration]|disarm` arma temporariamente comandos de node de telefone de alto risco. +- `/dreaming [on|off|status|help]` alterna Dreaming de memória. Consulte [Dreaming](/pt-BR/concepts/dreaming). +- `/pair [qr|status|pending|approve|cleanup|notify]` gerencia o fluxo de emparelhamento/configuração de dispositivos. Consulte [Emparelhamento](/pt-BR/channels/pairing). +- `/phone status|arm [duration]|disarm` arma temporariamente comandos de Node de telefone de alto risco. - `/voice status|list [limit]|set ` gerencia a configuração de voz do Talk. No Discord, o nome do comando nativo é `/talkvoice`. -- `/card ...` envia predefinições de rich card do LINE. Consulte [LINE](/pt-BR/channels/line). -- `/codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skills` inspeciona e controla o harness app-server integrado do Codex. Consulte [Harness do Codex](/pt-BR/plugins/codex-harness). +- `/card ...` envia predefinições de cartão rico do LINE. Consulte [LINE](/pt-BR/channels/line). +- `/codex status|models|threads|resume|compact|review|diagnostics|account|mcp|skills` inspeciona e controla o harness de servidor de app Codex empacotado. Consulte [Harness Codex](/pt-BR/plugins/codex-harness). - Comandos somente do QQBot: - `/bot-ping` - `/bot-version` @@ -238,67 +240,67 @@ Plugins integrados podem adicionar mais comandos de barra. Comandos integrados a - `/bot-upgrade` - `/bot-logs` -### Comandos de skill dinâmicos +### Comandos dinâmicos de Skills Skills invocáveis pelo usuário também são expostas como comandos de barra: - `/skill [input]` sempre funciona como o ponto de entrada genérico. -- skills também podem aparecer como comandos diretos, como `/prose`, quando a skill/plugin os registra. -- o registro nativo de comandos de skill é controlado por `commands.nativeSkills` e `channels..commands.nativeSkills`. -- especificações de comando podem fornecer `descriptionLocalizations` para superfícies nativas que aceitam descrições localizadas, incluindo Discord. +- Skills também podem aparecer como comandos diretos, como `/prose`, quando a skill/plugin os registra. +- o registro de comandos nativos de Skills é controlado por `commands.nativeSkills` e `channels..commands.nativeSkills`. +- especificações de comando podem fornecer `descriptionLocalizations` para superfícies nativas que dão suporte a descrições localizadas, incluindo Discord. - + - Comandos aceitam um `:` opcional entre o comando e os argumentos (por exemplo, `/think: high`, `/send: on`, `/help:`). - - `/new ` aceita um alias de modelo, `provider/model` ou um nome de provider (correspondência aproximada); se não houver correspondência, o texto será tratado como o corpo da mensagem. - - Para uma análise completa de uso por provider, use `openclaw status --usage`. + - `/new ` aceita um alias de modelo, `provider/model` ou um nome de provedor (correspondência aproximada); se não houver correspondência, o texto é tratado como o corpo da mensagem. + - Para o detalhamento completo de uso por provedor, use `openclaw status --usage`. - `/allowlist add|remove` exige `commands.config=true` e respeita `configWrites` do canal. - Em canais com várias contas, `/allowlist --account ` direcionado à configuração e `/config set channels..accounts....` também respeitam o `configWrites` da conta de destino. - - `/usage` controla o rodapé de uso por resposta; `/usage cost` imprime um resumo de custo local a partir dos logs de sessão do OpenClaw. - - `/restart` é habilitado por padrão; defina `commands.restart: false` para desabilitá-lo. - - `/plugins install ` aceita as mesmas especificações de plugin que `openclaw plugins install`: caminho local/archive, pacote npm, `git:` ou `clawhub:`, depois solicita uma reinicialização do Gateway porque os módulos de origem do plugin mudaram. - - `/plugins enable|disable` atualiza a configuração de plugin e aciona o recarregamento de plugin do Gateway para novas interações de agente. + - `/usage` controla o rodapé de uso por resposta; `/usage cost` imprime um resumo local de custos a partir dos logs de sessão do OpenClaw. + - `/restart` é habilitado por padrão; defina `commands.restart: false` para desabilitar. + - `/plugins install ` aceita as mesmas especificações de Plugin que `openclaw plugins install`: caminho/arquivo local, pacote npm, `git:` ou `clawhub:`, então solicita uma reinicialização do Gateway porque os módulos de origem do Plugin mudaram. + - `/plugins enable|disable` atualiza a configuração do Plugin e aciona o recarregamento de plugins do Gateway para novas interações do agente. - - - Comando nativo somente do Discord: `/vc join|leave|status` controla canais de voz (não disponível como texto). `join` exige uma guilda e um canal de voz/palco selecionado. Requer `channels.discord.voice` e comandos nativos. + + - Comando nativo somente do Discord: `/vc join|leave|status` controla canais de voz (não disponível como texto). `join` exige um servidor e canal de voz/palco selecionado. Exige `channels.discord.voice` e comandos nativos. - Comandos de vinculação de thread do Discord (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age`) exigem que vínculos efetivos de thread estejam habilitados (`session.threadBindings.enabled` e/ou `channels.discord.threadBindings.enabled`). - Referência de comandos ACP e comportamento de runtime: [Agentes ACP](/pt-BR/tools/acp-agents). - - - `/verbose` é destinado a depuração e visibilidade extra; mantenha **desligado** no uso normal. - - `/trace` é mais restrito que `/verbose`: revela apenas linhas de trace/debug pertencentes a plugins e mantém desligado o ruído verbose normal de ferramentas. - - `/fast on|off` persiste uma substituição de sessão. Use a opção `inherit` da UI de Sessões para limpá-la e voltar aos padrões de configuração. - - `/fast` é específico do provider: OpenAI/OpenAI Codex o mapeiam para `service_tier=priority` em endpoints nativos de Responses, enquanto solicitações públicas diretas à Anthropic, incluindo tráfego autenticado por OAuth enviado para `api.anthropic.com`, o mapeiam para `service_tier=auto` ou `standard_only`. Consulte [OpenAI](/pt-BR/providers/openai) e [Anthropic](/pt-BR/providers/anthropic). - - Resumos de falhas de ferramenta ainda são exibidos quando relevantes, mas o texto detalhado da falha só é incluído quando `/verbose` está `on` ou `full`. - - `/reasoning`, `/verbose` e `/trace` são arriscados em configurações de grupo: podem revelar raciocínio interno, saída de ferramentas ou diagnósticos de plugin que você não pretendia expor. Prefira mantê-los desligados, especialmente em chats em grupo. + + - `/verbose` serve para depuração e visibilidade extra; mantenha-o **desligado** no uso normal. + - `/trace` é mais restrito que `/verbose`: ele revela apenas linhas de trace/depuração de propriedade do Plugin e mantém desligada a verbosidade normal de ferramentas. + - `/fast on|off` persiste uma substituição de sessão. Use a opção `inherit` da UI de Sessões para limpá-la e voltar aos padrões da configuração. + - `/fast` é específico do provedor: OpenAI/OpenAI Codex o mapeiam para `service_tier=priority` em endpoints Responses nativos, enquanto solicitações públicas diretas da Anthropic, incluindo tráfego autenticado por OAuth enviado para `api.anthropic.com`, o mapeiam para `service_tier=auto` ou `standard_only`. Consulte [OpenAI](/pt-BR/providers/openai) e [Anthropic](/pt-BR/providers/anthropic). + - Resumos de falhas de ferramentas ainda são mostrados quando relevantes, mas o texto detalhado da falha só é incluído quando `/verbose` está `on` ou `full`. + - `/reasoning`, `/verbose` e `/trace` são arriscados em contextos de grupo: eles podem revelar raciocínio interno, saída de ferramentas ou diagnósticos de plugins que você não pretendia expor. Prefira deixá-los desligados, especialmente em chats de grupo. - `/model` persiste o novo modelo da sessão imediatamente. - Se o agente estiver ocioso, a próxima execução o usa imediatamente. - Se uma execução já estiver ativa, o OpenClaw marca uma troca ao vivo como pendente e só reinicia no novo modelo em um ponto limpo de nova tentativa. - - Se a atividade de ferramenta ou a saída de resposta já tiver começado, a troca pendente pode permanecer na fila até uma oportunidade posterior de nova tentativa ou até o próximo turno do usuário. + - Se a atividade de ferramentas ou a saída de resposta já tiver começado, a troca pendente pode permanecer na fila até uma oportunidade posterior de nova tentativa ou a próxima interação do usuário. - Na TUI local, `/crestodian [request]` retorna da TUI normal do agente para o Crestodian. Isso é separado do modo de resgate de canal de mensagens e não concede autoridade remota de configuração. - - **Caminho rápido:** mensagens somente de comando de remetentes na allowlist são tratadas imediatamente (contornam fila + modelo). - - **Gate por menção em grupo:** mensagens somente de comando de remetentes na allowlist contornam requisitos de menção. + - **Caminho rápido:** mensagens somente de comando de remetentes na allowlist são processadas imediatamente (ignora fila + modelo). + - **Bloqueio por menção em grupo:** mensagens somente de comando de remetentes na allowlist ignoram requisitos de menção. - **Atalhos inline (somente remetentes na allowlist):** certos comandos também funcionam quando incorporados em uma mensagem normal e são removidos antes que o modelo veja o texto restante. - Exemplo: `hey /status` aciona uma resposta de status, e o texto restante continua pelo fluxo normal. - Atualmente: `/help`, `/commands`, `/status`, `/whoami` (`/id`). - - Mensagens somente de comando não autorizadas são ignoradas silenciosamente, e tokens inline `/...` são tratados como texto simples. + - Mensagens somente de comando não autorizadas são ignoradas silenciosamente, e tokens inline `/...` são tratados como texto comum. - - - **Comandos de skill:** skills `user-invocable` são expostas como comandos de barra. Nomes são sanitizados para `a-z0-9_` (máx. 32 caracteres); colisões recebem sufixos numéricos (por exemplo, `_2`). - - `/skill [input]` executa uma skill pelo nome (útil quando limites de comando nativo impedem comandos por skill). - - Por padrão, comandos de skill são encaminhados ao modelo como uma solicitação normal. - - Skills podem declarar opcionalmente `command-dispatch: tool` para rotear o comando diretamente para uma ferramenta (determinístico, sem modelo). - - Exemplo: `/prose` (plugin OpenProse) — consulte [OpenProse](/pt-BR/prose). - - **Argumentos de comando nativo:** Discord usa autocomplete para opções dinâmicas (e menus de botão quando você omite argumentos obrigatórios). Telegram e Slack mostram um menu de botão quando um comando aceita escolhas e você omite o argumento. Escolhas dinâmicas são resolvidas em relação ao modelo da sessão de destino, então opções específicas de modelo, como níveis de `/think`, seguem a substituição de `/model` dessa sessão. + + - **Comandos de Skills:** Skills `user-invocable` são expostas como comandos de barra. Os nomes são sanitizados para `a-z0-9_` (máx. 32 caracteres); colisões recebem sufixos numéricos (por exemplo, `_2`). + - `/skill [input]` executa uma skill pelo nome (útil quando limites de comandos nativos impedem comandos por skill). + - Por padrão, comandos de Skills são encaminhados ao modelo como uma solicitação normal. + - Skills podem opcionalmente declarar `command-dispatch: tool` para rotear o comando diretamente para uma ferramenta (determinístico, sem modelo). + - Exemplo: `/prose` (Plugin OpenProse) — consulte [OpenProse](/pt-BR/prose). + - **Argumentos de comando nativo:** Discord usa preenchimento automático para opções dinâmicas (e menus de botões quando você omite argumentos obrigatórios). Telegram e Slack mostram um menu de botões quando um comando dá suporte a escolhas e você omite o argumento. Escolhas dinâmicas são resolvidas com base no modelo da sessão de destino, então opções específicas de modelo, como níveis de `/think`, seguem a substituição de `/model` dessa sessão. @@ -307,19 +309,19 @@ Skills invocáveis pelo usuário também são expostas como comandos de barra: `/tools` responde a uma pergunta de runtime, não a uma pergunta de configuração: **o que este agente pode usar agora nesta conversa**. -- O `/tools` padrão é compacto e otimizado para leitura rápida. +- O `/tools` padrão é compacto e otimizado para varredura rápida. - `/tools verbose` adiciona descrições curtas. -- Superfícies de comando nativo que aceitam argumentos expõem o mesmo seletor de modo que `compact|verbose`. -- Os resultados têm escopo de sessão, portanto alterar agente, canal, thread, autorização do remetente ou modelo pode alterar a saída. -- `/tools` inclui ferramentas realmente acessíveis em runtime, incluindo ferramentas core, ferramentas de plugins conectados e ferramentas pertencentes ao canal. +- Superfícies de comando nativo que dão suporte a argumentos expõem a mesma troca de modo como `compact|verbose`. +- Os resultados têm escopo de sessão, então alterar agente, canal, thread, autorização do remetente ou modelo pode alterar a saída. +- `/tools` inclui ferramentas que são realmente acessíveis em runtime, incluindo ferramentas principais, ferramentas de Plugin conectadas e ferramentas de propriedade do canal. -Para edição de perfil e substituições, use o painel Tools da Control UI ou superfícies de configuração/catálogo em vez de tratar `/tools` como um catálogo estático. +Para edição de perfil e substituições, use o painel Ferramentas da UI de Controle ou superfícies de configuração/catálogo em vez de tratar `/tools` como um catálogo estático. ## Superfícies de uso (o que aparece onde) -- **Uso/cota do provedor** (exemplo: "Claude 80% restante") aparece em `/status` para o provedor de modelo atual quando o rastreamento de uso está habilitado. OpenClaw normaliza as janelas do provedor para `% restante`; para MiniMax, campos percentuais somente de restante são invertidos antes da exibição, e respostas `model_remains` preferem a entrada do modelo de chat mais um rótulo de plano marcado com o modelo. -- **Linhas de tokens/cache** em `/status` podem recorrer à entrada de uso mais recente da transcrição quando o instantâneo da sessão ao vivo está esparso. Valores ao vivo existentes e diferentes de zero ainda prevalecem, e o fallback da transcrição também pode recuperar o rótulo do modelo de runtime ativo mais um total maior orientado a prompt quando os totais armazenados estão ausentes ou menores. -- **Execução vs runtime:** `/status` relata `Execution` para o caminho efetivo do sandbox e `Runtime` para quem está realmente executando a sessão: `OpenClaw Pi Default`, `OpenAI Codex`, um backend de CLI ou um backend de ACP. +- **Uso/cota do provedor** (exemplo: "Claude 80% restante") aparece em `/status` para o provedor do modelo atual quando o rastreamento de uso está habilitado. O OpenClaw normaliza as janelas do provedor para `% restante`; para MiniMax, campos percentuais somente de restante são invertidos antes da exibição, e respostas `model_remains` preferem a entrada do modelo de chat mais um rótulo de plano com tag de modelo. +- **Linhas de tokens/cache** em `/status` podem recorrer à entrada de uso mais recente da transcrição quando o snapshot da sessão em tempo real é esparso. Valores em tempo real não zero existentes ainda têm prioridade, e o fallback da transcrição também pode recuperar o rótulo do modelo de runtime ativo mais um total maior orientado a prompt quando os totais armazenados estão ausentes ou são menores. +- **Execução vs runtime:** `/status` relata `Execution` para o caminho efetivo do sandbox e `Runtime` para quem está realmente executando a sessão: `OpenClaw Pi Default`, `OpenAI Codex`, um backend de CLI ou um backend ACP. - **Tokens/custo por resposta** é controlado por `/usage off|tokens|full` (anexado às respostas normais). - `/model status` trata de **modelos/autenticação/endpoints**, não de uso. @@ -341,13 +343,13 @@ Exemplos: Observações: - `/model` e `/model list` mostram um seletor compacto e numerado (família do modelo + provedores disponíveis). -- No Discord, `/model` e `/models` abrem um seletor interativo com menus suspensos de provedor e modelo, além de uma etapa de envio. +- No Discord, `/model` e `/models` abrem um seletor interativo com menus suspensos de provedor e modelo, além de uma etapa de Enviar. - `/model <#>` seleciona a partir desse seletor (e prefere o provedor atual quando possível). -- `/model status` mostra a visualização detalhada, incluindo o endpoint do provedor configurado (`baseUrl`) e o modo de API (`api`) quando disponíveis. +- `/model status` mostra a visualização detalhada, incluindo o endpoint configurado do provedor (`baseUrl`) e o modo de API (`api`) quando disponíveis. ## Substituições de depuração -`/debug` permite definir substituições de configuração **somente em runtime** (memória, não disco). Somente proprietário. Desabilitado por padrão; habilite com `commands.debug: true`. +`/debug` permite definir substituições de configuração **somente de runtime** (memória, não disco). Somente proprietário. Desabilitado por padrão; habilite com `commands.debug: true`. Exemplos: @@ -360,12 +362,12 @@ Exemplos: ``` -As substituições se aplicam imediatamente a novas leituras de configuração, mas **não** gravam em `openclaw.json`. Use `/debug reset` para limpar todas as substituições e retornar à configuração em disco. +As substituições são aplicadas imediatamente a novas leituras de configuração, mas **não** são gravadas em `openclaw.json`. Use `/debug reset` para limpar todas as substituições e retornar à configuração em disco. ## Saída de rastreamento de Plugin -`/trace` permite alternar **linhas de rastreamento/depuração de Plugin com escopo de sessão** sem ativar o modo detalhado completo. +`/trace` permite alternar **linhas de rastreamento/depuração de Plugin com escopo de sessão** sem ativar o modo verboso completo. Exemplos: @@ -377,12 +379,12 @@ Exemplos: Observações: -- `/trace` sem argumento mostra o estado de rastreamento da sessão atual. +- `/trace` sem argumento mostra o estado atual de rastreamento da sessão. - `/trace on` habilita linhas de rastreamento de Plugin para a sessão atual. - `/trace off` as desabilita novamente. - Linhas de rastreamento de Plugin podem aparecer em `/status` e como uma mensagem diagnóstica de acompanhamento após a resposta normal do assistente. -- `/trace` não substitui `/debug`; `/debug` ainda gerencia substituições de configuração somente em runtime. -- `/trace` não substitui `/verbose`; a saída detalhada normal de ferramentas/status ainda pertence a `/verbose`. +- `/trace` não substitui `/debug`; `/debug` ainda gerencia substituições de configuração somente de runtime. +- `/trace` não substitui `/verbose`; a saída verbosa normal de ferramentas/status ainda pertence a `/verbose`. ## Atualizações de configuração @@ -404,7 +406,7 @@ A configuração é validada antes da gravação; alterações inválidas são r ## Atualizações de MCP -`/mcp` grava definições de servidores MCP gerenciadas pelo OpenClaw em `mcp.servers`. Somente proprietário. Desabilitado por padrão; habilite com `commands.mcp: true`. +`/mcp` grava definições de servidor MCP gerenciadas pelo OpenClaw em `mcp.servers`. Somente proprietário. Desabilitado por padrão; habilite com `commands.mcp: true`. Exemplos: @@ -416,7 +418,7 @@ Exemplos: ``` -`/mcp` armazena a configuração na configuração do OpenClaw, não em configurações de projeto pertencentes ao Pi. Adaptadores de runtime decidem quais transportes são realmente executáveis. +`/mcp` armazena a configuração na configuração do OpenClaw, não nas configurações de projeto pertencentes ao Pi. Adaptadores de runtime decidem quais transportes são realmente executáveis. ## Atualizações de Plugin @@ -434,10 +436,10 @@ Exemplos: ``` -- `/plugins list` e `/plugins show` usam descoberta real de Plugin no workspace atual mais a configuração em disco. -- `/plugins install` instala a partir de ClawHub, npm, git, diretórios locais e arquivos compactados. -- `/plugins enable|disable` atualiza apenas a configuração do Plugin; ele não instala nem desinstala Plugins. -- Alterações de habilitação e desabilitação recarregam a quente as superfícies de runtime de Plugin do Gateway para novas rodadas de agente; a instalação solicita uma reinicialização do Gateway porque os módulos-fonte do Plugin mudaram. +- `/plugins list` e `/plugins show` usam descoberta real de Plugins no workspace atual mais a configuração em disco. +- `/plugins install` instala a partir do ClawHub, npm, git, diretórios locais e arquivos compactados. +- `/plugins enable|disable` atualiza apenas a configuração de Plugin; não instala nem desinstala Plugins. +- Alterações de habilitação e desabilitação recarregam a quente as superfícies de runtime de Plugin do Gateway para novas interações do agente; a instalação solicita uma reinicialização do Gateway porque os módulos-fonte do Plugin foram alterados. @@ -449,12 +451,12 @@ Exemplos: - **Comandos nativos** usam sessões isoladas: - Discord: `agent::discord:slash:` - Slack: `agent::slack:slash:` (prefixo configurável via `channels.slack.slashCommand.sessionPrefix`) - - Telegram: `telegram:slash:` (direciona para a sessão de chat via `CommandTargetSessionKey`) - - **`/stop`** direciona para a sessão de chat ativa para que possa interromper a execução atual. + - Telegram: `telegram:slash:` (aponta para a sessão de chat via `CommandTargetSessionKey`) + - **`/stop`** aponta para a sessão de chat ativa para que ela possa abortar a execução atual. - `channels.slack.slashCommand` ainda é compatível com um único comando no estilo `/openclaw`. Se você habilitar `commands.native`, deverá criar um comando de barra do Slack por comando integrado (mesmos nomes de `/help`). Menus de argumentos de comando para Slack são entregues como botões efêmeros do Block Kit. + `channels.slack.slashCommand` ainda é compatível com um único comando no estilo `/openclaw`. Se você habilitar `commands.native`, deverá criar um comando de barra do Slack por comando integrado (mesmos nomes que `/help`). Menus de argumentos de comando para Slack são entregues como botões efêmeros do Block Kit. Exceção nativa do Slack: registre `/agentstatus` (não `/status`) porque o Slack reserva `/status`. O texto `/status` ainda funciona em mensagens do Slack. @@ -465,13 +467,13 @@ Exemplos: `/btw` é uma **pergunta paralela** rápida sobre a sessão atual. `/side` é um alias. -Diferente do chat normal: +Ao contrário do chat normal: - usa a sessão atual como contexto de fundo, - executa como uma chamada única separada **sem ferramentas**, - não altera o contexto futuro da sessão, - não é gravado no histórico de transcrição, -- é entregue como um resultado paralelo ao vivo em vez de uma mensagem normal do assistente. +- é entregue como um resultado paralelo em tempo real em vez de uma mensagem normal do assistente. Isso torna `/btw` útil quando você quer um esclarecimento temporário enquanto a tarefa principal continua em andamento. @@ -486,6 +488,6 @@ Consulte [Perguntas paralelas BTW](/pt-BR/tools/btw) para ver o comportamento co ## Relacionado -- [Criação de Skills](/pt-BR/tools/creating-skills) +- [Criando Skills](/pt-BR/tools/creating-skills) - [Skills](/pt-BR/tools/skills) - [Configuração de Skills](/pt-BR/tools/skills-config) diff --git a/docs/pt-BR/tools/video-generation.md b/docs/pt-BR/tools/video-generation.md index 20c443730..be3cec06f 100644 --- a/docs/pt-BR/tools/video-generation.md +++ b/docs/pt-BR/tools/video-generation.md @@ -1,33 +1,33 @@ --- read_when: - - Gerando vídeos por meio do agente - - Configurando provedores e modelos de geração de vídeo - - Compreendendo os parâmetros da ferramenta video_generate + - Gerando vídeos pelo agente + - Configuração de provedores e modelos de geração de vídeo + - Entendendo os parâmetros da ferramenta video_generate sidebarTitle: Video generation -summary: Gere vídeos via video_generate a partir de referências de texto, imagem ou vídeo em 16 serviços de provedores +summary: Gere vídeos por meio de video_generate a partir de referências de texto, imagem ou vídeo em 16 backends de provedores title: Geração de vídeo x-i18n: - generated_at: "2026-05-05T05:45:03Z" + generated_at: "2026-05-05T06:15:55Z" model: gpt-5.5 provider: openai - source_hash: 8fd0f7922787d14736e57c9b5ea895de5bb8e126b2c73a397845ee14e1829f0b + source_hash: a86a820cc9f27baf4b17954d7ded7c2b7ff9eb456e7e75c3b2e7a7653cd675fd source_path: tools/video-generation.md workflow: 16 --- -OpenClaw agents podem gerar vídeos a partir de prompts de texto, imagens de referência ou +Os agentes do OpenClaw podem gerar vídeos a partir de prompts de texto, imagens de referência ou vídeos existentes. Dezesseis backends de provedores são compatíveis, cada um com -diferentes opções de modelo, modos de entrada e conjuntos de recursos. O agent escolhe o +diferentes opções de modelo, modos de entrada e conjuntos de recursos. O agente escolhe o provedor certo automaticamente com base na sua configuração e nas chaves de API disponíveis. A ferramenta `video_generate` só aparece quando pelo menos um provedor de geração de vídeo -está disponível. Se você não a vir nas ferramentas do seu agent, defina uma +está disponível. Se você não a vir nas ferramentas do seu agente, defina uma chave de API de provedor ou configure `agents.defaults.videoGenerationModel`. -OpenClaw trata a geração de vídeo como três modos de runtime: +O OpenClaw trata a geração de vídeo como três modos de runtime: - `generate` — solicitações de texto para vídeo sem mídia de referência. - `imageToVideo` — a solicitação inclui uma ou mais imagens de referência. @@ -52,51 +52,51 @@ modo ativo antes do envio e informa os modos compatíveis em `action=list`. openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview" ``` - + > Gere um vídeo cinematográfico de 5 segundos de uma lagosta amigável surfando ao pôr do sol. - O agent chama `video_generate` automaticamente. Nenhuma lista de permissões de ferramentas - é necessária. + O agente chama `video_generate` automaticamente. Não é necessário colocar a ferramenta + em uma allowlist. ## Como a geração assíncrona funciona -A geração de vídeo é assíncrona. Quando o agent chama `video_generate` em uma +A geração de vídeo é assíncrona. Quando o agente chama `video_generate` em uma sessão: -1. OpenClaw envia a solicitação ao provedor e retorna imediatamente um ID de tarefa. -2. O provedor processa o trabalho em segundo plano (normalmente de 30 segundos a 5 minutos, dependendo do provedor e da resolução). -3. Quando o vídeo fica pronto, OpenClaw reativa a mesma sessão com um evento interno de conclusão. -4. O agent informa o usuário e anexa o vídeo finalizado. Em chats de grupo/canal - que usam entrega visível somente por ferramenta de mensagem, o agent retransmite o - resultado pela ferramenta de mensagem em vez de OpenClaw publicá-lo diretamente. +1. O OpenClaw envia a solicitação ao provedor e retorna imediatamente um id de tarefa. +2. O provedor processa o trabalho em segundo plano (normalmente de 30 segundos a vários minutos, dependendo do provedor e da resolução; provedores lentos baseados em fila podem executar até o tempo limite configurado). +3. Quando o vídeo fica pronto, o OpenClaw desperta a mesma sessão com um evento interno de conclusão. +4. O agente informa o usuário e anexa o vídeo finalizado. Em chats de grupo/canal + que usam entrega visível somente por ferramenta de mensagem, o agente retransmite o + resultado pela ferramenta de mensagem em vez de o OpenClaw publicá-lo diretamente. -Enquanto um trabalho está em andamento, chamadas duplicadas a `video_generate` na mesma -sessão retornam o status atual da tarefa em vez de iniciar outra +Enquanto um trabalho está em andamento, chamadas duplicadas de `video_generate` na mesma +sessão retornam o status da tarefa atual em vez de iniciar outra geração. Use `openclaw tasks list` ou `openclaw tasks show ` para verificar o progresso pela CLI. -Fora de execuções de agent com sessão (por exemplo, invocações diretas de ferramentas), -a ferramenta recorre à geração inline e retorna o caminho da mídia final +Fora de execuções de agente com sessão (por exemplo, invocações diretas de ferramenta), +a ferramenta volta para a geração inline e retorna o caminho final da mídia no mesmo turno. Arquivos de vídeo gerados são salvos no armazenamento de mídia gerenciado pelo OpenClaw quando -o provedor retorna bytes. O limite padrão de salvamento de vídeos gerados segue +o provedor retorna bytes. O limite padrão de salvamento de vídeo gerado segue o limite de mídia de vídeo, e `agents.defaults.mediaMaxMb` o aumenta para -renderizações maiores. Quando um provedor também retorna uma URL de saída hospedada, OpenClaw +renders maiores. Quando um provedor também retorna uma URL de saída hospedada, o OpenClaw pode entregar essa URL em vez de falhar a tarefa se a persistência local rejeitar um arquivo grande demais. ### Ciclo de vida da tarefa -| Estado | Significado | -| ----------- | --------------------------------------------------------------------------------------------------- | -| `queued` | Tarefa criada, aguardando o provedor aceitá-la. | -| `running` | O provedor está processando (normalmente de 30 segundos a 5 minutos, dependendo do provedor e da resolução). | -| `succeeded` | Vídeo pronto; o agent desperta e o publica na conversa. | -| `failed` | Erro ou timeout do provedor; o agent desperta com detalhes do erro. | +| Estado | Significado | +| ----------- | ------------------------------------------------------------------------------------------------------ | +| `queued` | Tarefa criada, aguardando o provedor aceitá-la. | +| `running` | O provedor está processando (normalmente de 30 segundos a vários minutos, dependendo do provedor e da resolução). | +| `succeeded` | Vídeo pronto; o agente desperta e o publica na conversa. | +| `failed` | Erro do provedor ou tempo limite; o agente desperta com detalhes do erro. | Verifique o status pela CLI: @@ -107,84 +107,84 @@ openclaw tasks cancel ``` Se uma tarefa de vídeo já estiver `queued` ou `running` para a sessão atual, -`video_generate` retorna o status da tarefa existente em vez de iniciar uma nova +`video_generate` retornará o status da tarefa existente em vez de iniciar uma nova tarefa. Use `action: "status"` para verificar explicitamente sem acionar uma nova geração. ## Provedores compatíveis -| Provedor | Modelo padrão | Texto | Ref. de imagem | Ref. de vídeo | Autenticação | -| --------------------- | ------------------------------ | :---: | --------------------------------------------------- | --------------------------------------------- | --------------------------------------- | -| Alibaba | `wan2.6-t2v` | ✓ | Sim (URL remota) | Sim (URL remota) | `MODELSTUDIO_API_KEY` | -| BytePlus (1.0) | `seedance-1-0-pro-250528` | ✓ | Até 2 imagens (somente modelos I2V; primeiro + último quadro) | — | `BYTEPLUS_API_KEY` | -| BytePlus Seedance 1.5 | `seedance-1-5-pro-251215` | ✓ | Até 2 imagens (primeiro + último quadro via função) | — | `BYTEPLUS_API_KEY` | -| BytePlus Seedance 2.0 | `dreamina-seedance-2-0-260128` | ✓ | Até 9 imagens de referência | Até 3 vídeos | `BYTEPLUS_API_KEY` | -| ComfyUI | `workflow` | ✓ | 1 imagem | — | `COMFY_API_KEY` ou `COMFY_CLOUD_API_KEY` | -| DeepInfra | `Pixverse/Pixverse-T2V` | ✓ | — | — | `DEEPINFRA_API_KEY` | -| fal | `fal-ai/minimax/video-01-live` | ✓ | 1 imagem; até 9 com Seedance referência para vídeo | Até 3 vídeos com Seedance referência para vídeo | `FAL_KEY` | -| Google | `veo-3.1-fast-generate-preview` | ✓ | 1 imagem | 1 vídeo | `GEMINI_API_KEY` | -| MiniMax | `MiniMax-Hailuo-2.3` | ✓ | 1 imagem | — | `MINIMAX_API_KEY` ou OAuth da MiniMax | -| OpenAI | `sora-2` | ✓ | 1 imagem | 1 vídeo | `OPENAI_API_KEY` | -| OpenRouter | `google/veo-3.1-fast` | ✓ | Até 4 imagens (primeiro/último quadro ou referências) | — | `OPENROUTER_API_KEY` | -| Qwen | `wan2.6-t2v` | ✓ | Sim (URL remota) | Sim (URL remota) | `QWEN_API_KEY` | -| Runway | `gen4.5` | ✓ | 1 imagem | 1 vídeo | `RUNWAYML_API_SECRET` | -| Together | `Wan-AI/Wan2.2-T2V-A14B` | ✓ | 1 imagem | — | `TOGETHER_API_KEY` | -| Vydra | `veo3` | ✓ | 1 imagem (`kling`) | — | `VYDRA_API_KEY` | -| xAI | `grok-imagine-video` | ✓ | 1 imagem de primeiro quadro ou até 7 `reference_image`s | 1 vídeo | `XAI_API_KEY` | +| Provedor | Modelo padrão | Texto | Ref. de imagem | Ref. de vídeo | Autenticação | +| --------------------- | ------------------------------- | :--: | ---------------------------------------------------- | ----------------------------------------------- | ---------------------------------------- | +| Alibaba | `wan2.6-t2v` | ✓ | Sim (URL remota) | Sim (URL remota) | `MODELSTUDIO_API_KEY` | +| BytePlus (1.0) | `seedance-1-0-pro-250528` | ✓ | Até 2 imagens (somente modelos I2V; primeiro + último quadro) | — | `BYTEPLUS_API_KEY` | +| BytePlus Seedance 1.5 | `seedance-1-5-pro-251215` | ✓ | Até 2 imagens (primeiro + último quadro via função) | — | `BYTEPLUS_API_KEY` | +| BytePlus Seedance 2.0 | `dreamina-seedance-2-0-260128` | ✓ | Até 9 imagens de referência | Até 3 vídeos | `BYTEPLUS_API_KEY` | +| ComfyUI | `workflow` | ✓ | 1 imagem | — | `COMFY_API_KEY` ou `COMFY_CLOUD_API_KEY` | +| DeepInfra | `Pixverse/Pixverse-T2V` | ✓ | — | — | `DEEPINFRA_API_KEY` | +| fal | `fal-ai/minimax/video-01-live` | ✓ | 1 imagem; até 9 com Seedance reference-to-video | Até 3 vídeos com Seedance reference-to-video | `FAL_KEY` | +| Google | `veo-3.1-fast-generate-preview` | ✓ | 1 imagem | 1 vídeo | `GEMINI_API_KEY` | +| MiniMax | `MiniMax-Hailuo-2.3` | ✓ | 1 imagem | — | `MINIMAX_API_KEY` ou OAuth da MiniMax | +| OpenAI | `sora-2` | ✓ | 1 imagem | 1 vídeo | `OPENAI_API_KEY` | +| OpenRouter | `google/veo-3.1-fast` | ✓ | Até 4 imagens (primeiro/último quadro ou referências) | — | `OPENROUTER_API_KEY` | +| Qwen | `wan2.6-t2v` | ✓ | Sim (URL remota) | Sim (URL remota) | `QWEN_API_KEY` | +| Runway | `gen4.5` | ✓ | 1 imagem | 1 vídeo | `RUNWAYML_API_SECRET` | +| Together | `Wan-AI/Wan2.2-T2V-A14B` | ✓ | 1 imagem | — | `TOGETHER_API_KEY` | +| Vydra | `veo3` | ✓ | 1 imagem (`kling`) | — | `VYDRA_API_KEY` | +| xAI | `grok-imagine-video` | ✓ | 1 imagem de primeiro quadro ou até 7 `reference_image`s | 1 vídeo | `XAI_API_KEY` | -Alguns provedores aceitam variáveis de ambiente de chave de API adicionais ou alternativas. Consulte -as [páginas de provedores](#related) individuais para obter detalhes. +Alguns provedores aceitam variáveis de ambiente de chave de API adicionais ou alternativas. Veja +as [páginas de provedores](#related) individuais para detalhes. Execute `video_generate action=list` para inspecionar provedores, modelos e -modos de runtime disponíveis em runtime. +modos de runtime disponíveis em tempo de execução. ### Matriz de capacidades -O contrato de modo explícito usado por `video_generate`, testes de contrato e -a varredura ao vivo compartilhada: +O contrato explícito de modo usado por `video_generate`, testes de contrato e +a varredura live compartilhada: -| Provedor | `generate` | `imageToVideo` | `videoToVideo` | Faixas ao vivo compartilhadas hoje | +| Provedor | `generate` | `imageToVideo` | `videoToVideo` | Lanes live compartilhadas hoje | | ---------- | :--------: | :------------: | :------------: | ---------------------------------------------------------------------------------------------------------------------------------------- | -| Alibaba | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` ignorado porque este provedor precisa de URLs de vídeo `http(s)` remotas | +| Alibaba | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` ignorado porque este provedor precisa de URLs de vídeo `http(s)` remotas | | BytePlus | ✓ | ✓ | — | `generate`, `imageToVideo` | | ComfyUI | ✓ | ✓ | — | Não está na varredura compartilhada; a cobertura específica de workflow fica com os testes do Comfy | -| DeepInfra | ✓ | — | — | `generate`; esquemas de vídeo nativos da DeepInfra são texto para vídeo no contrato incluído | -| fal | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` somente ao usar Seedance referência para vídeo | +| DeepInfra | ✓ | — | — | `generate`; esquemas de vídeo nativos da DeepInfra são de texto para vídeo no contrato empacotado | +| fal | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` somente ao usar Seedance reference-to-video | | Google | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` compartilhado ignorado porque a varredura atual Gemini/Veo baseada em buffer não aceita essa entrada | | MiniMax | ✓ | ✓ | — | `generate`, `imageToVideo` | -| OpenAI | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` compartilhado ignorado porque este caminho de organização/entrada atualmente precisa de acesso a inpaint/remix no lado do provedor | +| OpenAI | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` compartilhado ignorado porque este caminho de org/entrada atualmente precisa de acesso a inpaint/remix no lado do provedor | | OpenRouter | ✓ | ✓ | — | `generate`, `imageToVideo` | -| Qwen | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` ignorado porque este provedor precisa de URLs de vídeo `http(s)` remotas | -| Runway | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` é executado somente quando o modelo selecionado é `runway/gen4_aleph` | +| Qwen | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` ignorado porque este provedor precisa de URLs de vídeo `http(s)` remotas | +| Runway | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` executa somente quando o modelo selecionado é `runway/gen4_aleph` | | Together | ✓ | ✓ | — | `generate`, `imageToVideo` | -| Vydra | ✓ | ✓ | — | `generate`; `imageToVideo` compartilhado ignorado porque o `veo3` incluído é somente texto e o `kling` incluído exige uma URL de imagem remota | -| xAI | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` ignorado porque este provedor atualmente precisa de uma URL MP4 remota | +| Vydra | ✓ | ✓ | — | `generate`; `imageToVideo` compartilhado ignorado porque o `veo3` empacotado é somente texto e o `kling` empacotado exige uma URL de imagem remota | +| xAI | ✓ | ✓ | ✓ | `generate`, `imageToVideo`; `videoToVideo` ignorado porque este provedor atualmente precisa de uma URL MP4 remota | ## Parâmetros da ferramenta ### Obrigatório - Descrição textual do vídeo a gerar. Obrigatório para `action: "generate"`. + Descrição em texto do vídeo a gerar. Obrigatório para `action: "generate"`. ### Entradas de conteúdo -Imagem de referência única (caminho ou URL). +Uma única imagem de referência (caminho ou URL). Várias imagens de referência (até 9). Dicas opcionais de função por posição, paralelas à lista combinada de imagens. Valores canônicos: `first_frame`, `last_frame`, `reference_image`. -Vídeo de referência único (caminho ou URL). +Um único vídeo de referência (caminho ou URL). Vários vídeos de referência (até 4). Dicas opcionais de função por posição, paralelas à lista combinada de vídeos. Valor canônico: `reference_video`. -Áudio de referência único (caminho ou URL). Usado para música de fundo ou -referência de voz quando o provedor aceita entradas de áudio. +Um único áudio de referência (caminho ou URL). Usado para música de fundo ou +referência de voz quando o provedor oferece suporte a entradas de áudio. Vários áudios de referência (até 3). @@ -193,13 +193,13 @@ Valor canônico: `reference_audio`. -As dicas de função são encaminhadas ao provedor como estão. Os valores canônicos vêm da +As dicas de função são encaminhadas ao provedor sem alterações. Os valores canônicos vêm da união `VideoGenerationAssetRole`, mas os provedores podem aceitar strings de -função adicionais. As matrizes `*Roles` não devem ter mais entradas do que a -lista de referências correspondente; erros de deslocamento por um falham com um erro claro. -Use uma string vazia para deixar um espaço sem definição. Para xAI, defina todas as funções de imagem como -`reference_image` para usar seu modo de geração `reference_images`; omita a -função ou use `first_frame` para imagem-para-vídeo com uma única imagem. +função adicionais. Os arrays `*Roles` não podem ter mais entradas do que a +lista de referências correspondente; erros de índice por uma posição falham com um erro claro. +Use uma string vazia para deixar um slot não definido. Para xAI, defina todas as funções de imagem como +`reference_image` para usar o modo de geração `reference_images`; omita a +função ou use `first_frame` para imagem para vídeo com uma única imagem. ### Controles de estilo @@ -209,89 +209,89 @@ função ou use `first_frame` para imagem-para-vídeo com uma única imagem. Dica de resolução, como `480P`, `720P`, `768P`, `1080P`, `4K` ou um valor específico do provedor. O OpenClaw normaliza ou ignora valores sem suporte por provedor. - Duração-alvo em segundos (arredondada para o valor mais próximo compatível com o provedor). + Duração desejada em segundos (arredondada para o valor mais próximo com suporte do provedor). -Dica de tamanho quando o provedor oferece suporte. +Dica de tamanho quando o provedor oferece suporte a isso. - Habilita áudio gerado na saída quando houver suporte. Diferente de `audioRef*` (entradas). + Habilite áudio gerado na saída quando houver suporte. Diferente de `audioRef*` (entradas). -Alterna a marca-d'água do provedor quando houver suporte. +Ative ou desative a marca d'água do provedor quando houver suporte. -`adaptive` é um sentinela específico do provedor: ele é encaminhado como está para -provedores que declaram `adaptive` em seus recursos (por exemplo, o BytePlus -Seedance o usa para detectar automaticamente a proporção a partir das dimensões -da imagem de entrada). Provedores que não o declaram exibem o valor por meio de -`details.ignoredOverrides` no resultado da ferramenta para que o descarte fique visível. +`adaptive` é um sentinela específico do provedor: ele é encaminhado sem alterações para +provedores que declaram `adaptive` em suas capacidades (por exemplo, o BytePlus +Seedance o usa para detectar automaticamente a proporção a partir das +dimensões da imagem de entrada). Provedores que não o declaram exibem o valor em +`details.ignoredOverrides` no resultado da ferramenta, para que o descarte fique visível. ### Avançado - `"status"` retorna a tarefa atual da sessão; `"list"` inspeciona provedores. + `"status"` retorna a tarefa atual da sessão; `"list"` inspeciona os provedores. Substituição de provedor/modelo (por exemplo, `runway/gen4.5`). Dica de nome do arquivo de saída. -Tempo limite opcional da solicitação ao provedor em milissegundos. +Tempo limite opcional da operação do provedor em milissegundos. Opções específicas do provedor como um objeto JSON (por exemplo, `{"seed": 42, "draft": true}`). Provedores que declaram um esquema tipado validam as chaves e os tipos; chaves - desconhecidas ou incompatibilidades ignoram o candidato durante a alternativa. Provedores sem um - esquema declarado recebem as opções como estão. Execute `video_generate action=list` + desconhecidas ou incompatibilidades ignoram o candidato durante a alternância. Provedores sem um + esquema declarado recebem as opções sem alterações. Execute `video_generate action=list` para ver o que cada provedor aceita. Nem todos os provedores oferecem suporte a todos os parâmetros. O OpenClaw normaliza a duração para -o valor mais próximo compatível com o provedor e remapeia dicas de geometria traduzidas, -como tamanho para proporção, quando um provedor alternativo expõe uma superfície de -controle diferente. Substituições realmente sem suporte são ignoradas em regime de melhor esforço -e relatadas como avisos no resultado da ferramenta. Limites rígidos de recurso -(como entradas de referência em excesso) falham antes do envio. Os resultados da ferramenta +o valor mais próximo com suporte do provedor e remapeia dicas de geometria traduzidas, +como tamanho para proporção, quando um provedor alternativo expõe uma +superfície de controle diferente. Substituições realmente sem suporte são ignoradas com base no melhor esforço +e relatadas como avisos no resultado da ferramenta. Limites rígidos de capacidade +(como referências de entrada em excesso) falham antes do envio. Os resultados da ferramenta relatam as configurações aplicadas; `details.normalization` captura qualquer -tradução de solicitado para aplicado. +tradução do solicitado para o aplicado. -Entradas de referência selecionam o modo de execução: +As entradas de referência selecionam o modo de execução: - Nenhuma mídia de referência → `generate` - Qualquer referência de imagem → `imageToVideo` - Qualquer referência de vídeo → `videoToVideo` - Entradas de áudio de referência **não** alteram o modo resolvido; elas se aplicam - sobre qualquer modo selecionado pelas referências de imagem/vídeo e só funcionam + sobre qualquer modo selecionado pelas referências de imagem/vídeo e funcionam apenas com provedores que declaram `maxInputAudios`. -Referências mistas de imagem e vídeo não são uma superfície de recurso compartilhada estável. +Misturar referências de imagem e vídeo não é uma superfície de capacidade compartilhada estável. Prefira um tipo de referência por solicitação. -#### Alternativa e opções tipadas +#### Alternância e opções tipadas -Algumas verificações de recurso são aplicadas na camada alternativa, em vez do -limite da ferramenta; portanto, uma solicitação que excede os limites do provedor principal ainda pode -ser executada em uma alternativa capaz: +Algumas verificações de capacidade são aplicadas na camada de alternância, e não no +limite da ferramenta, de modo que uma solicitação que exceda os limites do provedor primário ainda pode +ser executada em um provedor alternativo capaz: -- Candidato ativo que não declara `maxInputAudios` (ou declara `0`) é ignorado quando +- Um candidato ativo que não declara `maxInputAudios` (ou declara `0`) é ignorado quando a solicitação contém referências de áudio; o próximo candidato é tentado. -- `maxDurationSeconds` do candidato ativo abaixo do `durationSeconds` solicitado - sem uma lista `supportedDurationSeconds` declarada → ignorado. +- O `maxDurationSeconds` do candidato ativo abaixo do `durationSeconds` solicitado, + sem lista `supportedDurationSeconds` declarada → ignorado. - A solicitação contém `providerOptions` e o candidato ativo declara explicitamente - um esquema `providerOptions` tipado → ignorado se as chaves fornecidas - não estiverem no esquema ou os tipos de valor não corresponderem. Provedores sem um - esquema declarado recebem as opções como estão (passagem direta - compatível com versões anteriores). Um provedor pode recusar todas as opções de provedor ao - declarar um esquema vazio (`capabilities.providerOptions: {}`), o que - causa o mesmo ignorar de uma incompatibilidade de tipo. + um esquema tipado de `providerOptions` → ignorado se as chaves fornecidas + não estiverem no esquema ou se os tipos de valor não corresponderem. Provedores sem um + esquema declarado recebem as opções sem alterações (repasse + compatível com versões anteriores). Um provedor pode recusar todas as opções de provedor + declarando um esquema vazio (`capabilities.providerOptions: {}`), o que + causa o mesmo descarte que uma incompatibilidade de tipo. -O primeiro motivo de ignorar em uma solicitação é registrado em `warn` para que os operadores vejam quando -o provedor principal deles foi preterido; ignoramentos subsequentes são registrados em `debug` para -manter cadeias alternativas longas silenciosas. Se todos os candidatos forem ignorados, o -erro agregado inclui o motivo de ignorar de cada um. +O primeiro motivo de descarte em uma solicitação é registrado em `warn`, para que os operadores vejam quando +o provedor primário foi preterido; descartes subsequentes são registrados em `debug` para +manter cadeias longas de alternância silenciosas. Se todos os candidatos forem descartados, o +erro agregado incluirá o motivo de descarte de cada um. ## Ações -| Ação | O que faz | +| Ação | O que faz | | ---------- | ---------------------------------------------------------------------------------------------------------- | -| `generate` | Padrão. Cria um vídeo a partir do prompt fornecido e das entradas de referência opcionais. | -| `status` | Verifica o estado da tarefa de vídeo em andamento para a sessão atual sem iniciar outra geração. | -| `list` | Mostra provedores, modelos e seus recursos disponíveis. | +| `generate` | Padrão. Cria um vídeo a partir do prompt fornecido e de entradas de referência opcionais. | +| `status` | Verifica o estado da tarefa de vídeo em andamento para a sessão atual sem iniciar outra geração. | +| `list` | Mostra os provedores, modelos e suas capacidades disponíveis. | ## Seleção de modelo @@ -301,10 +301,11 @@ O OpenClaw resolve o modelo nesta ordem: 2. **`videoGenerationModel.primary`** da configuração. 3. **`videoGenerationModel.fallbacks`** em ordem. 4. **Detecção automática** — provedores que têm autenticação válida, começando pelo - provedor padrão atual e depois os provedores restantes em ordem alfabética. + provedor padrão atual e depois os provedores restantes em ordem + alfabética. -Se um provedor falhar, o próximo candidato é tentado automaticamente. Se todos -os candidatos falharem, o erro inclui detalhes de cada tentativa. +Se um provedor falhar, o próximo candidato será tentado automaticamente. Se todos +os candidatos falharem, o erro incluirá detalhes de cada tentativa. Defina `agents.defaults.mediaGenerationAutoProviderFallback: false` para usar apenas as entradas explícitas de `model`, `primary` e `fallbacks`. @@ -322,11 +323,11 @@ apenas as entradas explícitas de `model`, `primary` e `fallbacks`. } ``` -## Notas dos provedores +## Observações dos provedores - Usa o endpoint assíncrono DashScope / Model Studio. Imagens e + Usa o endpoint assíncrono do DashScope / Model Studio. Imagens e vídeos de referência devem ser URLs `http(s)` remotas. @@ -338,11 +339,11 @@ apenas as entradas explícitas de `model`, `primary` e `fallbacks`. Modelos T2V (`*-t2v-*`) não aceitam entradas de imagem; modelos I2V e modelos gerais `*-pro-*` oferecem suporte a uma única imagem de referência (primeiro - quadro). Passe a imagem por posição ou defina `role: "first_frame"`. - IDs de modelo T2V são alternados automaticamente para a variante I2V + quadro). Passe a imagem posicionalmente ou defina `role: "first_frame"`. + IDs de modelo T2V são automaticamente trocados para a variante I2V correspondente quando uma imagem é fornecida. - Chaves `providerOptions` compatíveis: `seed` (número), `draft` (booleano — + Chaves `providerOptions` com suporte: `seed` (número), `draft` (booleano — força 480p), `camera_fixed` (booleano). @@ -354,10 +355,10 @@ apenas as entradas explícitas de `model`, `primary` e `fallbacks`. Usa a API unificada `content[]`. Oferece suporte a no máximo 2 imagens de entrada (`first_frame` + `last_frame`). Todas as entradas devem ser URLs `https://` remotas. Defina `role: "first_frame"` / `"last_frame"` em cada imagem, ou - passe imagens por posição. + passe as imagens posicionalmente. `aspectRatio: "adaptive"` detecta automaticamente a proporção a partir da imagem de entrada. - `audio: true` mapeia para `generate_audio`. `providerOptions.seed` + `audio: true` é mapeado para `generate_audio`. `providerOptions.seed` (número) é encaminhado. @@ -369,72 +370,77 @@ apenas as entradas explícitas de `model`, `primary` e `fallbacks`. Usa a API unificada `content[]`. Oferece suporte a até 9 imagens de referência, 3 vídeos de referência e 3 áudios de referência. Todas as entradas devem ser URLs - `https://` remotas. Defina `role` em cada ativo — valores compatíveis: + `https://` remotas. Defina `role` em cada ativo — valores com suporte: `"first_frame"`, `"last_frame"`, `"reference_image"`, `"reference_video"`, `"reference_audio"`. `aspectRatio: "adaptive"` detecta automaticamente a proporção a partir da imagem de entrada. - `audio: true` mapeia para `generate_audio`. `providerOptions.seed` + `audio: true` é mapeado para `generate_audio`. `providerOptions.seed` (número) é encaminhado. - Execução local ou na nuvem orientada por workflow. Compatível com text-to-video e - image-to-video por meio do grafo configurado. + Execução local ou em nuvem orientada por workflows. Suporta texto para vídeo e + imagem para vídeo por meio do grafo configurado. - Usa um fluxo com suporte de fila para jobs de longa duração. A maioria dos modelos de vídeo fal - aceita uma única referência de imagem. Modelos Seedance 2.0 reference-to-video - aceitam até 9 imagens, 3 vídeos e 3 referências de áudio, com - no máximo 12 arquivos de referência no total. + Usa um fluxo baseado em fila para jobs de longa duração. O OpenClaw aguarda até 20 + minutos por padrão antes de tratar um job de fila fal em andamento como expirado. + A maioria dos modelos de vídeo fal aceita uma única referência de imagem. Os + modelos de referência para vídeo Seedance 2.0 aceitam até 9 imagens, 3 vídeos e + 3 referências de áudio, com no máximo 12 arquivos de referência no total. - Compatível com uma referência de imagem ou uma referência de vídeo. + Suporta uma referência de imagem ou uma referência de vídeo. Solicitações de + áudio gerado são ignoradas com um aviso no caminho da API Gemini porque essa API + rejeita o parâmetro `generateAudio` para a geração de vídeo Veo atual. - Apenas uma única referência de imagem. + Apenas uma referência de imagem. O MiniMax aceita resoluções `768P` e `1080P`; + solicitações como `720P` são normalizadas para o valor compatível mais próximo + antes do envio. - Apenas a substituição de `size` é encaminhada. Outras substituições de estilo + Somente a substituição de `size` é encaminhada. Outras substituições de estilo (`aspectRatio`, `resolution`, `audio`, `watermark`) são ignoradas com um aviso. - Usa a API assíncrona `/videos` do OpenRouter. O OpenClaw envia o + Usa a API assíncrona `/videos` da OpenRouter. O OpenClaw envia o job, consulta `polling_url` e baixa `unsigned_urls` ou o endpoint de conteúdo do job documentado. O padrão `google/veo-3.1-fast` incluído anuncia durações de 4/6/8 segundos, resoluções `720P`/`1080P` e - proporções de tela `16:9`/`9:16`. + proporções `16:9`/`9:16`. - Mesmo backend DashScope da Alibaba. As entradas de referência devem ser URLs remotas - `http(s)`; arquivos locais são rejeitados de antemão. + O mesmo backend DashScope da Alibaba. As entradas de referência devem ser URLs + `http(s)` remotas; arquivos locais são rejeitados antecipadamente. - Compatível com arquivos locais via data URIs. Video-to-video exige - `runway/gen4_aleph`. Execuções somente texto expõem proporções de tela + Suporta arquivos locais via URIs de dados. Vídeo para vídeo requer + `runway/gen4_aleph`. Execuções apenas com texto expõem proporções `16:9` e `9:16`. - Apenas uma única referência de imagem. + Apenas uma referência de imagem. Usa `https://www.vydra.ai/api/v1` diretamente para evitar redirecionamentos - que removem autenticação. `veo3` é incluído apenas como text-to-video; `kling` exige - uma URL remota de imagem. + que removem autenticação. `veo3` é incluído apenas como texto para vídeo; `kling` + requer uma URL de imagem remota. - Compatível com text-to-video, image-to-video com uma única imagem de primeiro quadro, até 7 - entradas `reference_image` por meio de `reference_images` da xAI, e fluxos remotos - de edição/expansão de vídeo. + Suporta texto para vídeo, imagem única de primeiro quadro para vídeo, até 7 + entradas `reference_image` por meio de `reference_images` da xAI e fluxos remotos + de edição/extensão de vídeo. ## Modos de capacidade de provedores -O contrato compartilhado de geração de vídeo oferece suporte a capacidades específicas por modo -em vez de apenas limites agregados planos. Novas implementações de provedores -devem preferir blocos de modo explícitos: +O contrato compartilhado de geração de vídeo oferece suporte a capacidades +específicas por modo, em vez de apenas limites agregados planos. Novas implementações +de provedores devem preferir blocos de modo explícitos: ```typescript capabilities: { @@ -460,18 +466,18 @@ capabilities: { ``` Campos agregados planos como `maxInputImages` e `maxInputVideos` **não** são -suficientes para anunciar suporte ao modo de transformação. Provedores devem +suficientes para anunciar suporte a modos de transformação. Provedores devem declarar `generate`, `imageToVideo` e `videoToVideo` explicitamente para que testes -ao vivo, testes de contrato e a ferramenta compartilhada `video_generate` possam validar -o suporte a modos de forma determinística. +live, testes de contrato e a ferramenta compartilhada `video_generate` possam +validar o suporte a modos de forma determinística. -Quando um modelo em um provedor tiver suporte mais amplo a entradas de referência do que o -restante, use `maxInputImagesByModel`, `maxInputVideosByModel` ou -`maxInputAudiosByModel` em vez de elevar o limite de todo o modo. +Quando um modelo de um provedor tem suporte mais amplo a entradas de referência do +que o restante, use `maxInputImagesByModel`, `maxInputVideosByModel` ou +`maxInputAudiosByModel` em vez de aumentar o limite de todo o modo. -## Testes ao vivo +## Testes live -Cobertura ao vivo opcional para os provedores incluídos compartilhados: +Cobertura live opcional para os provedores compartilhados incluídos: ```bash OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/video-generation-providers.live.test.ts @@ -483,31 +489,32 @@ Wrapper do repositório: pnpm test:live:media video ``` -Este arquivo ao vivo carrega variáveis de ambiente de provedores ausentes a partir de `~/.profile`, prefere -chaves de API ao vivo/de ambiente antes de perfis de autenticação armazenados por padrão, e executa um -smoke seguro para release por padrão: +Esse arquivo live carrega variáveis de ambiente ausentes do provedor a partir de +`~/.profile`, prefere chaves de API live/de ambiente antes de perfis de autenticação +armazenados por padrão e executa um smoke seguro para releases por padrão: - `generate` para todos os provedores não FAL na varredura. - Prompt de lagosta de um segundo. - Limite de operação por provedor a partir de `OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS` (`180000` por padrão). -FAL é opcional porque a latência de fila do lado do provedor pode dominar o tempo +FAL é opcional porque a latência da fila do lado do provedor pode dominar o tempo de release: ```bash pnpm test:live:media video --video-providers fal ``` -Defina `OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1` para também executar os -modos de transformação declarados que a varredura compartilhada consegue exercitar com segurança com mídia local: +Defina `OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1` para também executar modos de +transformação declarados que a varredura compartilhada consegue exercitar com +segurança usando mídia local: - `imageToVideo` quando `capabilities.imageToVideo.enabled`. - `videoToVideo` quando `capabilities.videoToVideo.enabled` e o - provedor/modelo aceitar entrada de vídeo local baseada em buffer na varredura + provedor/modelo aceita entrada de vídeo local baseada em buffer na varredura compartilhada. -Hoje, a lane ao vivo compartilhada de `videoToVideo` cobre apenas `runway` quando você +Hoje a lane live compartilhada de `videoToVideo` cobre `runway` somente quando você seleciona `runway/gen4_aleph`. ## Configuração @@ -527,7 +534,7 @@ Defina o modelo padrão de geração de vídeo na sua configuração do OpenClaw } ``` -Ou pela CLI: +Ou via CLI: ```bash openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2v" @@ -536,7 +543,7 @@ openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2 ## Relacionado - [Alibaba Model Studio](/pt-BR/providers/alibaba) -- [Tarefas em segundo plano](/pt-BR/automation/tasks) — rastreamento de tarefas para geração assíncrona de vídeo +- [Tarefas em segundo plano](/pt-BR/automation/tasks) — acompanhamento de tarefas para geração assíncrona de vídeo - [BytePlus](/pt-BR/concepts/model-providers#byteplus-international) - [ComfyUI](/pt-BR/providers/comfy) - [Referência de configuração](/pt-BR/gateway/config-agents#agent-defaults)