Tutorial de instalação e configuração do PicoClaw: implante seu assistente de IA pessoal em três passos

10 min de leitura

Desde requisitos de sistema até a configuração de bots multiplataforma, implantação via Docker e agendamento de tarefas, este tutorial completo de instalação e configuração do PicoClaw cobre todos os cenários.

Requisitos de sistema

O PicoClaw tem requisitos de hardware extremamente baixos:

  • Sistema operacional: Linux / macOS / Windows (WSL2)
  • Arquitetura suportada: x86_64 / ARM64 / RISC-V
  • Memória mínima: 64MB (recomendado 512MB ou mais)
  • Dependências: Chave de API de LLM (necessária para conversas com IA)

Plataformas suportadas: macOS, Linux, Windows (WSL2), Raspberry Pi, Docker

Passo 1: Clonar o repositório

Abra o terminal e execute o seguinte comando:

bash
git clone https://github.com/sipeed/picoclaw.git

Após concluir a clonagem, entre no diretório do projeto:

bash
cd picoclaw

Passo 2: Inicializar a configuração

Execute o comando onboard para iniciar:

bash
picoclaw onboard

Siga as instruções para concluir a configuração:

  1. Chave de API de LLM: Insira a chave de API do seu provedor de LLM.
  2. Preferências de modelo: Selecione o modelo de IA que deseja usar como padrão.
  3. Token da plataforma de mensagens (opcional): Se desejar habilitar a integração com Telegram, Discord, QQ ou DingTalk, insira o Token do bot correspondente.

O arquivo de configuração é salvo localmente; todos os dados permanecem no seu dispositivo e não são enviados para a nuvem.

Passo 3: Iniciar a conversa

Após a configuração, comece a conversar com a IA.

Modo interativo

bash
picoclaw agent

Inicia a interface de conversa interativa, permitindo enviar mensagens continuamente e receber respostas.

Modo de consulta única

bash
picoclaw agent -m "Olá, apresente-se por favor"

Envia uma única mensagem, recebe a resposta e encerra, ideal para uso em scripts.

Iniciar o serviço de gateway

Para usar em plataformas de mensagens como Telegram ou QQ:

bash
picoclaw gateway

Após iniciar, você pode interagir com o PicoClaw através do bot em cada plataforma.

Configuração de bots multiplataforma

Telegram Bot

No Telegram, encontre o @BotFather, envie /newbot para criar um bot e obter o Token. Insira o Token no arquivo de configuração e inicie o picoclaw gateway.

Discord Bot

Crie uma aplicação no Portal do Desenvolvedor do Discord, obtenha o Token nas configurações do Bot, convide o bot para o seu servidor e insira o Token na configuração.

QQ Bot

Consulte a documentação da plataforma aberta do QQ para registrar um bot, obter o AppID e o Token, e insira-os no arquivo de configuração.

DingTalk Bot

Crie uma aplicação de robô na plataforma aberta do DingTalk, obtenha a URL do Webhook e a chave secreta, e insira-os no arquivo de configuração.

Implantação via Docker

O PicoClaw suporta implantação via Docker, ideal para servidores ou ambientes sem interface gráfica:

bash
docker pull ghcr.io/sipeed/picoclaw:latestdocker run -d   --name picoclaw   -v /path/to/config:/config   -e PICOCLAW_API_KEY=your_key   ghcr.io/sipeed/picoclaw:latest

Configuração de tarefas agendadas

O PicoClaw possui suporte nativo a cron, gerenciado através do arquivo de configuração.

Lembrete único

yaml
tasks:  - type: reminder    time: "1h"    message: "Lembrete de reunião: Reunião semanal da equipe"

Tarefas periódicas

yaml
tasks:  - type: cron    schedule: "0 8 * * *"    message: "Gerar resumo de trabalho de hoje"

Perguntas frequentes

O PicoClaw precisa de conexão com a internet?

O PicoClaw pode funcionar offline, mas a chamada de APIs de LLM e a integração com plataformas de mensagens exigem conexão com a internet.

Quais provedores de LLM são suportados?

Suporta OpenRouter, Zhipu AI, Anthropic, OpenAI, DeepSeek, Groq, entre outros, podendo ser alternados livremente via arquivo de configuração.

Como atualizar o PicoClaw?

Entre no diretório do projeto, execute git pull para baixar o código mais recente e recompile.

Onde os dados são armazenados?

Todo o histórico de conversas e dados de configuração são armazenados no sistema de arquivos local, sob total controle do usuário.

Qual o tamanho da imagem Docker?

A imagem Docker do PicoClaw tem cerca de 15MB, muito menor que os 350MB+ dos concorrentes.

É possível rodar no Raspberry Pi?

Sim, o PicoClaw suporta a arquitetura ARM64; o Raspberry Pi 4 (4GB+) é suficiente para uma execução fluida.

Como configurar vários bots para uso simultâneo?

Adicione os Tokens e as configurações de cada plataforma no arquivo de configuração e inicie o picoclaw gateway para ativar todos os bots simultaneamente.