# Naia Openclaw

Pacote portátil com ferramenta `jev_decide` e skill de uso. Não instala hooks automáticos, não altera mensagens, modelo ou permissões. A skill orienta; o plugin registra uma ferramenta que faz chamadas HTTP reais quando invocada.

## Compatibilidade e instalação

Versão-alvo do host: OpenClaw **2026.9.5**, versão retornada pelo registro npm em 20/09/2026. APIs de plugin são experimentais. A documentação atual pede Node 24.16 ou superior na linha 24, ou 26.1+. Contrato de manifest e registro conferido nas fontes oficiais. Este pacote recebeu validação estática e de registro simulado; não foi instalado em um gateway de aluno nem há garantia para outras versões.

1. Extraia esta pasta para um local estável do seu servidor. Não use uma pasta temporária se instalar com `--link`.
2. Antes, confira se já há plugin ou ferramenta `jev_decide`. Não duplique integrações existentes. Faça backup da configuração e preserve permissões atuais.
3. Injete `TYPESAFE_API_KEY` no processo do gateway pelo gerenciador de segredos. Não coloque a chave neste pacote ou na configuração pública.
4. Execute `openclaw plugins install --link ./naia-openclaw` apontando para esta pasta. Não use `--force` para sobrescrever uma instalação.
5. Execute `openclaw plugins enable naia-jev-openclaw`.
6. Preserve a política de ferramentas. Caso sua configuração use uma lista restrita, acrescente somente `jev_decide` para o agente desejado; não substitua a lista nem habilite execução geral.
7. Reinicie seu gateway em uma janela adequada e execute `openclaw plugins inspect naia-jev-openclaw --runtime --json`. Confirme o registro da ferramenta. Inspecionar registro não envia um request Jev.
8. Em nova sessão, peça uma única classificação sintética agrupada. Exemplo: “Use jev_decide para classificar 'Comprei o curso e não consigo entrar' entre acesso/cobrança/outros, e avaliar se pede atendimento humano. Não envie mensagens nem altere contas.”

Não há `npm install` necessário neste pacote: o único import externo é o SDK fornecido pelo host. Os parâmetros são JSON Schema compatível; o cliente usa fetch nativo. Se sua versão rejeitar o manifest ou SDK, pare e compare a documentação dessa versão. Não remova validações para forçar carregamento.

## Comportamento exato

Ferramenta consultiva por invocação, sem varrer toda mensagem automaticamente. Cliente aceita estado string/objeto/lista e até 16 perguntas Choice/Noul/Score em 24 KB. Choice tem 2–100 opções; Score tem 2–10 níveis. Modelo fixo `jev-1.13.0`; deadline de fetch 2 segundos; validação de resposta. Retorno `available:false` em chave ausente, argumentos inválidos, erro ou resposta inválida. Sem retry automático, cache persistente, logs de conteúdo ou alteração de autorização. O agente deve seguir o fluxo anterior quando indisponível.

Nenhuma confiança concede permissão para enviar, cobrar, apagar ou executar. Não misture dados de contas e minimize o conteúdo enviado à API externa. Para ativação automática por evento, crie uma integração separada com deduplicação, observação e comparação de baseline.

## Reversão

Desabilite com `openclaw plugins disable naia-jev-openclaw` e reinicie seu gateway. Remova apenas a permissão específica e o link que você adicionou, preservando outras integrações. Não apague uma pasta com alterações suas.

## English

Advisory tool and skill package for Naia Openclaw. Target host version: OpenClaw 2026.9.5 (npm registry checked September 20, 2026); plugin APIs are experimental. Current docs require Node 24.16 or later within major 24, or 26.1+. Contract and syntax were checked; registration was tested with a mock API. No student gateway installation was performed.

Extract to a permanent directory. Check for an existing `jev_decide` integration and back up configuration. Inject `TYPESAFE_API_KEY` into the gateway process. Run `openclaw plugins install --link ./naia-openclaw`, then `openclaw plugins enable naia-jev-openclaw`. Preserve tool policy and add only `jev_decide` where an allowlist requires it. Restart your gateway, inspect with `openclaw plugins inspect naia-jev-openclaw --runtime --json`, then use one synthetic batch. No npm dependencies are required; the host provides the plugin SDK.

Only explicit tool invocation triggers HTTP calls. Limits: 24 KB, 16 questions, Choice 2–100 options, Score 2–10 levels. Model jev-1.13.0, two-second fetch deadline, validated answers, no persistent cache or automatic retries. On `available:false`, preserve the existing workflow. Confidence never authorizes external actions. Roll back using `openclaw plugins disable naia-jev-openclaw`, remove only your additions, and restart.

## Español

Paquete de herramienta consultiva y skill para Naia Openclaw. Host objetivo OpenClaw 2026.9.5, consultado en npm el 20/09/2026. API experimental; documentación actual requiere Node 24.16 o posterior dentro de la versión 24, o 26.1+. Se verificaron contrato, sintaxis y registro simulado; no se instaló en un gateway de alumno.

Extrae en una carpeta permanente. Comprueba si ya existe `jev_decide` y respalda la configuración. Inyecta `TYPESAFE_API_KEY` en el gateway. Ejecuta `openclaw plugins install --link ./naia-openclaw` y `openclaw plugins enable naia-jev-openclaw`. Conserva la política de herramientas; añade solo `jev_decide` donde corresponda. Reinicia tu gateway y revisa `openclaw plugins inspect naia-jev-openclaw --runtime --json`. Después usa un lote sintético. No requiere npm install; el host proporciona el SDK.

Solo la invocación explícita activa llamadas HTTP. Límites: 24 KB, 16 preguntas, Choice 2–100 opciones y Score 2–10 niveles. Modelo jev-1.13.0, plazo fetch de dos segundos, respuestas validadas, sin caché persistente ni reintentos automáticos. Ante `available:false`, conserva el flujo previo. La confianza no autoriza acciones externas. Para revertir, deshabilita con `openclaw plugins disable naia-jev-openclaw`, retira solo tus añadidos y reinicia.

## Fontes / Sources / Fuentes

- https://docs.openclaw.ai/plugins/building-plugins
- https://docs.openclaw.ai/plugins/manifest
- https://docs.openclaw.ai/cli/plugins/install
- https://www.npmjs.com/package/openclaw/v/2026.9.5
- https://docs.typesafe.ai/api