🧭 Regras Contextuais

Regra contextual é uma regra local que faz o bot agir de um jeito específico em um contexto específico.

Ela é útil quando você quer que o bot mantenha um comportamento recorrente em determinado grupo, com certo contato, ou quando aparecer um assunto específico.

O que uma regra contextual precisa ter?

Pra fazer sentido, normalmente ela precisa ter:

contexto claro — grupo, contato ou assunto recorrente
gatilho claro — algo objetivo que dá pra reconhecer
comportamento reaplicável — algo que deve continuar valendo naquele contexto
critério objetivo e verificável — sem depender de interpretação vaga

Resumo curto:

Se a orientação precisa sobreviver à conversa e reaparecer no mesmo contexto, tende a ser regra contextual. Se vale só agora, é só um pedido da conversa.

Exemplos de regra contextual

"Neste grupo, só responda quando for chamado"
"Quando falarem de orçamento aqui, responda de forma curta e objetiva"
"Com este contato, quando surgir tema X, siga o procedimento Y"

O que não vira regra contextual

pedido de uma vez só
preferência passageira
instrução vaga, como "quando achar melhor"
regra estrutural ou global do bot

Regra contextual vs missão

Essa diferença costuma confundir:

Regra contextual: permanente naquele contexto até alguém mudar; serve para ajustar o comportamento do bot.
Missão: temporária até um desfecho; serve para acompanhar um objetivo.

Resumo curto:

missão é provisória
regra contextual é permanente até ser alterada ou removida

Ou seja:

se você quer que o bot acompanhe uma situação até resolver, isso é missão
se você quer que o bot passe a agir de um certo jeito naquele contexto, isso é regra contextual

Regra contextual vs protocolo global

Regra contextual não muda a constituição do agente. Ela muda a conduta local.

Já o protocolo global é uma regra mais ampla do funcionamento do bot.

Exemplo:

Regra contextual: "neste grupo, só responder quando for chamado"
Protocolo global: "nunca apagar algo importante sem confirmar antes"

Regra contextual ajusta comportamento local. Protocolo global muda regra geral do bot.

Se houver conflito, a regra global vence. Regras contextuais também não passam por cima de permissão, privacidade, RBAC ou instruções estruturais do bot.

Como as regras podem ser vinculadas?

Uma regra contextual pode ser vinculada de formas diferentes. Na prática, ela pode valer por:

grupo
contato
palavra-chave
ou uma combinação dessas coisas

Exemplos simples:

valer só em um grupo específico
valer só quando uma certa pessoa falar
valer quando aparecer a palavra orçamento
valer num grupo específico e quando aparecer certa palavra

Ou seja, a regra não precisa ser geral. Ela pode ser bem localizada.

Regras simples e regras combinadas

Uma regra pode ser simples:

vale para um grupo
vale para um contato
vale quando aparece uma palavra-chave
vale globalmente

Também pode ser combinada. Por exemplo:

valer em um grupo ou para um contato específico
valer só quando for em certo grupo e aparecer a palavra orçamento
valer para um contato e para um assunto recorrente

Em termos práticos: o bot consegue tratar regras com lógica de OU e E. Você não precisa falar nesses termos técnicos; basta descrever o contexto com clareza.

Nota técnica para administradores

No OpenClaw atual, regras contextuais são geridas por manage_rules v3.

A estrutura usa conditions:

cada item da lista funciona como OU
and combina condições, como grupo + palavra-chave
escopos comuns: global, group, contact e keyword

Mesmo assim, regra contextual nunca passa por cima de RBAC, bootstrap, privacidade, segurança ou protocolo global.

Quem cria ou muda essas regras?

Em geral, isso é configurado pelo dono ou administrador do bot.

Se você quiser que o bot mude de comportamento num grupo, com um contato ou em certo assunto, o caminho certo é pedir isso explicitamente.