Guia de implantação do OpenClaw Manager

Introdução

O OpenClaw Manager é uma ferramenta visual de gerenciamento multiplataforma que ajuda você a implantar e gerenciar rapidamente gateways de bots de IA OpenClaw.

Implantação sem configuração — Arquivo executável único, instala automaticamente todas as dependências
Interface de gerenciamento web — Crie, inicie/pare, exclua instâncias e troque modelos pelo navegador
Suporte a múltiplos canais — Telegram / Feishu / Discord
Suporte a múltiplos modelos — Série GPT-5, série Claude 4.5/4.6, série Gemini com failover automático
Modo em segundo plano — Suporta o modo --daemon, sem ser afetado por desconexões SSH
Interface multilíngue — Chinês / Inglês / Japonês

Pré-requisitos

Antes de começar, verifique se:

A chave de API da APIMart foi obtida Faça login no Console da APIMart para obter sua chave de API (começa com sk-)
O Bot da plataforma de mensagens foi criado Prepare as credenciais do seu Bot conforme a plataforma desejada (consulte a seção de configuração de canal abaixo)

Dica: se você ainda não tem uma conta na APIMart, registre-se em APIMart e obtenha primeiro uma chave de API.

Etapa 1: Download

Baixe o executável para a sua plataforma em GitHub Releases:

Plataforma	Nome do arquivo
Windows x64	`openclaw-manager-win-x64.exe`
macOS ARM (Apple Silicon)	`openclaw-manager-macos-arm64.zip`
macOS Intel	`openclaw-manager-macos-x64.zip`
Linux x64	`openclaw-manager-linux-x64`
Linux ARM64	`openclaw-manager-linux-arm64`

Etapa 2: Execução

Windows
Linux
macOS

Implantação no Windows

Pré-requisitos

Windows 10/11 (64 bits)
Privilégios de administrador (necessários para criar tarefas agendadas do Windows que gerenciam o Gateway)

Inicialização

Clique com o botão direito em openclaw-manager-win-x64.exe → Executar como administrador

Na primeira inicialização, o seguinte será feito automaticamente:

Verificação e instalação do Node.js v22 (baixa automaticamente o MSI para instalação silenciosa se não for encontrado)
Instalação do OpenClaw CLI (via npm install -g openclaw)
Abertura automática do navegador na interface de gerenciamento

É necessário executar como administrador, caso contrário não será possível criar tarefas agendadas do Windows para gerenciar os processos do Gateway.

Implantação no Linux

Pré-requisitos

Ubuntu 20.04+ / Debian 11+ / CentOS 8+ (x64 ou ARM64)
Privilégios de root (recomendado)

Inicialização

Faça o download e conceda permissão de execução:

chmod +x ./openclaw-manager-linux-x64

Modo em primeiro plano (para testes):

./openclaw-manager-linux-x64

Modo em segundo plano (recomendado para produção):

./openclaw-manager-linux-x64 --daemon

Gerenciamento do daemon

# Iniciar em segundo plano
./openclaw-manager-linux-x64 --daemon
# Ou forma abreviada
./openclaw-manager-linux-x64 -d

# Verificar status
./openclaw-manager-linux-x64 --status

# Parar
./openclaw-manager-linux-x64 --stop
# Ou forma abreviada
./openclaw-manager-linux-x64 -s

Configuração do firewall

Se for necessário acesso remoto, abra as seguintes portas:

# Interface web do Manager
ufw allow 51942/tcp

# Portas do Gateway (uma por instância, a partir de 18789)
ufw allow 18789/tcp

Dica: no Linux, o Manager se vincula automaticamente a 0.0.0.0, permitindo acesso remoto. O arquivo de log fica em ~/openclaw-manager.log.

Implantação no macOS

Pré-requisitos

macOS 12+ (Apple Silicon ou Intel)

Inicialização

Descompacte o arquivo zip baixado para obter o OpenClaw Manager.app
Dê duplo clique para executar o OpenClaw Manager.app
A primeira execução pode exigir ajustes de segurança:

Ajustes do Sistema → Privacidade e Segurança → Permitir mesmo assim

