// começar · 04
Escolha o caminho certo
A documentação agora é grande de propósito. Use esta página como roteador: escolha o objetivo, siga a sequência e pule direto para as páginas que importam naquele m…
Primeiro contato
- Instalar
Comece pelo instalador e rode o doctor. No alpha, você também pode clonar o repo e revisar o script antes.
curl -fsSL https://okamiagent.com/install.sh | bash git clone https://github.com/OkamiOps/Okami-Agent && cd Okami-Agent && ./scripts/install.sh okami doctor - Configurar
Use o setup; não edite YAML no escuro.
okami setup - Conversar
Abra a TUI e valide o loop básico.
okami chat - Rodar tarefa verificável
Use exitCriteria para ver o harness trabalhando.
okami task "crie hello.txt com oi" -e file_exists:hello.txt
Por caso de uso
Construir UI confiávelSkills de frontend + contracts.ui + ui_gate.Rodar em produçãoSandbox, policy strict, retenção e API token.Conectar canaisGateway, Telegram, API HTTP e Paperclip.Trabalhar multi-agenteAgentes isolados, grupos e roteamento.Entender confiabilidadeHarness, exitCriteria, anti-loop e trace.Auditar capacidadesTools builtin, sensibilidade e comandos.
Leitura recomendada por perfil
| perfil | sequência |
|---|---|
| usuário | Quickstart → CLI básico → Skills overview → Canais & gateway |
| dev | Mapa do repo → Harness → Tools overview → Desenvolvimento |
| ops | Self-hosting → Segurança & policy → Observabilidade → Retenção |
| avaliador técnico | Evidência: task → Evidência: UI gate → Evidência: trace → Arquitetura |

