Interface de controle

• Converse com o modelo via Gateway WS (chat.history, chat.send, chat.abort, chat.inject).
• Atualizações do histórico de chat solicitam uma janela recente limitada com limites de texto por mensagem para que sessões grandes não obriguem o navegador a renderizar uma carga completa de transcrito antes de o chat se tornar utilizável.
• Fale por sessões em tempo real do navegador. A OpenAI usa WebRTC direto, o Google Live usa um token de navegador restrito e de uso único por WebSocket, e plugins de voz em tempo real apenas de backend usam o transporte de retransmissão do Gateway. Sessões de provedor pertencentes ao cliente começam com talk.client.create; sessões de retransmissão do Gateway começam com talk.session.create. A retransmissão mantém as credenciais do provedor no Gateway enquanto o navegador transmite PCM do microfone por talk.session.appendAudio, encaminha chamadas de ferramenta do provedor openclaw_agent_consult por talk.client.toolCall para a política do Gateway e o modelo OpenClaw configurado maior, e roteia o direcionamento por voz da execução ativa por talk.client.steer ou talk.session.steer.
• Transmita chamadas de ferramentas + cartões de saída de ferramentas ao vivo no chat (eventos de agente).
• Aba de atividade com resumos locais do navegador e priorizando redação da atividade de ferramentas ao vivo a partir da entrega existente de eventos session.tool / ferramenta.

• Canais: status de canais integrados mais canais de plugins agrupados/externos, login por QR e configuração por canal (channels.status, web.login.*, config.patch).
• Atualizações de sondagem de canais mantêm o snapshot anterior visível enquanto verificações lentas de provedor terminam, e snapshots parciais são rotulados quando uma sondagem ou auditoria excede o orçamento da UI.
• Instâncias: lista de presença + atualização (system-presence).
• Sessões: liste sessões de agentes configurados por padrão, fixe sessões frequentes, renomeie-as, arquive ou restaure sessões inativas, faça fallback a partir de chaves obsoletas de sessão de agente não configurado e aplique substituições por sessão de modelo/thinking/rápido/verboso/rastreamento/raciocínio (sessions.list, sessions.patch). Sessões fixadas são ordenadas acima das sessões recentes não fixadas; sessões arquivadas ficam na visualização arquivada da página Sessões e mantêm seus transcritos.
• Sonhos: status de dreaming, alternância de ativar/desativar e leitor do Diário de Sonhos (doctor.memory.status, doctor.memory.dreamDiary, config.patch).

• Tarefas Cron: listar/adicionar/editar/executar/ativar/desativar + histórico de execuções (cron.*).
• Skills: status, ativar/desativar, instalar, atualizações de chave de API (skills.*).
• Nós: listar + limites (node.list), criar códigos de configuração móvel e aprovar pareamento de dispositivos (device.pair.*).
• Aprovações de exec: edite allowlists de gateway ou nó + política de solicitação para exec host=gateway/node (exec.approvals.*).

• Visualize/edite ~/.openclaw/openclaw.json (config.get, config.set).
• O MCP tem uma página dedicada de configurações para servidores configurados, habilitação, resumos de OAuth/filtros/paralelismo, comandos comuns de operador e o editor de configuração mcp com escopo.
• Aplique + reinicie com validação (config.apply) e desperte a última sessão ativa.
• As gravações incluem uma proteção por hash base para evitar sobrescrever edições simultâneas.
• As gravações (config.set/config.apply/config.patch) fazem uma verificação prévia da resolução ativa de SecretRef para refs no payload de configuração enviado; refs enviadas ativas e não resolvidas são rejeitadas antes da gravação.
• Salvamentos de formulário descartam placeholders redigidos obsoletos que não podem ser restaurados a partir da configuração salva, preservando valores redigidos que ainda mapeiam para segredos salvos.
• Renderização de esquema + formulário (config.schema / config.schema.lookup, incluindo title / description de campo, dicas de UI correspondentes, resumos de filhos imediatos, metadados de documentação em nós aninhados de objeto/curinga/array/composição, além de esquemas de plugin + canal quando disponíveis); o editor de JSON bruto fica disponível somente quando o snapshot tem uma ida e volta bruta segura.
• Se um snapshot não puder fazer ida e volta segura de texto bruto, a Control UI força o modo Formulário e desabilita o modo Bruto para esse snapshot.
• O editor de JSON bruto "Redefinir para salvo" preserva a forma criada em bruto (formatação, comentários, layout de $include) em vez de renderizar novamente um snapshot achatado, para que edições externas sobrevivam a uma redefinição quando o snapshot puder fazer ida e volta com segurança.
• Valores de objeto SecretRef estruturados são renderizados como somente leitura em entradas de texto de formulário para evitar corrupção acidental de objeto para string.