Dica: no macOS, o Manager se vincula a 127.0.0.1 (acesso apenas local). Os comandos do daemon são iguais aos do Linux.

Etapa 3: Acessar a interface de gerenciamento

Após o programa iniciar, acesse a interface web de gerenciamento:

http://127.0.0.1:51942

Acesso remoto no Linux: substitua 127.0.0.1 pelo IP do seu servidor, ex.: http://your-server-ip:51942

Etapa 4: Criar uma instância

Na interface web de gerenciamento, clique em + New Instance para começar:

4.1 Definir o nome da instância

Informe um nome para a instância (apenas letras, números, underscores e hífens, 1-64 caracteres).

4.2 Selecionar o modelo de IA

Escolha o modelo de IA a ser usado e informe sua chave de API da APIMart (começa com sk-). Modelos suportados:

ID do modelo	Nome	Características
`gpt-5`	GPT-5	O mais recente e poderoso
`gpt-5.1`	GPT-5.1	Versão aprimorada
`gpt-5.2-codex`	GPT-5.2 Codex	Especializado em código
`gpt-5.2-pro`	GPT-5.2 Pro	Versão profissional
`claude-opus-4-6-20260320`	Claude Opus 4.6	Raciocínio mais forte
`claude-sonnet-4-6-20260320`	Claude Sonnet 4.6	Escolha equilibrada
`claude-opus-4-5-20251101`	Claude Opus 4.5	Raciocínio avançado
`claude-sonnet-4-5-20250929`	Claude Sonnet 4.5	Excelente para código
`claude-haiku-4-5-20251001`	Claude Haiku 4.5	Resposta rápida
`gemini-2.5-flash`	Gemini 2.5 Flash	Multimodal rápido
`gemini-3-pro-preview`	Gemini 3 Pro Preview	Alto desempenho

Recomendações de modelos:

💰 Custo-benefício: claude-haiku-4-5-20251001, gemini-2.5-flash
🚀 Alto desempenho: gpt-5, claude-opus-4-6-20260320, gemini-3-pro-preview
⚡ Resposta rápida: gemini-2.5-flash, claude-haiku-4-5-20251001

Você também pode selecionar o modo failover para adicionar vários modelos de backup. Quando o modelo principal estiver indisponível, o sistema alternará automaticamente para os modelos de backup.

4.3 Configurar o canal de mensagens

Selecione sua plataforma de mensagens e siga o tutorial correspondente:

Crie um bot do Telegram via BotFather

Feishu

Crie um bot corporativo do Feishu

Discord

Crie um bot de servidor Discord

Etapa 5: Vinculação por código de pareamento

Após a instância ser criada e iniciada, conclua a vinculação do usuário pelo código de pareamento:

O usuário envia qualquer mensagem ao bot na plataforma de mensagens
O bot responde com um código de pareamento de 8 dígitos (ex.: DFE62DTD)
O administrador clica no botão “Pairing Code” para a instância correspondente na interface web
Informa o código de pareamento e clica em “Approve”
O usuário já pode usar o bot normalmente

Dica: os códigos de pareamento são armazenados na memória do Gateway e expiram após o reinício. Se um código expirar, basta pedir ao usuário para enviar uma nova mensagem para receber um código novo.

Gerenciar instâncias

Na interface de gerenciamento, você pode realizar as seguintes operações:

Ação	Descrição
Iniciar	Inicia o processo do Gateway; o bot começa a receber mensagens
Parar	Para o processo do Gateway
Trocar modelo	Troca o modelo de IA em tempo real sem reiniciar o Gateway
Código de pareamento	Aprova os códigos de pareamento de novos usuários para autorizar o uso do bot
Excluir	Para e exclui a instância com todos os dados (irreversível)

Portas e dados

Portas

Finalidade	Porta	Endereço de bind
Interface web do Manager	`51942`	Windows/macOS: `127.0.0.1`, Linux: `0.0.0.0`
Instância do Gateway	A partir de `18789`	Cada instância recebe uma porta única

Diretórios de dados

Conteúdo	Caminho
Configuração da instância	`~/.openclaw-<instance-name>/openclaw.json`
Logs do Gateway	`~/.openclaw-<instance-name>/logs/gateway.log`
Logs do Manager	`~/openclaw-manager.log` (modo daemon)
PID do Manager	`~/.openclaw-manager.pid`

