> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia de implantação do OpenClaw Manager

> Uma ferramenta visual para implantação e gerenciamento com um clique de gateways de bots de IA OpenClaw, com suporte para as plataformas Telegram, Feishu e Discord, impulsionada pelos modelos GPT-5, Claude, Gemini e outros via API da APIMart.

## 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](https://apimart.ai/keys) 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)

<Note>
  **Dica:** se você ainda não tem uma conta na APIMart, registre-se em [APIMart](https://apimart.ai) e obtenha primeiro uma chave de API.
</Note>

## Etapa 1: Download

Baixe o executável para a sua plataforma em [GitHub Releases](https://github.com/zhihong-apimart/OpenClaw-Manager-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

<Tabs>
  <Tab title="Windows">
    ### 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

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

  <Tab title="Linux">
    ### Implantação no Linux

    #### Pré-requisitos

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

    #### Inicialização

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

    ```bash theme={null}
    chmod +x ./openclaw-manager-linux-x64
    ```

    2. **Modo em primeiro plano** (para testes):

    ```bash theme={null}
    ./openclaw-manager-linux-x64
    ```

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

    ```bash theme={null}
    ./openclaw-manager-linux-x64 --daemon
    ```

    #### Gerenciamento do daemon

    ```bash theme={null}
    # 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:

    ```bash theme={null}
    # Interface web do Manager
    ufw allow 51942/tcp

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

    <Note>
      **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`.
    </Note>
  </Tab>

  <Tab title="macOS">
    ### Implantação no macOS

    #### Pré-requisitos

    * macOS 12+ (Apple Silicon ou Intel)

    #### Inicialização

    1. Descompacte o arquivo zip baixado para obter o `OpenClaw Manager.app`

    2. Dê duplo clique para executar o `OpenClaw Manager.app`

    3. A primeira execução pode exigir ajustes de segurança:

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

    <Note>
      **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.
    </Note>
  </Tab>
</Tabs>

## Etapa 3: Acessar a interface de gerenciamento

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

```
http://127.0.0.1:51942
```

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

## 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           |

<Tip>
  **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`
</Tip>

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:

<CardGroup cols={3}>
  <Card title="Telegram" icon="telegram" href="/pt/integrations/platform/openclaw-manager-telegram">
    Crie um bot do Telegram via BotFather
  </Card>

  <Card title="Feishu" icon="message" href="/pt/integrations/platform/openclaw-manager-feishu">
    Crie um bot corporativo do Feishu
  </Card>

  <Card title="Discord" icon="discord" href="/pt/integrations/platform/openclaw-manager-discord">
    Crie um bot de servidor Discord
  </Card>
</CardGroup>

## 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

<Note>
  **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.
</Note>

## 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:**

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](https://apimart.ai/overview) 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:

* 📚 [Documentação da APIMart](https://docs.apimart.ai)
* 📚 [GitHub do OpenClaw Manager](https://github.com/zhihong-apimart/OpenClaw-Manager)
* 💬 [Comunidade do Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Suporte técnico: [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Comece com a APIMart" icon="rocket" href="https://apimart.ai">
  Registre-se na APIMart agora, obtenha sua chave de API e implante seu bot de IA!
</Card>