Guia completo para instalar o assistente de IA Clawdbot no macOS, Linux e Windows. Instalação rápida com um único comando ou opções de configuração manual.

Visão Geral da Instalação do Clawdbot

Use o instalador do Clawdbot a menos que você tenha um motivo específico para não usar. Ele configura a CLI e executa a integração automaticamente.

Instalação Rápida (Recomendada)

Instale o Clawdbot com um único comando:

curl -fsSL https://clawd.bot/install.sh | bash

Windows (PowerShell):

iwr -useb https://clawd.bot/install.ps1 | iex

Próximo passo (se você pulou a integração):

clawdbot onboard --install-daemon

Requisitos do Sistema

Requisito	Detalhes
Node.js	Versão 22 ou superior
Sistema Operacional	macOS, Linux ou Windows via WSL2
pnpm	Apenas necessário se compilar a partir do código fonte

Escolha seu Método de Instalação

1. Script de Instalação (Recomendado)

O instalador do Clawdbot instala globalmente via npm e executa a integração:

curl -fsSL https://clawd.bot/install.sh | bash

Opções do instalador:

curl -fsSL https://clawd.bot/install.sh | bash -s -- --help

Não interativo (pular integração):

curl -fsSL https://clawd.bot/install.sh | bash -s -- --no-onboard

2. Instalação Global (Manual)

Se você já tem o Node.js instalado:

npm install -g clawdbot@latest

Se você tem o libvips instalado globalmente e o sharp falha:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g clawdbot@latest

Com pnpm:

pnpm add -g clawdbot@latest
pnpm approve-builds -g  # aprovar clawdbot, node-llama-cpp, sharp, etc.

Depois execute a integração:

clawdbot onboard --install-daemon

3. A partir do Código Fonte (Colaboradores/Dev)

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
clawdbot onboard --install-daemon

4. Outras Opções de Instalação

Docker: Veja Instalação Docker
Nix: Veja Instalação Nix
Ansible: Veja Instalação Ansible

Após a Instalação

Execute estes comandos para verificar sua instalação do Clawdbot:

# Executar integração
clawdbot onboard --install-daemon

# Verificação rápida
clawdbot doctor

# Verificar saúde do gateway
clawdbot status
clawdbot health

# Abrir o painel de controle
clawdbot dashboard

Método de Instalação: npm vs git

O instalador do Clawdbot suporta dois métodos:

Método	Descrição
`npm` (padrão)	`npm install -g clawdbot@latest`
`git`	Clonar/compilar a partir do checkout do código fonte do GitHub

Opções da CLI:

# npm explícito
curl -fsSL https://clawd.bot/install.sh | bash -s -- --install-method npm

# Instalar do GitHub (checkout do código fonte)
curl -fsSL https://clawd.bot/install.sh | bash -s -- --install-method git

Opções comuns:

Opção	Descrição
`--install-method npm\|git`	Escolher método de instalação
`--git-dir <path>`	Diretório Git (padrão: ~/clawdbot)
`--no-git-update`	Pular git pull para checkout existente
`--no-prompt`	Desabilitar prompts (para CI/automação)
`--dry-run`	Mostrar o que aconteceria
`--no-onboard`	Pular integração

Variáveis de Ambiente

Para automação, use estas variáveis de ambiente:

CLAWDBOT_INSTALL_METHOD=git|npm
CLAWDBOT_GIT_DIR=...
CLAWDBOT_GIT_UPDATE=0|1
CLAWDBOT_NO_PROMPT=1
CLAWDBOT_DRY_RUN=1
CLAWDBOT_NO_ONBOARD=1
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1

Solução de Problemas: clawdbot não encontrado (PATH)

Diagnóstico rápido:

node -v
npm -v
npm prefix -g
echo "$PATH"

Se $(npm prefix -g)/bin não está no seu PATH, adicione-o ao seu arquivo de inicialização do shell:

macOS / Linux (~/.zshrc ou ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

Windows: Adicione a saída de npm prefix -g à sua variável de ambiente PATH.

Depois abra um novo terminal ou execute hash -r (bash) / rehash (zsh).

Atualizar / Desinstalar

Atualizações: Veja Atualizando Clawdbot
Desinstalar: Veja Desinstalar Clawdbot

Próximos Passos

Guia de Configuração do Clawdbot - Guia completo de configuração
Gateway do Clawdbot - Configuração do gateway
Clawdbot WhatsApp - Conectar ao WhatsApp

Guia de Instalação do Clawdbot