Guia de Configuração OpenClaw
Dê ao Ami a capacidade de controlar seu desktop.
Pré-requisitos
macOS é necessário para as ferramentas Apple Notes, Lembretes, Calendário e Música.
Node.js 22+ — verifique com node --version
Se não tiver Node 22+:
brew install node@22Instalar OpenClaw
Execute o script de instalação:
curl -fsSL https://openclaw.ai/install.sh | bashIsso instalará a CLI e iniciará o assistente.
Verificar instalação
openclaw doctoropenclaw não encontrado, adicione ao PATH:
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcIniciar o Gateway
O assistente instala um daemon em segundo plano. Para verificar:
openclaw gateway statusPara iniciar manualmente:
openclaw gateway --port 18789Encontre seu token
Seu token está em ~/.openclaw/openclaw.json sob gateway.auth.token. Veja com:
cat ~/.openclaw/openclaw.json | grep '"token"' | head -1Conectar Ami ao OpenClaw
- Abra o app Ami e vá para Configurações
- Role até a seção Avançado
- Expanda OpenClaw Gateway
- Preencha os campos:
| Campo | Valor |
|---|---|
| URL do Gateway | ws://127.0.0.1:18789 |
| Token do Gateway | (cole o token do Passo 2) |
5. Ative Rotear chat web via OpenClaw
6. Clique em Salvar
Configurações opcionais
| Configuração | Função |
|---|---|
| Sincronizar identidade | Envia nome e personalidade do Ami ao gateway |
| Buscar memórias | Importa memórias do workspace ao carregar personagem |
| Enviar memórias | Auto-sincroniza memórias do app a cada 10 minutos |
Configurar Workspace
OpenClaw usa uma pasta de workspace. Padrão: ~/.openclaw/workspace-ami/
Deve conter dois arquivos:
SOUL.md — Personalidade
Auto-sincronizado do app.
~/.openclaw/workspace-ami/SOUL.mdTOOLS.md — Instruções de Ferramentas
Guia do Ami para usar macOS ferramentas.
~/.openclaw/workspace-ami/TOOLS.mdO arquivo contém osascript comandos.
Ferramentas Disponíveis
Uma vez conectado, peça ao Ami para:
Apple Notes
“Escreva uma nota sobre compras”
“Salve uma nota Planos do Fim de Semana”
Lembretes
“Lembre-me de ligar pro dentista às 15h”
“Lembrete para regar plantas amanhã”
Calendário
“O que tenho hoje?”
“Adicione reunião com Jake sexta às 14h”
Música
“Toque uma música”
“Pause a música”
“Próxima música”
“O que está tocando?”
Controles do Sistema
“Modo escuro”
“Timer 5 minutos”
“Nível de bateria?”
Abrir Apps e URLs
“Abra Safari”
“Abra twitter.com”
Solução de Problemas
Atualizar OpenClaw
npm update -g openclawOu re-execute o instalador:
curl -fsSL https://openclaw.ai/install.sh | bashArquitetura
Para os curiosos — como Ami se comunica com seu desktop:
┌──────────────┐ WebSocket ┌──────────────────┐ osascript ┌──────────────┐
│ Ami App │ ──────────────────► │ OpenClaw Gateway │ ────────────────► │ macOS APIs │
│ (browser) │ ◄────────────────── │ (localhost) │ ◄──────────────── │ Notes, Music │
│ │ SSE streaming │ Port 18789 │ tool results │ Calendar etc │
└──────────────┘ └──────────────────┘ └──────────────┘
│
┌──────┴──────┐
│ Workspace │
│ SOUL.md │
│ TOOLS.md │
└─────────────┘1. Você envia mensagem ao Ami no navegador
2. O app detecta pedido de ferramenta e mostra card
3. Mensagem roteada via WebSocket ao gateway
4. Agente lê TOOLS.md e executa comando osascript
5. Agente responde e Ami fala de volta
Pronto para começar?
Instale OpenClaw, conecte Ami e controle seu desktop com linguagem natural.
Abrir App