• Depuração: snapshots de status/integridade/modelos + log de eventos + chamadas RPC manuais (status, health, models.list).
• O log de eventos inclui tempos de atualização/RPC da Control UI, tempos lentos de renderização de chat/configuração e entradas de responsividade do navegador para quadros de animação longos ou tarefas longas quando o navegador expõe esses tipos de entrada de PerformanceObserver.
• Logs: acompanhamento ao vivo dos logs de arquivo do Gateway com filtro/exportação (logs.tail).
• Atualização: execute uma atualização de pacote/git + reinício (update.run) com um relatório de reinício e, em seguida, consulte update.status após reconectar para verificar a versão do Gateway em execução.

• Para tarefas isoladas, a entrega usa anúncio de resumo por padrão. Você pode mudar para nenhuma se quiser execuções somente internas.
• Os campos de canal/destino aparecem quando anúncio está selecionado.
• O modo Webhook usa delivery.mode = "webhook" com delivery.to definido como uma URL de Webhook HTTP(S) válida.
• Para tarefas de sessão principal, os modos de entrega Webhook e nenhuma estão disponíveis.
• Controles de edição avançada incluem excluir após execução, limpar substituição de agente, opções de cron exato/escalonado, substituições de modelo/raciocínio de agente e alternâncias de entrega por melhor esforço.
• A validação de formulário é inline, com erros em nível de campo; valores inválidos desabilitam o botão de salvar até serem corrigidos.
• Defina cron.webhookToken para enviar um token bearer dedicado; se omitido, o Webhook é enviado sem um cabeçalho de autenticação.
• Fallback obsoleto: execute openclaw doctor --fix para migrar tarefas legadas armazenadas com notify: true de cron.webhook para Webhook explícito por tarefa ou entrega de conclusão.

