Configuração
A config global fica em okami.yaml (versionado, com hot-reload via okami reload). Credenciais ficam no .env (carregado automaticamente) — nunca no YAML. A regra: cr…
Precedência
okami.yaml— config base, versionada (sem segredos).okami.local.yaml— overrides locais não versionados (ex.: api_base do seu LMStudio)..env/~/.okami/.env— segredos (chaves, tokens); referenciados como${ENV}no YAML.
okami.yaml
default_provider: lmstudio
memory:
backend: sqlite-fts5 # | honcho | holographic
embedder: { enabled: true, model: text-embedding-nomic-embed-text-v1.5 }
contracts:
ui:
library: shadcn
component_source: '@/components/ui'
forbid_raw_css: true
forbid_inline_hex: true
require_component_source: true
learning:
auto_skill: true # destila skill de tarefa não-trivial
voice:
stt: { backend: whisper, model: small }
tts: { enabled: true, backend: edge, voice: pt-BR-AntonioNeural }Referência de chaves
params default_provider string Provider usado quando nenhum é passado. providers map Cada provider: model, api_base, auth, tier, fallback, context_window. memory map backend (sqlite-fts5 | honcho | holographic), embedder, limites de arquivo. contracts.ui map Regras duras de UI que viram gate (ver Skills). learning.auto_skill bool Destila uma skill de tarefas não-triviais. true voice map STT (Whisper) e TTS (Edge) para canais com áudio. approvals.mode enum manual | smart | off | yolo (ver Segurança). manual groups map Reuniões multi-agente (membros + moderador + cooldown). sandbox map backend (docker|local), mode, network, timeout.
.env (segredos)
# Claude → usa o CLI 'claude' (já logado); sem chave aqui
# Codex → okami login codex (device auth)
# MiniMax → okami login minimax (device flow OAuth)
MIMO_API_KEY=... # MiMo precisa de API keyHelpers
okami config showconfig efetiva (segredos mascarados)okami config set <k> <v>segredo vai pro .env, o resto pro localokami config get <k> · pathlê um valor · mostra onde ficam os arquivosokami reloadrecarrega a config em quente (sem reiniciar)