Guia de Introdução Rápida do Moltbot

Eu queria experimentar o Moltbot no Linux-Console.net, mas ainda não tinha tido oportunidade. Então, no fim de semana apareceu o tweet do Nader e o seu excelente gist, e claro que tive de experimentar. Este guia é tudo o que aprendi ao longo do caminho.

Moltbot (anteriormente conhecido como Clawdbot e criado por Peter Steinberger) é um assistente pessoal que está sempre ativo, alimentado pelo LLM da sua escolha - Anthropic, OpenAI ou modelos locais. Como "a IA que realmente faz coisas", pode hospedá-lo no seu próprio computador e ele consegue executar uma variedade de tarefas, como gerir o seu calendário, navegar na web, organizar os seus ficheiros, gerir os seus emails e executar comandos no terminal. Interage com ele através das aplicações de chat que já utiliza - WhatsApp, iMessage, Telegram - em vez de uma nova aplicação ou interface. Mantém o estado, suporta competências e torna-se mais útil à medida que vai integrando mais coisas nele.

Porque Executá-lo na Nuvem?

A maioria das pessoas executa o Moltbot localmente. Alguns em máquinas de reserva em casa, outros num Mac mini comprado especificamente para isso (tenho quase a certeza de que a Apple reparou). Isso funciona, mas eu não queria outra máquina a correr 24/7 na minha secretária. O que eu queria era, em vez disso, um agente sempre ativo que estivesse na nuvem, e eu queria conversar com ele através do WhatsApp. Acontece que o Moltbot funciona perfeitamente num droplet da Linux-Console.net.

No entanto, da forma que decidir executá-lo, dar a um framework de agente de terceiros acesso à sua máquina local introduz muitos riscos de segurança, por isso use o Moltbot por sua própria conta e risco. É altamente recomendado implantá-lo num ambiente isolado que não contenha dados sensíveis ou privados.

O Que Precisa

Uma conta no Linux-Console.net, uma chave de API para o seu LLM de escolha (Claude, OpenAI, Gemini, etc.) e uma chave SSH na sua máquina local (gere uma com ssh-keygen -t rsa -b 4096 se necessário). Como funciona: O droplet executa o Moltbot Gateway 24/7. Você conversa com ele através do WhatsApp, da interface de terminal TUI ou de um painel web. O gateway conecta-se a serviços externos através de skills.

