🎛️ Configurar e estender

/parar [tudo|agentes|<agente>] [motivo] liga um interruptor que fica gravado na tabela prefs e sobrevive a restart. /retomar desliga. Ligar cancela o que está em voo nas lanes chat, agente e io que bate com o alvo.

É o freio de mão. Quando um agente começa a fazer besteira, /parar agentes segura o despacho sem derrubar o serviço nem perder o histórico da fila.

prefs · alvo tudo, agentes, agente:id · lane ollama segue livre · até 30 s para o processo morrer

/fila collect|followup|steer|interrupt define, por chat, o que fazer com uma mensagem que chega enquanto outra está em curso. O padrão é collect: junta mensagens seguidas por 2 s e responde uma vez.

Dois dos quatro modos têm limite honesto frente ao openclaw: steer não injeta no agente em execução e interrupt descarta a resposta direta em voo em vez de abortar.

janela de 2 s · prioridade alta · flow_ref canal:chat · contador de geração

O prompt soma sempre nesta ordem: IDENTIDADE.md na raiz (a base, nunca sai), agents/<id>/SOUL.md (persona fixa do agente) e personalidades/<nome>.md, escolhida por chat com /personality <nome>.

Criar uma voz nova é criar um arquivo .md. Saber qual camada manda evita a briga entre uma regra da identidade e um pedido da personalidade.

IDENTIDADE.md · SOUL.md pede restart · curto e professor · trocar apaga a sessão retomada

/context [detail] [texto] conta os tokens de cada camada do prompt (identidade, persona, USER.md, memória e insights, histórico, skills, regras, mensagem), para a resposta direta e para o agente, sem chamar modelo de chat.

Overhead fixo é o que você paga em toda mensagem. Medir mostra qual camada cresceu antes de você sair cortando memória boa.

camadas do prompt · detail lista os itens · retrieval só leitura · saliência intacta

A chave mcp_config: mcp.json no agents/<id>/agent.yaml faz o claude -p subir com --mcp-config <arquivo> --strict-mcp-config. O agente enxerga só os servidores daquele arquivo.

Sem a chave, o agente herda todos os MCP do seu ~/.claude. Com ela, um especialista de pesquisa não ganha por acidente uma ferramenta que escreve.

MCP · caminho relativo à pasta do agente · mcp.json.example · strict

/ajuda lista os comandos por grupo, incluindo o bloco "Controle da conversa". /ajuda <comando> abre o detalhe de parar, retomar, fila, personality e context.

Esses cinco comandos nasceram na versão 3.2.1 e foram corrigidos na 3.2.2. O CHANGELOG diz o que mudou e a seção 9b do README diz como funciona hoje.

3.2.1 fase 9 · 3.2.2 interrupt em voo · 3.2.3 documentação · README seção 9b

Cada pasta em agents/ com um agent.yaml vira um agente. O model é reduzido a um alias da CLI (opus, sonnet, haiku, fable), e effort, read_only e cwd completam o registro. O prompt vem do CLAUDE.md da pasta.

O desenho é N especialistas só leitura em paralelo mais um lead com escrita. Errar o read_only é dar caneta a quem devia só pesquisar.

agents/comms, content, ops, research · lead sonnet · pasta com _ é ignorada · restart para reler

Uma skill é um skills/<id>/SKILL.md com name e description no cabeçalho. Só esses dois campos entram no prompt; o corpo é lido sob demanda por quem executa. /skills lista o que está instalado.

Quinze skills vieram do v2 como estão. Como só a descrição custa tokens, a descrição é a parte que precisa estar boa: é ela que faz a skill ser escolhida.

front matter · skills/_rascunhos · loop de aprendizado · decisão 6 do plano

Toda chamada de modelo passa por src/custo/gateway.ts, inclusive embeddings. Três tiers: local no Ollama com custo zero, barato no haiku e premium para a rota de agente. config/precos.yaml tem o USD por 1M de tokens.

O orçamento em config/orcamento.yaml avisa em 70 % e trava em 100 %, quando só o Ollama passa. Saber disso evita o susto de "o bot parou de chamar agente".

chamadas_llm · ORCAMENTO_MENSAL_USD · /usage por tier e por agente · motivo do upgrade registrado

config/ollama.yaml dá um modelo a cada papel: roteador em llama3.2, geral em qwen3.8:27b residente, embed em bge-m3 e pesado desligado. O preflight checa RAM antes de cada chamada local.

São as mesmas tags do v2 de propósito: um único modelo grande serve os dois bots. Trocar a tag do geral sem trocar no v2 põe dois modelões na memória.

piso_ram_gb 40 · descarregar_alheios false · keep_alive -1 · /ollama preflight

Slack tem cliente e probe de OAuth no doctor, mas fica desligado até o corte porque o token é do v2. WhatsApp é um stub que recusa enquanto o v2 é dono da sessão do número. O canal HTTP aceita POST /mensagem.

Esses desligamentos não são bug: são a regra da coexistência. E o HTTP dispara agente com permissões, então expor na rede exige as duas variáveis certas.

SLACK_ENABLED e WHATSAPP_ENABLED em 0 · HTTP_BIND_V3 · DASHBOARD_TOKEN_V3 · dashboard só leitura

A fase 8 é o corte: trocar o token de produção, deixar o v2 só leitura por 30 dias e arquivar. A fase 10 está anotada em docs/INCORPORAR-V3.md: cliente MCP nativo no caminho Ollama, servidor MCP do inemavox e voz no Telegram.

Saber o que ainda não existe evita procurar botão que não tem. A lista do que falta está na seção 15 do README, escrita pelo próprio projeto.

paridade antes do corte · fase 11 Jarvis aprende · Hermes e openclaw como fontes · steer sem injeção