Interface de controle

• Converse com o modelo pelo Gateway WS (chat.history, chat.send, chat.abort, chat.inject).
• As atualizações do histórico do chat solicitam uma janela recente limitada, com limites de texto por mensagem, para que sessões grandes não obriguem o navegador a renderizar a carga completa da transcrição antes que o chat possa ser usado.
• Passar o mouse ou mover o foco do teclado para um link público de issue ou pull request do GitHub exibe seu estado, título, autor, atividade recente, comentários e estatísticas de alterações. O Gateway conectado busca e armazena em cache os metadados públicos sem alterar o destino do link, inclusive quando a interface usa um Gateway remoto. O Gateway usa GH_TOKEN ou GITHUB_TOKEN quando disponível, após confirmar que o repositório é público; caso contrário, usa a API anônima do GitHub com um cache mais duradouro.
• Converse por meio de sessões em tempo real no 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 exclusivos do backend usam o transporte de retransmissão do Gateway. Sessões de provedor controladas pelo 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 aplicação das políticas do Gateway e uso do modelo OpenClaw maior configurado, e direciona a condução por voz da execução ativa por talk.client.steer ou talk.session.steer.
• Transmita chamadas de ferramentas e cartões de saída de ferramentas em tempo real no Chat (eventos do agente). A atividade das ferramentas é renderizada como linhas específicas por tipo: comandos de shell exibem o comando com realce de sintaxe e saída no estilo de terminal; chamadas compatíveis de edição e gravação exibem diffs embutidos limitados, números de linha quando disponíveis e estatísticas de +added -removed; e chamadas consecutivas são recolhidas em um resumo como "Executou 13 comandos, leu 6 arquivos, editou 9 arquivos". Enquanto uma execução está ativa, a chamada em execução mais recente dá nome ao cabeçalho do grupo. Expanda uma linha para inspecionar os argumentos restantes e a saída bruta.
• Títulos opcionais de finalidade gerados por IA para chamadas de ferramentas complexas (comandos de shell longos, ferramentas de plugins com muitos argumentos), habilitados com gateway.controlUi.toolTitles: true (desativados por padrão). Os títulos vêm do método chat.toolTitles em lote por meio do roteamento padrão do modelo utilitário — um utilityModel explícito (provedor escolhido pelo operador, como em outras tarefas utilitárias) ou, na ausência dele, o modelo pequeno padrão declarado pelo provedor da sessão — e são armazenados em cache pelo Gateway por agente. Quando a opção não está habilitada ou nenhum modelo de baixo custo pode ser usado, as linhas mantêm seus rótulos determinísticos e nenhuma chamada de modelo é realizada.
• Inicie ou descarte tarefas de acompanhamento efêmeras sugeridas pelo modelo; sugestões aceitas abrem uma nova sessão de árvore de trabalho gerenciada com o prompt proposto.
• Aba Atividade com resumos locais do navegador, priorizando a redação de dados confidenciais, da atividade de ferramentas em tempo real proveniente da entrega existente de eventos session.tool / eventos de ferramentas.

