Assistentes de IA na nuvem são convenientes até deixarem de ser. Limites de taxa (rate limits) durante horários de pico. Dados saindo da sua rede. Assinaturas mensais que se acumulam. Nenhuma maneira de personalizar o comportamento além do que o provedor permite.
O LemonClaw é um assistente de IA self-hosted que roda em seu próprio hardware. Ele se conecta ao Telegram, Discord ou qualquer plataforma de chat, utiliza qualquer modelo de IA por meio de uma API unificada e mantém todos os dados de conversas em sua máquina.
Se você está decidindo se deve ou não optar pelo self-hosting, leia isto junto com o guia de IA local para Mac Studio e o guia para desenvolvedores na China. O primeiro responde à questão do hardware. O segundo responde à questão de pagamento e provedores.
O Que o LemonClaw Faz
Em sua essência, o LemonClaw é um gateway entre plataformas de chat e modelos de IA. Você envia uma mensagem no Telegram, o LemonClaw a roteia para o modelo de IA escolhido e envia a resposta de volta.
Mas ele vai além de um simples retransmissor:
- Suporte multi-modelo: Alterne entre GPT-4.1, Claude, DeepSeek e modelos locais no meio da conversa
- Memória persistente: As conversas persistem entre reinicializações com janelas de contexto configuráveis
- Suporte a servidor MCP: Conecte-se a ferramentas externas (bancos de dados, APIs, sistemas de arquivos) por meio do Model Context Protocol
- Sistema de plugins: Adicione comandos personalizados, tarefas agendadas e integrações
- Multi-usuário: Cada usuário tem seu próprio histórico de conversas e preferências de modelo
- Compreensão de imagens: Envie fotos e obtenha análises de IA (usando modelos com capacidade de visão)
- Mensagens de voz: Processamento de fala para texto (speech-to-text) para entradas de voz
Arquitetura
Telegram/Discord ←→ LemonClaw Gateway ←→ AI API (LemonData/OpenAI/Local)
│
┌────┴────┐
│ Plugins │
│ MCP │
│ Memória │
└─────────┘
O LemonClaw roda como um único processo Node.js. Nenhum banco de dados é necessário para o uso básico (conversas armazenadas como arquivos JSON). Para implantações em produção, ele suporta volumes persistentes no Kubernetes.
Início Rápido (5 Minutos)
Opção 1: Instalação Self-Hosted em uma Linha (Recomendado)
curl -fsSL https://raw.githubusercontent.com/hedging8563/lemonclaw/main/deploy/self-hosted/install.sh | bash
O instalador atual prefere uv tool install quando disponível, caso contrário, recorre a um venv isolado e executa lemonclaw init ao final.
Opção 2: Instalação Manual
uv tool install --upgrade lemonclaw
lemonclaw init
Opção 3: Hospedado pela LemonData
Se você não quiser gerenciar infraestrutura, a LemonData oferece instâncias hospedadas do LemonClaw. Cada instância roda em um pod isolado de Kubernetes com armazenamento persistente.
Cadastre-se em lemondata.cc, navegue até a seção Claw em seu dashboard e inicie uma instância. Você recebe um subdomínio dedicado (claw-yourname.lemondata.cc) com acesso via terminal web.
O Fluxo Self-Hosted Atual
O fluxo local atual é:
lemonclaw init
lemonclaw gateway
lemonclaw status
Os dados de runtime ficam em:
~/.lemonclaw/config.json~/.lemonclaw/workspace/~/.lemonclaw/workspace/sessions/~/.lemonclaw/lemonclaw.log
Isso importa operacionalmente. Quando as equipes dizem que um assistente self-hosted é “apenas um bot”, geralmente não pensaram sobre onde o estado da sessão, os logs e as credenciais realmente residem.
Configuração
O arquivo de configuração (~/.lemonclaw/config.json) controla tudo:
{
"api": {
"key": "sk-lemon-xxx",
"baseUrl": "https://api.lemondata.cc/v1"
},
"telegram": {
"token": "BOT_TOKEN_FROM_BOTFATHER"
},
"discord": {
"token": "DISCORD_BOT_TOKEN"
},
"agents": {
"defaults": {
"model": "claude-sonnet-4-6",
"compaction": { "mode": "default" }
}
}
}
Comandos comuns que vale a pena conhecer agora:
lemonclaw initlemonclaw gatewaylemonclaw statuslemonclaw doctorlemonclaw channels loginlemonclaw channels status
Seleção de Modelo
Alterne modelos por conversa ou defina padrões:
/model claude-sonnet-4-6 # Mudar para o Claude
/model gpt-4.1-mini # Mudar para o GPT-4.1 Mini (mais barato)
/model deepseek-chat # Mudar para o DeepSeek (econômico)
Servidores MCP
Conecte ferramentas externas via MCP (Model Context Protocol):
{
"mcp": {
"servers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-filesystem", "/path/to/allowed/dir"]
},
"postgres": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-postgres", "postgresql://..."]
}
}
}
}
Com os servidores MCP configurados, seu assistente de IA pode ler arquivos, consultar bancos de dados e interagir com serviços externos diretamente da interface de chat.
Hospedado vs Self-Hosted: Qual Deles se Encaixa
Use self-hosted quando:
- a localidade dos dados for importante
- você quiser controle direto sobre o runtime e o armazenamento
- você precisar de servidores MCP personalizados ou ferramentas locais
- você se sentir confortável operando um pequeno serviço
Use hospedado quando:
- você quiser a experiência do Claw sem manter um runtime
- sua equipe valoriza velocidade em vez de controle
- você precisar de instâncias isoladas, mas não da propriedade do runtime em baixo nível
Para muitas equipes, o melhor primeiro passo é o Claw hospedado, com uma mudança posterior para self-hosted se o fluxo de trabalho se tornar central.
Casos de Uso
Assistente de Conhecimento Pessoal
Conecte o LemonClaw ao seu diretório de notas via servidor de sistema de arquivos MCP. Faça perguntas sobre seus próprios documentos, obtenha resumos e encontre conexões entre notas.
Bot de DevOps para Equipes
Implante no Slack ou Discord da sua equipe. Conecte-se ao seu cluster Kubernetes, dashboards de monitoramento e pipelines de CI/CD. Os membros da equipe podem verificar o status da implantação, visualizar logs e acionar rollbacks por meio de linguagem natural.
Automação de Suporte ao Cliente
Conecte-se ao banco de dados do seu produto e à sua base de conhecimento. O LemonClaw lida com consultas de suporte de primeira linha, escalando para humanos quando a confiança é baixa.
Assistente de Code Review
Conecte-se ao seu repositório Git. Envie diffs para revisão, obtenha análises de segurança, sugestões de estilo e detecção de bugs sem sair do seu aplicativo de chat.
Comparação de Custos
| Configuração | Custo Mensal | Modelos | Privacidade de Dados |
|---|---|---|---|
| ChatGPT Plus | $20/usuário | GPT-4o, limitado | Dados nos servidores da OpenAI |
| Claude Pro | $20/usuário | Apenas Claude | Dados nos servidores da Anthropic |
| LemonClaw (self-hosted) | Apenas uso da API | Qualquer modelo | Dados no seu servidor |
| LemonClaw (LemonData hospedado) | $20/instância + API | Qualquer modelo | Pod de K8s isolado |
Para uma equipe de 5 pessoas, o ChatGPT Plus custa $100/mês com acesso limitado a modelos. O LemonClaw com créditos de API compartilhados pode custar de $30 a $50/mês no total, com acesso a todos os modelos e controle total dos dados.
Requisitos de Hardware
- Mínimo: Qualquer máquina com Node.js 18+ e 512MB de RAM
- Recomendado: 1 núcleo de CPU, 1GB de RAM, 10GB de armazenamento
- Para modelos locais (Ollama): Adicione os requisitos de GPU/Apple Silicon por modelo
O LemonClaw em si é leve. A inferência de IA acontece nos servidores do provedor de API (ou em sua instância local do Ollama).
Essa distinção é importante. Você não precisa de uma GPU para fazer o self-host do LemonClaw. Você só precisa de uma GPU se também quiser hospedar os modelos localmente.
Experimente o LemonClaw: faça o self-host com qualquer API de IA ou inicie uma instância hospedada na LemonData. Se você quiser comparar os custos antes de escolher, a comparação de preços é a próxima página a ser lida.