// guias · config

Exemplos de configuração

Arquivos prontos para copiar/adaptar. Eles documentam padrões comuns sem obrigar o usuário a montar YAML do zero.

Arquivos disponíveis

arquivo	uso
`docs/examples/lmstudio.local.yaml`	Provider local OpenAI-compat para LMStudio.
`docs/examples/codex.local.yaml`	Codex por OAuth/subscription com raciocínio alto.
`docs/examples/claude.local.yaml`	Claude via CLI autenticado.
`docs/examples/telegram-agent.yaml`	Agente roteado para Telegram.
`docs/examples/production-strict.yaml`	Postura endurecida para gateway/API expostos.
`docs/examples/mcp.github.yaml`	Servidor MCP GitHub com token via env.

Provider local: LMStudio

docs/examples/lmstudio.local.yaml

default_provider: lmstudio
providers:
  lmstudio:
    model: openai/qwen3.5-4b-mtp
    api_base: http://localhost:4480/v1
    api_key: lm-studio
    auth: api_key
    tier: local
    context_window: 32768

Provider forte: Codex

docs/examples/codex.local.yaml

default_provider: codex
providers:
  codex:
    model: openai-codex/gpt-5.5
    auth: oauth_subscription
    transport: codex_oauth
    tier: strong
    context_window: 256000
    reasoning_effort: high

Gateway/API em produção

docs/examples/production-strict.yaml

approval:
  mode: smart
gateway:
  require_token: true
security:
  forbid_public_bind: true
sandbox:
  require_isolation: true
  backend: docker
retention:
  sessions: { days: 30, keep: 10 }
  checkpoints: { days: 14, keep: 50 }
  tool_outputs: { days: 7, keep: 200 }

Agente Telegram

docs/examples/telegram-agent.yaml

agents:
  support:
    name: Support
    match:
      - telegram:*
    telegram:
      token_env: TELEGRAM_TOKEN
gateway:
  reactions: true
  max_sessions: 500

MCP GitHub

docs/examples/mcp.github.yaml

mcp:
  github:
    command: npx
    args:
      - -y
      - "@modelcontextprotocol/server-github"
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: ${GITHUB_TOKEN}

Aplicar como base local

cp docs/examples/lmstudio.local.yaml okami.local.yaml
okami doctor
okami chat

Compor trechos

Os exemplos são pequenos de propósito. Use como patch mental: copie o bloco relevante para okami.local.yaml ou para o agent.yaml específico, mantendo segredo sempre em .env.

Checklist antes de usar

okami doctor --lintverifica provider, auth, toolchain, sandbox e postura

okami policy check --strictobrigatório antes de expor gateway/API

okami config showconfirma config efetiva sem abrir segredo

okami auth listaudita quais providers estão autenticados

Schema de configChaves reais extraídas do okami.yaml.Providers & authComo autenticação e transports se combinam.Self-hostingDocker, API e gateway com isolamento.

Abrir esta página nos docs interativos