• Canais: status dos canais integrados e dos canais de plugins incluídos/externos, login por QR e configuração por canal (channels.status, web.login.*, config.patch).
• As atualizações de sondagem dos canais mantêm o instantâneo anterior visível enquanto as verificações lentas dos provedores são concluídas e identificam instantâneos parciais quando uma sondagem ou auditoria excede seu limite de tempo na interface.
• Sessões: liste por padrão as sessões dos agentes configurados, fixe sessões frequentes, renomeie-as, arquive ou restaure sessões inativas, recupere-se de chaves obsoletas de sessões de agentes não configurados e aplique substituições de modelo/pensamento/modo rápido/detalhamento/rastreamento/raciocínio por sessão (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 de arquivadas da página Sessões e mantêm suas transcrições. As linhas exibem um ponto de não lida para sessões com atividade desde a última leitura, com ações para marcar como não lida/lida (sessions.patch { unread }), e uma ação Bifurcar que ramifica a transcrição em uma nova sessão (sessions.create { parentSessionKey, fork: true }). Blocos de visão geral acima da tabela resumem o conjunto carregado (quantidade de sessões, execuções ativas, sessões não lidas, total de tokens), cada linha contém um glifo de tipo com um ponto de execução ativa, o status é renderizado como um ponto simples acompanhado de um rótulo, e a coluna Tokens exibe um medidor de uso da janela de contexto quando a sessão informa os tamanhos de tokens e de contexto. As ações de gerenciamento ficam em um menu por linha (botão de reticências verticais ou clique com o botão direito), correspondente ao menu de sessão da barra lateral, e a gaveta da linha apresenta o runtime do agente e a duração da execução junto aos outros detalhes da sessão.
• Agrupamento de sessões: um controle Agrupar por organiza a tabela de sessões em seções por grupos personalizados, canal, tipo, agente ou data. Os grupos personalizados persistem por sessão por meio de sessions.patch (category), de modo que as sessões iniciadas em canais de mensagens (Discord, Telegram, WhatsApp, ...) também possam ser categorizadas; atribua grupos arrastando linhas para uma seção ou usando o seletor de grupo de cada linha, e crie grupos com a ação Novo grupo.
• Memória (uma aba na página Agentes, no escopo do agente selecionado): status de Dreaming, controle para habilitar/desabilitar e leitor do Diário de Sonhos (doctor.memory.status, doctor.memory.dreamDiary, config.patch).

• Automações (tarefas cron): cartões de estatísticas (quantidade de automações, quantidade com falha, estado do agendador, próxima ativação) acima de um seletor de abas Automações/Histórico de execuções; a aba Automações lista as tarefas em uma tabela filtrável (Todas/Ativas/Pausadas, pesquisa, filtros de agendamento e última execução, menu de ações por linha) com sugestões iniciais abaixo, e a aba Histórico de execuções mostra execuções recentes de todas as automações (cron.*).
• Tarefas: registro em tempo real de tarefas em segundo plano ativas e recentes, com sessões vinculadas e cancelamento (tasks.*).
• Plugins: navegue pelo inventário instalado e pela loja selecionada, pesquise no ClawHub, instale e remova código de plugins e ative ou desative plugins instalados (plugins.*); as linhas de servidores MCP editam mcp.servers por meio dos métodos de configuração.
• Skills: status, ativação/desativação, instalação e atualizações de chave de API (skills.*).
• Dispositivos: um único inventário reúne registros de dispositivos pareados, o catálogo de nós e a presença em tempo real (device.pair.list, node.list, system-presence). O host do Gateway fica fixado primeiro; clientes pareados mostram o status da conexão, funções, tokens, recursos e comandos. Pareamentos duplicados são agrupados em um grupo expansível, e Limpar N obsoletos remove em massa duplicatas offline confirmadas pelo administrador que foram aprovadas automaticamente (local silencioso, CIDR confiável ou verificadas por SSH) ou que são anteriores à procedência da aprovação. As entradas podem ser removidas (node.pair.remove, device.pair.remove), enquanto o pareamento de dispositivos e as novas aprovações de nós são tratados diretamente na interface (device.pair.*, node.pair.approve/reject), e os códigos de configuração para dispositivos móveis são criados no mesmo cartão.
• Aprovações de execução: edite listas de permissões do Gateway ou de nós e a política de confirmação para exec host=gateway/node (exec.approvals.*).

• Visualize/edite ~/.openclaw/openclaw.json (config.get, config.set).
• Perfil: uma página de configurações que mostra a identidade do agente padrão com estatísticas de uso de todo o período — tokens acumulados, dia de pico, sessão mais longa, sequências de atividade, um mapa de calor anual de tokens, principais ferramentas e destaques de canais (usage.cost, sessions.usage).
• O MCP tem uma página de configurações dedicada com linhas de servidores somente leitura (transporte, ativação, resumos de OAuth/filtros/paralelismo), comandos comuns para operadores e o editor de configuração com escopo mcp; a adição, ativação/desativação e remoção de servidores ocorre na página Plugins.
• Provedores de modelos: uma página de configurações que lista todos os provedores de modelos configurados, com o ícone da marca, estado de autenticação (models.authStatus), disponibilidade de modelos (models.list), dados em tempo real de plano/cota/faturamento quando informados pelo provedor (usage.status) e gastos das sessões locais nos últimos 30 dias (sessions.usage). Uma ação Atualizar relê o estado das credenciais e o uso do provedor.
• Conexão: uma página de configurações (em Conexões) responsável pelo próprio vínculo do painel com o Gateway — URL WebSocket, token do Gateway, senha e chave de sessão padrão — além do snapshot do handshake mais recente (status, tempo de atividade, intervalo de pulsos, última atualização dos canais). A tela de login offline trata o caso desconectado; esta página edita a conexão enquanto ela está ativa.
• Aplique e reinicie com validação (config.apply) e, em seguida, reative a última sessão ativa.
• As gravações incluem uma proteção por hash-base para evitar a substituição de edições simultâneas.
• As gravações (config.set/config.apply/config.patch) verificam previamente a resolução de SecretRefs ativos para as referências no conteúdo de configuração enviado; referências ativas enviadas que não possam ser resolvidas são rejeitadas antes da gravação.
• Ao salvar, os formulários descartam placeholders ocultos obsoletos que não podem ser restaurados a partir da configuração salva, preservando os valores ocultos que ainda correspondem a segredos salvos.
• O esquema e a renderização do formulário vêm de config.schema / config.schema.lookup, incluindo title/description dos campos, dicas de interface correspondentes, resumos dos filhos imediatos, metadados da documentação em nós aninhados de objeto/coringa/array/composição, além dos esquemas de plugins e canais quando disponíveis. O editor de JSON bruto só está disponível quando o snapshot permite uma conversão de ida e volta segura no formato bruto; caso contrário, a Control UI força o modo Formulário.
• A opção "Redefinir para o salvo" do editor de JSON bruto preserva a estrutura criada no formato bruto (formatação, comentários, disposição de $include) em vez de renderizar novamente um snapshot nivelado, para que edições externas sobrevivam a uma redefinição quando o snapshot permitir uma conversão de ida e volta segura.
• Valores estruturados de objeto SecretRef são renderizados como somente leitura nas entradas de texto do formulário, para evitar a conversão acidental e corrompida de objeto em string.

• A análise de tokens e de custo estimado derivada das sessões permanece separada do faturamento dos provedores.
• Os cartões de provedores chamam usage.status e mostram nomes de planos, períodos de cota, saldos, gastos e orçamentos em tempo real informados pelos plugins de provedores configurados.
• Uma falha no uso de um provedor não bloqueia o painel de sessões/custos; cartões de provedores indisponíveis mostram seu próprio estado de erro.

• Depuração: snapshots de status/integridade/modelos, log de eventos e 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 registros de responsividade do navegador para quadros de animação longos ou tarefas demoradas quando o navegador disponibiliza esses tipos de entrada do PerformanceObserver.
• Logs: acompanhamento em tempo real dos logs de arquivo do Gateway com filtro/exportação (logs.tail).
• Atualização: execute uma atualização de pacote/git e reinicie (update.run) com um relatório de reinicialização; depois, consulte periodicamente update.status após a reconexão para verificar a versão do Gateway em execução.

• Selecionar uma linha abre uma visualização de detalhes em página inteira, com um seletor Ativa/Pausada e Executar agora no cabeçalho (executar se estiver no prazo, clonar e remover no menu); a aba Configurações edita a automação diretamente (prompt, detalhes, frequência, substituições avançadas), e a aba Histórico de execuções mostra as execuções dessa automação.
• As automações iniciais abaixo da tabela preenchem previamente o formulário de criação com um prompt e um agendamento editáveis.
• Para tarefas isoladas, a entrega usa por padrão o anúncio de um resumo; altere para nenhuma para execuções exclusivamente internas.
• Os campos de canal/destino aparecem quando a opção de anúncio está selecionada.
• O modo Webhook usa delivery.mode = "webhook" com delivery.to definido como uma URL válida de Webhook HTTP(S).
• Para tarefas da sessão principal, os modos de entrega por Webhook e nenhuma estão disponíveis.
• Os controles avançados de edição incluem excluir após a execução, limpar a substituição do agente, opções de cron exato/escalonado, substituições de modelo/raciocínio do agente e seletores de entrega por melhor esforço.
• A validação do formulário ocorre diretamente na interface, com erros por campo; valores inválidos desativam o botão de salvar até serem corrigidos.
• Defina cron.webhookToken para enviar um token bearer dedicado; se omitido, o Webhook será enviado sem um cabeçalho de autenticação.
• cron.webhook é um fallback legado e obsoleto: execute openclaw doctor --fix para migrar tarefas armazenadas que ainda usam notify: true para entrega explícita por Webhook ou de conclusão em cada tarefa.

• 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 temporização da confirmação para diagnóstico local.
• Os uploads no chat aceitam imagens e arquivos que não sejam vídeos. As imagens mantêm o caminho de imagem nativo; os demais arquivos são armazenados como mídia gerenciada e exibidos no histórico como links de anexos.
• Reenviar com o mesmo idempotencyKey retorna { status: "in_flight" } durante a execução e { status: "ok" } após a conclusão.
• As respostas de chat.history têm tamanho limitado para a segurança da interface. Quando as entradas da 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 espaço reservado ([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 da transcrição normalizada para exibição por meio de chat.message.get, usando sessionKey, o agentId ativo quando necessário e o messageId da transcrição. Se o Gateway ainda não puder retornar mais conteúdo, o leitor mostrará um estado explicitamente indisponível em vez de repetir silenciosamente a prévia truncada.
• Imagens geradas ou fornecidas pelo assistente são mantidas como referências de mídia gerenciada e disponibilizadas novamente por URLs de mídia autenticadas do Gateway, para que os recarregamentos não dependam da permanência de cargas úteis de imagem base64 brutas na resposta do histórico do chat.
• Ao renderizar chat.history, a Control UI remove do texto visível do assistente as tags de diretivas em linha usadas somente para exibição (por exemplo, [[reply_to_*]] e [[audio_as_voice]]), as cargas úteis XML de chamadas de ferramentas em texto simples (incluindo <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> e blocos truncados de chamadas de ferramentas) e tokens de controle do modelo em ASCII ou largura completa que tenham vazado. Ela omite entradas do assistente cujo texto visível inteiro contenha apenas 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 do chat mantém visíveis as mensagens locais otimistas do usuário e do assistente 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 é atualizado.
• Os eventos chat em tempo real representam o estado da entrega, enquanto chat.history é reconstruído a partir da transcrição persistente da sessão. Após eventos finais de ferramentas, 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 acrescenta uma observação do assistente à transcrição da sessão e transmite um evento chat para atualizações somente da interface, sem execução do agente nem entrega ao canal.
• A barra lateral lista todas as sessões ativas carregadas, organizadas por seção de agente e pelos grupos fixadas/canal/trabalho/personalizadas/Chats, com uma única ação Nova sessão que abre a caixa de diálogo de rascunho. Abrir uma linha visível apenas move o destaque. Grupos personalizados podem ser recolhidos e reordenados por arrastar, e as sessões podem ser soltas em um grupo ou em Chats; os nomes e a ordem dos grupos são sincronizados pelo Gateway, enquanto o estado recolhido permanece no navegador. Uma nova sessão do painel recebe de forma assíncrona um título conciso gerado a partir de sua primeira mensagem que não seja um comando; nomes explícitos nunca são substituídos. Defina agents.defaults.utilityModel (ou agents.list[].utilityModel) para encaminhar essa chamada de modelo separada a um modelo de menor custo. Expandir a seção de outro agente permite navegar pelas sessões desse agente sem sair do chat aberto.
• A pesquisa de sessões fica na paleta de comandos (⌘K ou o campo Pesquisar na parte superior da barra lateral): ao digitar uma consulta, ela percorre um número limitado de páginas correspondentes entre os agentes, filtra linhas internas de sessões filhas/Cron e lista as correspondências visíveis ao lado dos comandos de navegação. A página Sessões mantém a lista completa e pesquisável com filtros.
• Cada linha da barra lateral mantém acesso direto à fixação e um menu de contexto completo para estado de não lida, renomeação, bifurcação, agrupamento, arquivamento e exclusão. Linhas selecionadas em conjunto (Cmd/Ctrl-clique, Shift-clique para intervalos) recebem um menu em lote que abrange estado de não lida, agrupamento, arquivamento e exclusão; o arquivamento e a exclusão em lote permanecem desativados, a menos que todas as sessões selecionadas possam ser arquivadas. Uma execução ativa e a sessão principal de um agente não podem ser arquivadas. Arquivar ou excluir a sessão atualmente selecionada faz o Chat voltar à sessão principal desse agente.
• No aplicativo para macOS, a marca do OpenClaw usa a faixa nativa da barra de título que normalmente fica vazia, ao lado dos controles da janela, em vez de ocupar uma linha da barra lateral.
• Em larguras de desktop, os controles do chat permanecem em uma única linha compacta e são recolhidos ao rolar a transcrição para baixo; rolar para cima, voltar ao topo ou chegar ao fim restaura os controles.
• Mensagens consecutivas duplicadas contendo apenas texto são renderizadas como um único balão com um indicador de quantidade. Mensagens que contêm imagens, anexos, saída de ferramentas ou prévias do Canvas não são agrupadas.
• Quando o checkout de uma sessão está em uma branch não padrão de um repositório do GitHub, a visualização do chat fixa indicadores de pull requests acima do compositor: número da PR, repositório, branch, contagens do diff, um indicador de CI e estado de rascunho/mesclada/fechada, cada um com link para a PR. A linha mostra no máximo dois indicadores — primeiro as PRs ativas (abertas/em rascunho) —, e um botão "Mostrar mais" revela o histórico recolhido de PRs mescladas/fechadas. O indicador de CI abre um pequeno popover de monitoramento da CI com contagens de verificações aprovadas/com falha/em execução/ignoradas e um link para a página de verificações da PR. A detecção é executada no servidor por meio de controlUi.sessionPullRequests, que reutiliza GH_TOKEN/GITHUB_TOKEN do Gateway quando definidos. Quando o limite de taxa da API do GitHub é atingido, os indicadores mantêm o último estado conhecido e mostram um aviso de que o estado pode estar desatualizado; dispensar um indicador o oculta para essa sessão no perfil atual do navegador. Antes de existir qualquer PR, a linha mostra a própria branch — repositório, nome da branch e tamanho +/− do diff em relação à base de mesclagem da branch padrão (trabalho confirmado e não confirmado) — com um botão Criar PR que abre a página de novo pull request do GitHub. A linha aparece assim que a branch enviada tem commits para comparar e se oculta enquanto existe uma PR aberta ou em rascunho. A linha da branch usa apenas o git local, portanto continua disponível enquanto o GitHub está com limitação de taxa e exibe o mesmo aviso de estado desatualizado, pois não é possível confiar em "nenhuma PR encontrada" até que o limite seja redefinido.
• O painel de diff da sessão mostra o que o checkout de uma sessão realmente alterou: o botão da branch (no cabeçalho da área lateral do espaço de trabalho, no cabeçalho do painel dividido ou no botão flutuante do chat em painel único) abre o painel de detalhes com um diff por arquivo do trabalho da branch, não confirmado e não rastreado em relação à base de mesclagem da branch padrão do checkout — ponto de estado, seta de renomeação, contagens +/− por arquivo, arquivos recolhíveis e marcadores de "N linhas não modificadas" entre trechos. Os diffs são calculados no servidor pelo método sessions.diff do Gateway (escopo operator.read); arquivos binários e grandes demais são reduzidos a entradas contendo apenas estatísticas, e o botão aparece somente quando o Gateway conectado anuncia sessions.diff.
• A área lateral do espaço de trabalho da sessão em cada painel do Chat lista arquivos da sessão, arquivos do projeto e artefatos. Por padrão, ela fica encaixada na borda direita do painel; arraste seu cabeçalho (ou use o botão de encaixe) para movê-la para a parte inferior, e a escolha será armazenada no perfil atual do navegador. Uma área lateral recolhida não ocupa espaço algum: reabra-a com ⇧⌘B, o alternador de arquivos no cabeçalho do painel dividido ou o botão flutuante de arquivos no chat em painel único (ambos exibem um indicador da quantidade de arquivos alterados). O painel separado de detalhes de arquivos, ferramentas e Canvas não é afetado.
• Clicar em uma referência de arquivo no chat, em um caminho de arquivo em um cartão expandido de ferramenta de leitura/edição/gravação ou em uma linha de arquivo na área lateral do espaço de trabalho abre o painel de detalhes do arquivo: uma visualização de código baseada no CodeMirror, com realce de sintaxe, números de linha, salto para linha, pesquisa no arquivo, ações de cópia e um menu para abrir em um editor externo. Quando o Gateway anuncia sessions.files.set para uma conexão operator.admin, o painel adiciona um modo Editar com acompanhamento de alterações não salvas e salvamento por Cmd/Ctrl-S; rascunhos não salvos persistem durante a navegação entre arquivos, painéis e sessões na aba atual do navegador até serem explicitamente salvos ou descartados. Os salvamentos usam comparação e troca com base em um hash do conteúdo retornado por sessions.files.get: se o arquivo tiver sido alterado no disco desde que foi carregado (por exemplo, porque o agente continuou trabalhando), o painel mostrará um aviso de conflito com as ações Recarregar (usar o conteúdo mais recente) e Sobrescrever (manter a edição local). As gravações passam pelas mesmas proteções de segurança do sistema de arquivos do espaço de trabalho usadas nas leituras — contenção de caminho, rejeição de links simbólicos/físicos e limite de 256 KB em UTF-8 — e apenas sobrescrevem arquivos existentes; o editor nunca os cria nem exclui.
• A área lateral de tarefas em segundo plano em cada painel do Chat lista as tarefas em segundo plano e os subagentes do agente atual (tasks.list com escopo por agente, mantido atualizado por eventos task): o trabalho em execução mostra um cronômetro decorrido em tempo real, a contagem de usos de ferramentas, a ferramenta atualmente em uso e um controle de interrupção; a seção recolhível de tarefas concluídas adiciona as durações das execuções; e um link Ver transcrição abre a sessão filha da tarefa no painel. Abra-a com o alternador de atividade no cabeçalho do painel dividido ou com o botão flutuante de atividade no chat em painel único — o snapshot das tarefas é carregado antecipadamente, portanto ambos exibem um indicador da quantidade em execução sem que seja necessário abrir primeiro a área lateral. A página Tarefas continua sendo o registro completo entre agentes.
• A área lateral do espaço de trabalho, a área lateral de tarefas em segundo plano e o painel de detalhes se adaptam à largura de cada painel, e não à da janela: em um painel estreito ou uma janela compacta, ambas as áreas laterais são exibidas como faixas inferiores (os controles de encaixe lateral ficam ocultos até que o painel fique mais largo; a área lateral do espaço de trabalho tem prioridade sobre o espaço lateral quando cabe apenas uma coluna), e o painel de detalhes é empilhado abaixo da conversa, com uma alça de redimensionamento horizontal, em vez de compartilhar a mesma linha. Em áreas de visualização do tamanho de um celular, o painel de detalhes ainda é aberto em tela cheia.
• Os seletores de modelo e raciocínio do cabeçalho do chat atualizam imediatamente a sessão ativa por meio de sessions.patch; eles são substituições persistentes da sessão, não opções de envio válidas para apenas um turno.
• Visualização dividida: abra-a pela linha de alternadores flutuantes no canto superior direito (ao lado dos alternadores de diff da sessão, tarefas em segundo plano e arquivos da sessão) e divida o painel ativo para a direita ou para baixo em quantos painéis couberem. Cada painel tem sua própria sessão, transcrição, compositor e fluxo de ferramentas.
• Arraste uma sessão da barra lateral para o chat para abri-la em um painel. Uma prévia animada do destino desliza entre as zonas e identifica o resultado — "Dividir" sobre a metade exata que um novo painel ocupará, "Abrir aqui" sobre um painel inteiro —, e também é possível soltar no modo de painel único.
• O painel dividido ativo determina a seleção da barra lateral e a URL. Cada painel tem sua própria linha de cabeçalho com o título da sessão e controles da área lateral do espaço de trabalho, divisão e fechamento; os divisores redimensionam colunas e painéis empilhados, e o navegador armazena o layout localmente entre recarregamentos.
• Em telas estreitas, a visualização dividida mantém o layout, mas renderiza somente o painel ativo, incluindo seu cabeçalho com o controle de fechamento.
• Se você enviar uma mensagem enquanto uma alteração no seletor de modelo da mesma sessão ainda estiver sendo salva, o compositor aguardará a atualização dessa sessão antes de chamar chat.send, garantindo que o envio use o modelo selecionado.
• Digitar /new cria e muda para a mesma nova sessão do painel que Novo chat, exceto quando session.dmScope: "main" está configurado e o pai atual é a sessão principal do agente; nesse caso, ele redefine a sessão principal no local. Digitar /reset mantém a redefinição explícita no local do Gateway para a sessão atual.
• O seletor de modelo do chat solicita a visualização de modelos configurada no Gateway. Se agents.defaults.models estiver presente, essa lista de permissões determinará o seletor, incluindo entradas provider/* que mantêm dinâmicos os catálogos com escopo por provedor. Caso contrário, o seletor mostrará entradas models.providers.*.models explícitas e provedores com autenticação utilizável. O catálogo completo continua disponível pelo RPC de depuração models.list com view: "all".
• Quando relatórios recentes de uso da sessão do Gateway incluem os tokens de contexto atuais, a barra de ferramentas do compositor de chat exibe um pequeno anel de uso do contexto com a porcentagem utilizada. Abra o anel para ver a janela de contexto atual, as contagens de tokens da execução mais recente e o custo total estimado, a identificação do provedor/modelo e, quando informado, o detalhamento de custos de entrada/saída/cache da resposta mais recente do provedor. O anel muda para o estilo de alerta quando há alta pressão sobre o contexto e, nos níveis recomendados de Compaction, exibe um botão compacto que executa o fluxo normal de Compaction da sessão. Instantâneos de tokens desatualizados ficam ocultos até que o Gateway informe novamente dados de uso recentes.

O modo de conversa usa um provedor de voz em tempo real registrado. Configure a OpenAI com talk.realtime.provider: "openai" mais um perfil de chave de API openai, talk.realtime.providers.openai.apiKey ou OPENAI_API_KEY. O OpenAI Realtime usa a API pública da Platform e exige uma chave de API da Platform; um login OAuth do Codex não atende a essa interface. Configure o Google com talk.realtime.provider: "google" mais talk.realtime.providers.google.apiKey. O navegador nunca recebe uma chave de API padrão do provedor: a OpenAI recebe um segredo efêmero de cliente do Realtime para WebRTC, e o Google Live recebe um token de autenticação restrito e de uso único da Live API para uma sessão WebSocket do navegador, com instruções e declarações de ferramentas bloqueadas no token pelo Gateway. Provedores que oferecem apenas uma ponte de tempo real no backend são executados pelo transporte de retransmissão do Gateway, de modo que as credenciais e os sockets do fornecedor permanecem no lado do servidor enquanto o áudio do navegador trafega por RPCs autenticadas do Gateway. O prompt da sessão Realtime é montado pelo Gateway; talk.client.create não aceita substituições de instruções fornecidas pelo chamador.

Os padrões persistentes de provedor, modelo, voz, transporte, esforço de raciocínio, limite exato de VAD, duração do silêncio e preenchimento do prefixo ficam em Settings → Communications → Talk; alterá-los exige acesso operator.admin. Configurar a retransmissão do Gateway força o caminho de retransmissão pelo backend; configurar WebRTC mantém a sessão sob controle do cliente e falha, em vez de recorrer silenciosamente à retransmissão, se o provedor não puder criar uma sessão no navegador.

O próprio controle de conversa é o botão de microfone na barra de ferramentas do compositor. O menu desse botão lista System default e todos os microfones disponibilizados pelo navegador, incluindo entradas USB, Bluetooth e virtuais. O ID do dispositivo selecionado permanece local no navegador e nunca é enviado ao Gateway; se esse dispositivo exato desaparecer, o modo de conversa solicitará que você escolha outra entrada, em vez de gravar silenciosamente com outro microfone. Enquanto o modo de conversa estiver ativo, o botão do microfone se transformará em um botão em formato de cápsula que exibe o medidor do nível de entrada em tempo real; clicar nele interrompe a entrada de voz, e passar o cursor sobre ele revela o glifo de interrupção. Os leitores de tela anunciam Connecting voice input..., Listening... ou Asking OpenClaw... enquanto uma chamada de ferramenta em tempo real consulta o modelo maior configurado por meio de talk.client.toolCall. Interromper uma resposta em execução do agente continua sendo uma ação separada no controle quadrado Stop, ao lado da cápsula.

Teste rápido ao vivo para mantenedores: OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts verifica a ponte WebSocket do backend da OpenAI, a troca de SDP WebRTC no navegador da OpenAI, a configuração do WebSocket do Google Live no navegador com token restrito e o adaptador de retransmissão do Gateway para navegador com mídia de microfone simulada. O comando imprime apenas o status do provedor e não registra segredos.

• Clique em Stop (chama chat.abort).
• Enquanto uma execução estiver ativa, os acompanhamentos normais entram na fila. Clique em Steer em uma mensagem na fila para injetar esse acompanhamento no turno em execução.
• Digite /stop (ou frases de cancelamento isoladas, como stop, stop action, stop run, stop openclaw, please stop) para abortar fora de banda.
• chat.abort aceita { 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 exibido na interface.
• O Gateway persiste no histórico da transcrição o texto parcial abortado do assistente quando há saída no buffer.
• As entradas persistidas incluem metadados de aborto para que os consumidores da transcrição possam distinguir resultados parciais abortados da saída de uma conclusão normal.

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

allowInsecureAuth é apenas uma opção de compatibilidade local:

• Ela permite que sessões locais da Control UI prossigam sem identidade do dispositivo em contextos HTTP não seguros.
• Ela não ignora as verificações de pareamento.
• Ela não flexibiliza os requisitos de identidade do dispositivo para acesso remoto (fora do localhost).

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

• gatewayUrl é armazenado no localStorage após o carregamento e removido da URL.
• Se você fornecer um endpoint ws:// ou wss:// completo por meio de gatewayUrl, codifique o valor para URL para que o navegador analise a string de consulta corretamente.
• Sempre que possível, token deve ser fornecido pelo fragmento da URL (#token=...). Fragmentos não são enviados ao servidor, o que evita vazamentos em logs de solicitações e no Referer. Parâmetros de consulta legados ?token= ainda são importados uma única vez para fins de compatibilidade, mas apenas como fallback, e são removidos imediatamente após a inicialização.
• password é mantido somente na memória.
• Quando gatewayUrl está definido, a interface não recorre a credenciais de configuração ou de ambiente. Forneça token (ou password) explicitamente; a ausência de credenciais explícitas é um erro.
• Use wss:// quando o Gateway estiver protegido por TLS (Tailscale Serve, proxy HTTPS etc.).
• gatewayUrl só é aceito em uma janela de nível superior (não incorporada), para evitar clickjacking.
• Implantações públicas da Control UI fora do loopback devem definir gateway.controlUi.allowedOrigins explicitamente (origens completas). Carregamentos privados de mesma origem em LAN/Tailnet provenientes de hosts de loopback, RFC1918/link-local, .local, .ts.net ou Tailscale CGNAT são aceitos sem ativar o fallback do cabeçalho Host.
• A inicialização do Gateway pode preencher origens locais, como http://localhost:<port> e http://127.0.0.1:<port>, com base no endereço e na porta efetivos de vinculação 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 ao host que estou usando".
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true ativa o modo de fallback de origem pelo cabeçalho Host, mas esse é um modo de segurança perigoso.