`

Configurando o Droplet

Passo 1: Criar o Droplet

1. Inicie sessão e crie um novo Droplet
2. Escolha Ubuntu 24.04 LTS, uma região próxima de si, e um plano com 2GB de RAM (recomendado)
3. Adicione a sua chave SSH (cole a sua chave pública de cat ~/.ssh/id_rsa.pub)

4. Clique em "Criar Droplet". Espere cerca de um minuto. Vai receber um endereço IP - guarde-o como YOUR_DROPLET_IP.

   

Passo 2: Ligar ao Droplet

No seu computador local:

ssh root@YOUR_DROPLET_IP

Está agora dentro do seu servidor na cloud.

Passo 3: Configurar um Utilizador

Por motivos de segurança, não execute tudo como root. Crie um utilizador clawd:

adduser clawd && usermod -aG sudo clawd && su - clawd

Isto cria o utilizador, concede-lhe permissões de sudo e muda para ele. Defina uma palavra-passe quando solicitado.

Passo 4: Instalar o Moltbot

curl -fsSL https://clawd.bot/install.sh | bash
exec bash

O instalador descarrega tudo e configura. O comando exec bash reinicia o seu shell para carregar a configuração.

Passo 5: Configurar e Iniciar o Moltbot

Execute o assistente de integração com a opção de serviço:

clawdbot onboard --install-daemon

Isto faz tudo de uma vez: configura o seu fornecedor de LLM (Anthropic, OpenAI, etc.), prepara o espaço de trabalho, liga os seus canais de chat e instala um serviço systemd para que o gateway funcione automaticamente. (Pode sempre executar novamente clawdbot onboard mais tarde para alterar as configurações.) Eu escolhi o WhatsApp - verá um código QR, escaneie-o com o WhatsApp (Definições → Dispositivos ligados → Ligar um dispositivo) para se conectar.

Uma vez que o assistente esteja concluído, o gateway estará a funcionar. Está pronto para conversar. Para mais detalhes, consulte o guia oficial de introdução.

Começar a conversar

Agora tem duas formas de falar com o Moltbot:

Conversar via WhatsApp

Abre o WhatsApp, encontra a conversa com o teu próprio número e envia “Olá!”. O Moltbot recebe a mensagem, processa-a com o teu LLM e responde. Conceito importante: não estás a enviar mensagens a outras pessoas. Estás a conversar com o Moltbot através do WhatsApp. Este mesmo padrão funciona com iMessage, Telegram e outros canais.

Conversar via Terminal

Faça SSH no seu droplet e execute:

clawdbot tui

Isto abre uma TUI interativa mesmo no teu terminal. Na verdade, esta é agora a minha configuração por defeito.

Gerir o Gateway

Como utilizou --install-daemon, o gateway funciona como um serviço systemd. Gerencie-o com:

clawdbot gateway status # check status
clawdbot gateway restart # restart
clawdbot gateway stop # stop
clawdbot gateway start # start

Ver registos com:

clawdbot logs --follow

O gateway não está ligado à sua sessão de terminal. Feche o SSH, desligue-se - ele continua a correr no droplet.

Aceder ao Painel (Opcional)

Também pode aceder ao Moltbot através de um painel web. Isto requer um túnel SSH, uma vez que o painel apenas se liga ao localhost.

Configure o acesso SSH para o utilizador clawd:

# On the droplet (as clawd user)
mkdir -p ~/.ssh && chmod 700 ~/.ssh
nano ~/.ssh/authorized_keys
# Paste your public key, save, then:
chmod 600 ~/.ssh/authorized_keys

Crie um túnel SSH a partir do seu computador local:

ssh -L 18789:127.0.0.1:18789 clawd@YOUR_DROPLET_IP

Abrir no navegador:

http://127.0.0.1:18789

Instalar Competências

O Moltbot vem com mais de 50 competências incluídas (tempo, GitHub, Notion, Slack, etc.) - elas são carregadas automaticamente. O ClawdHub é o registo de competências. Para adicionar mais competências:

clawdhub search "what you need"
clawdhub install <skill-name>

As competências são apenas ficheiros de instruções (SKILL.md) - eles dizem ao Moltbot como usar uma ferramenta. Aqui está como é a competência wacli:

A ferramenta propriamente dita (CLI, API, etc.) precisa de ser instalada separadamente. O Moltbot avisar-lhe-á se faltar algo quando tentar usá-la.

Nota sobre dependências: Algumas competências necessitam de ferramentas instaladas via brew. O Ubuntu não tem o Homebrew por defeito - instale-o primeiro se necessário:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv bash)"' >> ~/.bashrc
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv bash)"

Compreender o Sistema de Memória

Depois de conversar um pouco com o Moltbot através do WhatsApp, fiquei curioso sobre algo: Como é que ele lembra o contexto das conversas? Olhei na diretoria do espaço de trabalho:

ls ~/clawd/

Vi vários ficheiros markdown:

AGENTS.md - Available agents
BOOTSTRAP.md - Initial system setup
HEARTBEAT.md - System health
IDENTITY.md - Moltbot's identity
SOUL.md - Personality traits
TOOLS.md - Available tools
USER.md - What it knows about you
canvas/ - Working directory
memory/ - Persistent memory

Esta foi a parte mais fascinante: Ao contrário da IA sem estado, o Moltbot realmente se lembra das coisas. Cada conversa que tem - seja através do WhatsApp, do painel web, do iMessage ou do Telegram - cria contexto. O ficheiro USER.md cresce à medida que interage. O directório memory/ armazena memórias de longo prazo. É por isso que pode ter uma conversa no WhatsApp e depois continuá-la mais tarde através do painel web - o Clawdbot lembra-se. Pode editar estes ficheiros para alterar o comportamento do Moltbot, adicionar contexto sobre si, os seus projetos, etc. Estes ficheiros são guardados no droplet - se eliminar o droplet, perde esta memória. Faça um backup!

Fazer Backup da Sua Memória

Do seu computador local:

scp -r clawd@YOUR_DROPLET_IP:~/clawd ~/clawdbot-backup-$(date +%Y%m%d)

Isto descarrega todo o diretório clawd para a sua máquina local com um nome de pasta datado.

Restaurar mais tarde:

scp -r ~/clawdbot-backup-20260126/clawd clawd@YOUR_DROPLET_IP:~/

Configure um trabalho cron de backup semanal ou use os Snapshots do Linux-Console.net.

Referência Rápida

SSH para o droplet:

ssh clawd@YOUR_DROPLET_IP

Começar a conversar:

clawdbot tui

Verificar estado da gateway:

clawdbot gateway status

Aceder ao painel (opcional):

# From local machine - create tunnel first
ssh -L 18789:127.0.0.1:18789 clawd@YOUR_DROPLET_IP
# Then open http://127.0.0.1:18789

Vou continuar a brincar com isto - a acrescentar mais competências, a ligar mais ferramentas e a ver quão útil se torna com o tempo.

Obrigado por aprender com a comunidade Linux-Console.net.