Skip to main content

​
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:
  1. 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-)
  2. 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:

​
Etapa 2: Execução

​
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

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.

​
Etapa 3: Acessar a interface de gerenciamento

Após o programa iniciar, acesse a interface web de gerenciamento:
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:
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:

Telegram

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:
  1. O usuário envia qualquer mensagem ao bot na plataforma de mensagens
  2. O bot responde com um código de pareamento de 8 dígitos (ex.: DFE62DTD)
  3. O administrador clica no botão “Pairing Code” para a instância correspondente na interface web
  4. Informa o código de pareamento e clica em “Approve”
  5. 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:

​
Portas e dados

​
Portas

​
Diretórios de dados

​
FAQ

​
Q1: O Manager não inicia?

Soluções:

​
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:
  1. Confirme que a assinatura de eventos inclui im.message.receive_v1
  2. Confirme que o método de assinatura é “Long Connection”
  3. 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!