Provider local ou externo, sem expor a chave
O plugin AI Chat continua usando Ollama local por padrão. Você pode apontar para um serviço com chave própria direto na tela, sem mexer em arquivo e sem reiniciar a plataforma.
Na tela (por bot)
Configurações → “Provider de IA”. Escolha o serviço, o endpoint e o modelo, cole a sua chave e clique em “Testar conexão” antes de salvar: o botão mostra o motivo real de uma falha (status HTTP e o que o serviço respondeu), em vez de um “ok” genérico.
- Ollama local — sem chave, sem custo
- OpenAI, Groq, OpenRouter, DeepSeek, Together, LM Studio, vLLM, llama.cpp, LiteLLM
- Anthropic
- Google Gemini
- Serviço próprio (custom)
- — A chave é write-only: entra e nunca volta. A tela só mostra os últimos 4 caracteres.
- — Trocar o endpoint com o campo da chave em branco mantém a chave que já estava salva.
- — A configuração só entra em vigor quando o bot reinicia — o provider é resolvido na hora que o plugin é construído.
- — Só o dono do bot vê esta seção. A plataforma confere a propriedade em leitura e escrita.
- — Se a configuração estiver inválida, o bot sobe normalmente e só a resposta de IA fica desligada.
No servidor (global)
Vale para todos os bots e é o que o plugin usa quando um bot não tem configuração própria. `external` continua disponível para quem já usava: URL exata + Bearer.
AI_PROVIDER=external
AI_ENDPOINT=https://seu-endpoint/v1/generate
AI_API_KEY=chave-write-only
AI_MODEL=modelo
AI_TIMEOUT_MS=15000
AI_RATE_LIMIT_PER_MINUTE=12
AI_ALLOWED_ACTIONS=follow,come,stop,collect,equipRegras de segurança
- ✓ A chave nunca usa NEXT_PUBLIC_ e nunca volta ao navegador — nem pela resposta que confirma o salvamento.
- ✓ Ela fica em arquivo com permissão restrita (0600), não no banco.
- ✓ Respostas passam por schema e limites de tamanho.
- ✓ attack e mine ficam bloqueados por padrão.
- ✓ Delay, onlyWhisper e rate limit por jogador são aplicados.
Para Ollama local
AI_PROVIDER=ollama
OLLAMA_URL=http://127.0.0.1:11434
AI_MODEL=llama3.2:1bSe a IA não responder
O chat engole erro de propósito (uma falha de IA não pode derrubar o bot), então silêncio no chat é o comportamento normal quando algo falha. Use “Testar conexão”: ele mostra status e o detalhe que o serviço devolveu. Se o teste passar e o chat não responder, confira se a ação pedida está na allowlist.