• chat.send é não bloqueante: confirma imediatamente com { runId, status: "started" } e a resposta é transmitida por eventos chat. Clientes confiáveis da Control UI também podem receber metadados opcionais de tempo de ACK para diagnósticos locais.
• Uploads de chat aceitam imagens e arquivos que não sejam vídeo. Imagens mantêm o caminho de imagem nativo; outros arquivos são armazenados como mídia gerenciada e exibidos no histórico como links de anexo.
• Reenviar com o mesmo idempotencyKey retorna { status: "in_flight" } enquanto estiver em execução, e { status: "ok" } após a conclusão.
• Respostas de chat.history têm limite de tamanho para segurança da UI. Quando entradas de transcrição são grandes demais, o Gateway pode truncar campos de texto longos, omitir blocos pesados de metadados e substituir mensagens grandes demais por um placeholder ([chat.history omitted: message too large]).
• Quando uma mensagem visível do assistente foi truncada em chat.history, o leitor lateral pode buscar sob demanda a entrada completa de transcrição normalizada para exibição por meio de chat.message.get, usando sessionKey, agentId ativo quando necessário e messageId da transcrição. Se o Gateway ainda não puder retornar mais, o leitor mostra um estado explícito de indisponível em vez de repetir silenciosamente a prévia truncada.
• Imagens assistente/geradas são persistidas como referências de mídia gerenciada e servidas de volta por URLs de mídia autenticadas do Gateway, então recarregamentos não dependem de payloads brutos de imagem em base64 permanecerem na resposta do histórico de chat.
• Ao renderizar chat.history, a Control UI remove tags de diretiva inline somente de exibição do texto visível do assistente (por exemplo [[reply_to_*]] e [[audio_as_voice]]), payloads XML de chamada de ferramenta em texto simples (incluindo <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> e blocos truncados de chamada de ferramenta), e tokens de controle de modelo ASCII/largura total vazados, e omite entradas de assistente cujo texto visível inteiro seja somente o token silencioso exato NO_REPLY / no_reply ou o token de confirmação de Heartbeat HEARTBEAT_OK.
• Durante um envio ativo e a atualização final do histórico, a visualização de chat mantém mensagens locais otimistas de usuário/assistente visíveis se chat.history retornar brevemente um snapshot mais antigo; a transcrição canônica substitui essas mensagens locais assim que o histórico do Gateway se atualiza.
• Eventos chat ao vivo são estado de entrega, enquanto chat.history é reconstruído a partir da transcrição durável da sessão. Após eventos finais de ferramenta, a Control UI recarrega o histórico e mescla apenas uma pequena cauda otimista; o limite da transcrição está documentado em WebChat.
• chat.inject anexa uma nota de assistente à transcrição da sessão e transmite um evento chat para atualizações somente de UI (sem execução de agente, sem entrega por canal).
• A barra lateral lista sessões recentes com uma ação Nova sessão, um link Todas as sessões e um botão de busca de sessão que abre o seletor completo de sessões (com escopo pelo agente selecionado, com busca e paginação). Trocar de agentes mostra somente sessões vinculadas a esse agente e recorre à sessão principal desse agente quando ele ainda não tem sessões de painel salvas.
• Cada linha do seletor de sessões pode renomear, fixar ou arquivar a sessão. Uma execução ativa e a sessão principal de um agente não podem ser arquivadas. Arquivar a sessão atualmente selecionada muda o Chat de volta para a sessão principal desse agente.
• Em larguras de desktop, os controles de chat permanecem em uma linha compacta e colapsam ao rolar para baixo na transcrição; rolar para cima, retornar ao topo ou alcançar o fim restaura os controles.
• Mensagens consecutivas duplicadas somente de texto são renderizadas como um único balão com um selo de contagem. Mensagens que carregam imagens, anexos, saída de ferramenta ou prévias de canvas não são colapsadas.
• Os seletores de modelo e raciocínio do cabeçalho do chat aplicam patch imediatamente à sessão ativa por meio de sessions.patch; eles são substituições persistentes de sessão, não opções de envio de um único turno.
• Se você enviar uma mensagem enquanto uma alteração do seletor de modelo para a mesma sessão ainda estiver sendo salva, o compositor aguarda esse patch de sessão antes de chamar chat.send, para que o envio use o modelo selecionado.
• Digitar /new na Control UI cria e alterna para a mesma sessão nova de painel que Novo chat, exceto quando session.dmScope: "main" está configurado e o pai atual é a sessão principal do agente; nesse caso, ela redefine a sessão principal no lugar. Digitar /reset mantém a redefinição explícita no lugar do Gateway para a sessão atual.
• O seletor de modelo do chat solicita a visualização de modelo configurada do Gateway. Se agents.defaults.models estiver presente, essa lista de permissões conduz o seletor, incluindo entradas provider/* que mantêm catálogos com escopo de provedor dinâmicos. Caso contrário, o seletor mostra entradas explícitas de models.providers.*.models mais provedores com autenticação utilizável. O catálogo completo permanece disponível por meio do RPC de depuração models.list com view: "all".
• Quando relatórios novos de uso de sessão do Gateway incluem tokens de contexto atuais, a barra de ferramentas do compositor de chat mostra um pequeno anel de uso de contexto com a porcentagem usada; o detalhe completo de tokens fica em sua tooltip. O anel muda para estilo de aviso sob alta pressão de contexto e, em níveis recomendados de Compaction, mostra um botão compacto que executa o caminho normal de Compaction da sessão. Snapshots obsoletos de tokens ficam ocultos até o Gateway relatar uso novo novamente.

O modo de fala usa um provedor registrado de voz em tempo real. Configure a OpenAI com talk.realtime.provider: "openai" mais um perfil de autenticação por chave de API openai, talk.realtime.providers.openai.apiKey ou OPENAI_API_KEY; perfis OAuth da OpenAI não configuram voz Realtime. Configure o Google com talk.realtime.provider: "google" mais talk.realtime.providers.google.apiKey. O navegador nunca recebe uma chave de API padrão de provedor. A OpenAI recebe um segredo efêmero de cliente Realtime para WebRTC. O Google Live recebe um token de autenticação Live API restrito de uso único para uma sessão WebSocket do navegador, com instruções e declarações de ferramentas bloqueadas no token pelo Gateway. Provedores que expõem somente uma ponte backend em tempo real executam pelo transporte de relay do Gateway, para que credenciais e sockets do fornecedor permaneçam no lado do servidor enquanto o áudio do navegador se move por RPCs autenticadas do Gateway. O prompt da sessão Realtime é montado pelo Gateway; talk.client.create não aceita substituições de instrução fornecidas pelo chamador.

O compositor do Chat inclui um botão de opções de Talk ao lado do botão de iniciar/parar Talk. As opções se aplicam à próxima sessão de Talk e podem substituir provedor, transporte, modelo, voz, esforço de raciocínio, limite de VAD, duração do silêncio e preenchimento de prefixo. Quando uma opção fica em branco, o Gateway usa os padrões configurados quando disponíveis ou o padrão do provedor. Selecionar o relay do Gateway força o caminho de relay do backend; selecionar WebRTC mantém a sessão pertencente ao cliente e falha em vez de recorrer silenciosamente ao relay se o provedor não puder criar uma sessão de navegador.

No compositor do Chat, o controle de Talk é o botão de ondas ao lado do botão de ditado por microfone. Quando o Talk começa, a linha de status do compositor mostra Connecting Talk..., depois Talk live enquanto o áudio está conectado, ou Asking OpenClaw... enquanto uma chamada de ferramenta em tempo real consulta o modelo maior configurado por meio de talk.client.toolCall.

Smoke ao vivo de mantenedor: OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts verifica a ponte WebSocket de backend da OpenAI, a troca de SDP WebRTC de navegador da OpenAI, a configuração de WebSocket de navegador com token limitado do Google Live e o adaptador de navegador de relay do Gateway com mídia de microfone falsa. O comando imprime apenas o status do provedor e não registra segredos.

• Clique em Parar (chama chat.abort).
• Enquanto uma execução está ativa, acompanhamentos normais entram na fila. Clique em Conduzir em uma mensagem enfileirada para injetar esse acompanhamento no turno em execução.
• Digite /stop (ou frases autônomas de aborto como stop, stop action, stop run, stop openclaw, please stop) para abortar fora de banda.
• chat.abort oferece suporte a { sessionKey } (sem runId) para abortar todas as execuções ativas dessa sessão.

• Quando uma execução é abortada, o texto parcial do assistente ainda pode ser mostrado na UI.
• O Gateway persiste texto parcial abortado do assistente no histórico da transcrição quando há saída em buffer.
• As entradas persistidas incluem metadados de aborto para que consumidores de transcrição possam diferenciar parciais de aborto da saída de conclusão normal.

{  gateway: {    controlUi: { allowInsecureAuth: true },    bind: "tailnet",    auth: { mode: "token", token: "replace-me" },  },}

allowInsecureAuth é apenas um alternador de compatibilidade local:

• Permite que sessões da Control UI de localhost prossigam sem identidade de dispositivo em contextos HTTP não seguros.
• Não ignora verificações de pareamento.
• Não relaxa requisitos de identidade de dispositivo remotos (não localhost).

• Autenticação trusted-proxy bem-sucedida pode admitir sessões da Control UI de operador sem identidade de dispositivo.
• Isso não se estende a sessões da Control UI com função de nó.
• Proxies reversos de loopback no mesmo host ainda não satisfazem autenticação trusted-proxy; consulte Autenticação de proxy confiável.

• gatewayUrl é armazenado em localStorage após o carregamento e removido da URL.
• Se você passar um endpoint completo ws:// ou wss:// via gatewayUrl, codifique o valor de gatewayUrl para URL para que o navegador analise a string de consulta corretamente.
• token deve ser passado pelo fragmento da URL (#token=...) sempre que possível. Fragmentos não são enviados ao servidor, o que evita vazamento em logs de requisição e no Referer. Parâmetros de consulta legados ?token= ainda são importados uma vez por compatibilidade, mas apenas como fallback, e são removidos imediatamente após o bootstrap.
• password é mantido apenas na memória.
• Quando gatewayUrl está definido, a UI não recorre a credenciais de configuração ou ambiente. Forneça token (ou password) explicitamente. A ausência de credenciais explícitas é um erro.
• Use wss:// quando o Gateway estiver atrás de TLS (Tailscale Serve, proxy HTTPS etc.).
• gatewayUrl só é aceito em uma janela de nível superior (não incorporada) para impedir clickjacking.
• Implantações públicas não loopback da Control UI devem definir gateway.controlUi.allowedOrigins explicitamente (origens completas). Carregamentos LAN/Tailnet privados de mesma origem a partir de loopback, RFC1918/link-local, .local, .ts.net ou hosts CGNAT do Tailscale são aceitos sem habilitar fallback de cabeçalho Host.
• A inicialização do Gateway pode semear origens locais como http://localhost:<port> e http://127.0.0.1:<port> a partir do bind e da porta efetivos em tempo de execução, mas origens de navegadores remotos ainda precisam de entradas explícitas.
• Não use gateway.controlUi.allowedOrigins: ["*"] exceto para testes locais rigidamente controlados. Isso significa permitir qualquer origem de navegador, não "corresponder a qualquer host que eu esteja usando".
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true habilita o modo de fallback de origem por cabeçalho Host, mas é um modo de segurança perigoso.