Visão Geral do OpenClaw

OpenClaw é uma plataforma de assistente IA pessoal de código aberto com as características:

• Execução local: Dados gerenciados localmente sem servidores externos
• Suporte multiplataforma: Compatível com Feishu, WeChat, Telegram e outros
• Modelos diversos: Aceita MiniMax, OpenAI, Claude e Moonshot
• Licença MIT: Projeto aberto no GitHub

Pré-requisitos Técnicos

• Sistemas Operacionais: macOS/Linux/Windows (WSL2)
• Node.js versão 22 ou superior
• Conexão com APIs do Feishu e modelos de IA

Instalação do Node.js

# Instalar gerenciador de versões
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# Configurar ambiente
source ~/.bashrc

# Instalar Node.js 22
nvm install 22
nvm alias default 22

Configuração do OpenClaw

# Instalação global
npm install -g openclaw@latest

# Preparar diretórios
mkdir -p ~/.openclaw/{workspace,agents/main/sessions,credentials}
chmod 700 ~/.openclaw

Integração com MiniMax

Exemplo de configuração para API MiniMax:

{
  "env": {"MINIMAX_KEY": "seu_api_key"},
  "agents": {"defaults": {"model": {"primary": "minimax/M2.5"}}},
  "models": {
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimaxi.com/anthropic",
        "apiKey": "${MINIMAX_KEY}",
        "models": [{"id": "M2.5", "name": "MiniMax M2.5"}]
      }
    }
  }
}

Conexão com Feishu

1. Instalar plugin: openclaw plugins install @openclaw/feishu
2. Criar aplicativo no portal Feishu com permissões: ``` { "scopes": { "tenant": ["im:message", "im:message:send_as_bot"], "user": ["im:chat.access_event.bot_p2p_chat:read"] } }

3. Ativar modo WebSocket para eventos

Configuração Final

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "principal": {
          "appId": "cli_xxxxxxxx",
          "appSecret": "seu_app_secret"
        }
      }
    }
  }
}

Inicialização do Serviço

openclaw gateway install
openclaw gateway start
openclaw gateway status

Validação e Uso

1. Interagir com o bot no Feishu
2. Aprovar usuários via terminal: ``` openclaw pairing list feishu openclaw pairing approve feishu CODIGO

3. Comandos disponíveis: /status, /reset, /model

Solução de Problemas Comuns

• Erro 401: Verificar compatibilidade entre chave API e URL
• Teste de conexão: ``` curl -X POST "https://api.minimaxi.com/anthropic/v1/messages"
  -H "x-api-key: SEU_KEY"
  -d '{"model": "M2.5", "messages": [{"role":"user","content":"Teste"}]}'

• Limpar cache: rm ~/.openclaw/agents/main/agent/models.json