FAQ

Q1: O Manager não inicia?

Soluções:

Plataforma	Verificação
Windows	Confirme que está sendo executado como administrador
Linux	Confirme que a porta 51942 não está em uso (`lsof -i :51942`)
macOS	Confirme que as configurações de segurança foram permitidas ou que o quarantine foi removido
Todas	Verifique os logs em `~/openclaw-manager.log`

Q2: Comando openclaw não encontrado?

Soluções:

O programa detecta e instala automaticamente o openclaw CLI na inicialização
Se a versão for muito antiga (< 0.1.0), será atualizada automaticamente
Instalação manual: npm install -g openclaw@latest

Q3: A instância aparece como “stopped” após ser iniciada?

Soluções:

O Gateway leva alguns segundos para vincular a porta; o status pode aparecer inconsistente brevemente
Atualize a página para conferir o status mais recente
Verifique os logs do Gateway: ~/.openclaw-<instance-name>/logs/gateway.log

Q4: O bot do Feishu não responde?

Soluções:

Confirme que a assinatura de eventos inclui im.message.receive_v1
Confirme que o método de assinatura é “Long Connection”
Confirme que uma nova versão foi criada e publicada (necessário após cada alteração de permissão/evento)

Q5: A aprovação do código de pareamento falhou?

Soluções:

Confirme que o Gateway está em execução
Os códigos de pareamento são armazenados na memória do Gateway e expiram após o reinício
Peça ao usuário para enviar uma nova mensagem e obter um novo código de pareamento

Q6: Como visualizar o uso e os custos da API?

Faça login no Console da APIMart para visualizar:

📊 Estatísticas de chamadas da API
💰 Detalhes de custos
📈 Gráficos de tendências de uso

Suporte e ajuda

Se você encontrar algum problema:

Comece com a APIMart

Registre-se na APIMart agora, obtenha sua chave de API e implante seu bot de IA!

​Introdução

​Pré-requisitos

​Etapa 1: Download

​Etapa 2: Execução

​Implantação no Windows

​Pré-requisitos

​Inicialização

​Implantação no Linux

​Pré-requisitos

​Inicialização

​Gerenciamento do daemon

​Configuração do firewall

​Implantação no macOS

​Pré-requisitos

​Inicialização

​Etapa 3: Acessar a interface de gerenciamento

​Etapa 4: Criar uma instância

​4.1 Definir o nome da instância

​4.2 Selecionar o modelo de IA

​4.3 Configurar o canal de mensagens

Telegram

Feishu

Discord

​Etapa 5: Vinculação por código de pareamento

​Gerenciar instâncias

​Portas e dados

​Portas

​Diretórios de dados

​FAQ

​Q1: O Manager não inicia?

​Q2: Comando openclaw não encontrado?

​Q3: A instância aparece como “stopped” após ser iniciada?

​Q4: O bot do Feishu não responde?

​Q5: A aprovação do código de pareamento falhou?

​Q6: Como visualizar o uso e os custos da API?

​Suporte e ajuda

Comece com a APIMart

Introdução

Pré-requisitos

Etapa 1: Download

Etapa 2: Execução

Implantação no Windows

Pré-requisitos

Inicialização

Implantação no Linux

Pré-requisitos

Inicialização

Gerenciamento do daemon

Configuração do firewall

Implantação no macOS

Pré-requisitos

Inicialização

Etapa 3: Acessar a interface de gerenciamento

Etapa 4: Criar uma instância

4.1 Definir o nome da instância

4.2 Selecionar o modelo de IA

4.3 Configurar o canal de mensagens

Etapa 5: Vinculação por código de pareamento

Gerenciar instâncias

Portas e dados

Portas

Diretórios de dados

FAQ

Q1: O Manager não inicia?

Q2: Comando openclaw não encontrado?

Q3: A instância aparece como “stopped” após ser iniciada?

Q4: O bot do Feishu não responde?

Q5: A aprovação do código de pareamento falhou?

Q6: Como visualizar o uso e os custos da API?

Suporte e ajuda