OpenClaw — Assistente IA Pessoal
openclaw/openclaw
Assistente IA local multi-canal, sempre disponível, customizável com skills
Ver no GitHubAssistente de IA pessoal que você executa localmente em qualquer dispositivo e SO. Integra-se com 20+ canais de comunicação (WhatsApp, Telegram, Slack, Discord, Teams, etc.) e oferece suporte a voz, Canvas interativo e skills customizáveis. Arquitetura descentralizada com Gateway como plano de controle.
Instalação
npx convez-ai openclaw/openclaw1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de fluxos de trabalho em canais de comunicação preferidos
- Criação de assistentes IA pessoais com execução local e privada
- Integração de IA em múltiplas plataformas (mobile, desktop, web) simultaneamente
Veredito

Projeto robusto e multiplataforma para quem busca assistente IA privado e descentralizado. Excelente para automação cross-channel, mas exige configuração técnica e conhecimento de CLI/DevOps para setup inicial.
README em português
🦞 OpenClaw — Assistente de IA Pessoal
OpenClaw é um assistente de IA pessoal que você executa nos seus próprios dispositivos. Ele responde em canais que você já utiliza. Pode falar e ouvir no macOS/iOS/Android, e pode renderizar um Canvas ao vivo sob seu controle. O Gateway é apenas o plano de controle — o produto é o assistente.
Se você quer um assistente pessoal, para usuário único, que se sinta local, rápido e sempre ligado, este é ele.
Canais suportados incluem: WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, IRC, Microsoft Teams, Matrix, Feishu, LINE, Mattermost, Nextcloud Talk, Nostr, Synology Chat, Tlon, Twitch, Zalo, Zalo Personal, WeChat, QQ, WebChat.
Website · Docs · Vision · Third-party notices · DeepWiki · Getting Started · Updating · Showcase · FAQ · Onboarding · Nix · Docker · Discord
Nova instalação? Comece aqui: Getting started
Configuração preferida: execute openclaw onboard no seu terminal.
OpenClaw Onboard guia você passo a passo na configuração do gateway, workspace, canais e skills. É o caminho de instalação CLI recomendado e funciona em macOS, Linux e Windows.
Usuários de desktop Windows podem começar com o aplicativo companheiro nativo Windows Hub para configuração, status da bandeja, chat, modo node e modo local MCP.
Funciona com npm, pnpm ou bun.
Patrocinadores
Assinaturas (OAuth):
- OpenAI (ChatGPT/Codex)
Nota sobre modelos: embora muitos provedores e modelos sejam suportados, prefira um modelo atual de bandeirada do provedor que você confia e já utiliza. Veja Onboarding.
Instalação (recomendada)
Runtime: Node 24 (recomendado) ou Node 22.19+.
npm install -g openclaw@latest
# or: pnpm add -g openclaw@latest
openclaw onboard --install-daemon
OpenClaw Onboard instala o daemon do Gateway (serviço de usuário launchd/systemd) para que ele permaneça em execução.
Início rápido (TL;DR)
Runtime: Node 24 (recomendado) ou Node 22.19+.
Guia completo para iniciantes (autenticação, pareamento, canais): Getting started
Modo de daemon recomendado:
openclaw onboard --install-daemon
openclaw gateway status
Modo foreground/debug:
openclaw gateway stop
openclaw gateway --port 18789 --verbose
Envie uma mensagem de teste ou pergunte ao assistente após qualquer um dos modos de inicialização estar em execução:
# Send a message
openclaw message send --target +1234567890 --message "Hello from OpenClaw"
# Talk to the assistant (optionally deliver back to any connected channel: WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/IRC/Microsoft Teams/Matrix/Feishu/LINE/Mattermost/Nextcloud Talk/Nostr/Synology Chat/Tlon/Twitch/Zalo/Zalo Personal/WeChat/QQ/WebChat)
openclaw agent --message "Ship checklist" --thinking high
Atualizando? Guia de atualização (e execute openclaw doctor).
Configuração + CLI de modelos: Models. Rotação de perfil de autenticação + fallbacks: Model failover.
Padrões de segurança (acesso DM)
OpenClaw se conecta a superfícies reais de mensagens. Trate as DMs recebidas como entrada não confiável.
Guia completo de segurança: Security. Antes da exposição remota, use o Gateway exposure runbook.
Comportamento padrão no Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack:
- Pareamento de DM (
dmPolicy="pairing"/channels.discord.dmPolicy="pairing"/channels.slack.dmPolicy="pairing";legado:channels.discord.dm.policy,channels.slack.dm.policy): remetentes desconhecidos recebem um código curto de pareamento e o bot não processa sua mensagem. - Aprove com:
openclaw pairing approve <channel> <code>(então o remetente é adicionado a uma loja local de lista de permissão). - DMs públicos recebidos exigem consentimento explícito: defina
dmPolicy="open"e inclua"*"na lista de permissão do canal (allowFrom/channels.discord.allowFrom/channels.slack.allowFrom; legado:channels.discord.dm.allowFrom,channels.slack.dm.allowFrom).
Execute openclaw doctor para expor políticas de DM arriscadas/mal configuradas.
Destaques
- Local-first Gateway — plano de controle único para sessões, canais, ferramentas e eventos.
- Caixa de entrada multi-canal — WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, IRC, Microsoft Teams, Matrix, Feishu, LINE, Mattermost, Nextcloud Talk, Nostr, Synology Chat, Tlon, Twitch, Zalo, Zalo Personal, WeChat, QQ, WebChat, macOS, iOS/Android.
- Roteamento multi-agente — roteie canais/perfis/pares de entrada para agentes isolados (workspaces + sessões por agente).
- Voice Wake + Talk Mode — palavras-chave no macOS/iOS e voz contínua no Android (ElevenLabs + fallback TTS do sistema).
- Live Canvas — workspace visual impulsionado por agentes com A2UI.
- Ferramentas de primeira classe — navegador, canvas, nós (nodes), cron, sessões e ações do Discord/Slack.
- Apps companheiros — Hub para Windows, app na barra de menu do macOS e nós para iOS/Android.
- Onboarding + skills — configuração guiada pelo onboarding com skills embutidas/gestionadas/workspace.
Modelo de segurança (importante)
- Padrão: as ferramentas rodam no host para a sessão
main, então o agente tem acesso total quando é apenas você. - Segurança do grupo/canal: defina
agents.defaults.sandbox.mode: "non-main"para rodar sessões não-maindentro de sandboxes (isolamentos). Docker é o backend padrão do sandbox; backends SSH e OpenShell também estão disponíveis. - Padrão típico do sandbox: permita
bash,process,read,write,edit,sessions_list,sessions_history,sessions_send,sessions_spawn; neguebrowser,canvas,nodes,cron,discord,gateway. - Antes de expor qualquer coisa remotamente, leia Security, Gateway exposure runbook, Sandboxing e Configuration.
Referências rápidas para operadores
- Comandos de chat:
/status,/new,/reset,/compact,/think <level>,/verbose on|off,/trace on|off,/usage off|tokens|full,/restart,/activation mention|always - Ferramentas de sessão:
sessions_list,sessions_history,sessions_send - Registro de skills: ClawHub
- Visão geral da arquitetura: Architecture
Docs por objetivo
- Iniciante aqui: Getting started, Onboarding, Updating
- Configuração de canal: Channels index, WhatsApp, Telegram, Discord, Slack
- Apps + nós: Windows Hub, macOS, iOS, Android, Nodes
- Config + segurança: Configuration, Security, Exposure runbook, Sandboxing
- Remoto + web: Gateway, Remote access, Tailscale, Web surfaces
- Ferramentas + automação: Tools, Skills, Cron jobs, Webhooks, Gmail Pub/Sub
- Internals: Architecture, Agent, Session model, Gateway protocol
- Troubleshooting: Channel troubleshooting, Logging, Docs home
Apps (opcionais)
O Gateway sozinho já oferece uma ótima experiência. Todos os apps são opcionais e adicionam recursos extras.
Se você planeja construir/executar apps companheiros, siga as instruções das plataformas abaixo.
macOS (OpenClaw.app) (opcional)
- Controle na barra de menu para o Gateway e saúde do sistema.
- Overlay de ativação por voz + push-to-talk.
- WebChat + ferramentas de depuração.
- Controle remoto do gateway via SSH.
Nota: builds assinados são necessários para que as permissões do macOS persistam entre reconstruções (veja Permissões no macOS).
Nó iOS (opcional)
- Emparelha como nó sobre o WebSocket do Gateway (emparelhamento de dispositivo).
- Encaminhamento de gatilho por voz + superfície Canvas.
- Controlado via
openclaw nodes ….
Runbook: Conectar iOS.
Nó Android (opcional)
- Emparelha como nó WS via emparelhamento de dispositivo (
openclaw devices ...). - Exibe abas Connect, Chat e Voice além do Canvas, Câmera, Captura de tela e famílias de comandos para dispositivos Android.
- Runbook: Conectar Android.
Do código-fonte (desenvolvimento)
Use pnpm para clonagens da fonte. O repositório é um workspace pnpm, e os plugins embutidos carregam de extensions/* durante o desenvolvimento, então suas dependências locais do pacote e edições são usadas diretamente. Um simples npm install na raiz do repositório não configura a fonte corretamente.
Para o loop de dev:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
# First run only (or after resetting local OpenClaw config/workspace)
pnpm openclaw setup
# Optional: prebuild Control UI before first startup
pnpm ui:build
# Dev loop (auto-reload on source/config changes)
pnpm gateway:watch
Se precisar de um build compilado em dist/ da clonagem (para Node, empacotamento ou validação de release), execute:
pnpm build
pnpm ui:build
O comando pnpm openclaw setup escreve a configuração local/workspace necessária para o pnpm gateway:watch. É seguro re-executar, mas normalmente você só precisa disso na primeira configuração ou após resetar o estado local. O pnpm gateway:watch não reconstrói o dist/control-ui, então execute novamente pnpm ui:build após alterações em ui/ ou use pnpm ui:dev ao iterar sobre a Control UI. Se quiser que essa clonagem rode onboarding diretamente, use pnpm openclaw onboard --install-daemon.
Nota: pnpm openclaw ... executa TypeScript diretamente (via tsx). O comando pnpm build produz o dist/ para execução via Node / binário empacotado do openclaw, enquanto pnpm gateway:watch reconstrói a runtime sob demanda durante o loop de dev.
Canais de desenvolvimento
- stable: releases marcadas (
vYYYY.M.DouvYYYY.M.D-<patch>), tag dist npmlatest. - beta: tags pré-release (
vYYYY.M.D-beta.N), tag dist npmbeta(o app do macOS pode estar ausente). - dev: ponta móvel de
main, tag dist npmdev(quando publicado).
Mudar canais (git + npm): openclaw update --channel stable|beta|dev.
Detalhes: Canais de desenvolvimento.
Workspace do agente + skills
- Raiz do workspace:
~/.openclaw/workspace(configurável viaagents.defaults.workspace). - Arquivos de prompt injetados:
AGENTS.md,SOUL.md,TOOLS.md. - Skills:
~/.openclaw/workspace/skills/<skill>/SKILL.md.
Configuração
Configuração mínima em ~/.openclaw/openclaw.json (modelo + padrões):
{
agent: {
model: "<provider>/<model-id>",
},
}
Referência completa de configuração (todas as chaves + exemplos).
Star History
Molty
O OpenClaw foi construído para Molty, um assistente de IA lagostim espacial. 🦞 por Peter Steinberger e a comunidade.
Comunidade
Veja CONTRIBUTING.md para diretrizes, mantenedores e como enviar PRs. PRs feitos com IA/vibe-coding são bem-vindos! 🤖 Agradecimentos especiais ao Mario Zechner pelo apoio e por pi-mono. Agradecimentos especiais a Adam Doppelt pelo domínio lobster.bot. Obrigado para todos os clawtributors: