picoclaw/docs/project/README.pt-br.md

PicoClaw: Assistente de IA Ultra-Eficiente em Go

Hardware de $10 · 10MB de RAM · Boot em ms · Let's Go, PicoClaw!

中文 | 日本語 | 한국어 | Português | Tiếng Việt | Français | Italiano | Bahasa Indonesia | Malay | English

---

PicoClaw é um projeto open-source independente iniciado pela Sipeed, escrito inteiramente em Go do zero — não é um fork do OpenClaw, NanoBot ou qualquer outro projeto.

PicoClaw é um assistente de IA pessoal ultra-leve inspirado no NanoBot. Foi reconstruído do zero em Go por meio de um processo de "auto-bootstrapping" — o próprio AI Agent conduziu a migração de arquitetura e a otimização do código.

Roda em hardware de $10 com menos de 10MB de RAM — isso é 99% menos memória que o OpenClaw e 98% mais barato que um Mac mini!

Caution

Aviso de Segurança

• SEM CRIPTO: O PicoClaw não emitiu nenhum token oficial ou criptomoeda. Todas as alegações no pump.fun ou outras plataformas de negociação são golpes.
• DOMÍNIO OFICIAL: O ÚNICO site oficial é picoclaw.io, e o site da empresa é sipeed.com
• ATENÇÃO: Muitos domínios .ai/.org/.com/.net/... foram registrados por terceiros. Não confie neles.
• NOTA: O PicoClaw está em desenvolvimento rápido inicial. Podem existir problemas de segurança não resolvidos. Não implante em produção antes da v1.0.
• NOTA: O PicoClaw mesclou muitos PRs recentemente. Builds recentes podem usar 10-20MB de RAM. A otimização de recursos está planejada após a estabilização de funcionalidades.

📢 Novidades

2026-03-31 📱 Suporte Android! PicoClaw agora roda no Android! Baixe o APK em picoclaw.io

2026-03-25 🚀 v0.2.4 Lançada! Reformulação da arquitetura Agent (SubTurn, Hooks, Steering, EventBus), integração WeChat/WeCom, fortalecimento de segurança (.security.yml, filtragem de dados sensíveis), novos providers (AWS Bedrock, Azure, Xiaomi MiMo) e 35 correções de bugs. O PicoClaw atingiu 26K Stars!

2026-03-17 🚀 v0.2.3 Lançada! UI na bandeja do sistema (Windows e Linux), consulta de status de sub-agent (spawn_status), hot-reload experimental do Gateway, controle de segurança do Cron e 2 correções de segurança. O PicoClaw atingiu 25K Stars!

2026-03-09 🎉 v0.2.1 — Maior atualização até agora! Suporte ao protocolo MCP, 4 novos channels (Matrix/IRC/WeCom/Discord Proxy), 3 novos providers (Kimi/Minimax/Avian), pipeline de visão, armazenamento de memória JSONL, roteamento de modelos.

2026-02-28 📦 v0.2.0 lançada com suporte a Docker Compose e Web UI Launcher.

Notícias anteriores...

2026-02-26 🎉 O PicoClaw atinge 20K Stars em apenas 17 dias! Orquestração automática de channels e interfaces de capacidade estão disponíveis.

2026-02-16 🎉 O PicoClaw ultrapassa 12K Stars em uma semana! Funções de mantenedor da comunidade e Roadmap lançados oficialmente.

2026-02-13 🎉 O PicoClaw ultrapassa 5000 Stars em 4 dias! Roadmap do projeto e grupos de desenvolvedores em andamento.

2026-02-09 🎉 PicoClaw Lançado! Construído em 1 dia para levar AI Agents a hardware de $10 com menos de 10MB de RAM. Let's Go, PicoClaw!

✨ Funcionalidades

🪶 Ultra-leve: Footprint de memória do núcleo <10MB — 99% menor que o OpenClaw.*

💰 Custo mínimo: Eficiente o suficiente para rodar em hardware de $10 — 98% mais barato que um Mac mini.

⚡️ Boot ultrarrápido: Inicialização 400x mais rápida. Boot em menos de 1s mesmo em um processador single-core de 0,6GHz.

🌍 Verdadeiramente portátil: Binário único para arquiteturas RISC-V, ARM, MIPS e x86. Um binário, roda em qualquer lugar!

🤖 Bootstrapped por IA: Implementação nativa pura em Go — 95% do código principal foi gerado por um Agent e refinado por revisão humana.

🔌 Suporte a MCP: Integração nativa com o Model Context Protocol — conecte qualquer servidor MCP para estender as capacidades do Agent.

👁️ Pipeline de visão: Envie imagens e arquivos diretamente ao Agent — codificação base64 automática para LLMs multimodais.

🧠 Roteamento inteligente: Roteamento de modelos baseado em regras — consultas simples vão para modelos leves, economizando custos de API.

*Builds recentes podem usar 10-20MB devido a merges rápidos de PRs. Otimização de recursos está planejada. Comparação de velocidade de boot baseada em benchmarks de single-core a 0,8GHz (veja tabela abaixo).

	OpenClaw	NanoBot	PicoClaw
Linguagem	TypeScript	Python	Go
RAM	>1GB	>100MB	< 10MB*
Tempo de boot (core 0,8GHz)	>500s	>30s	<1s
Custo	Mac Mini $599	Maioria das placas Linux ~$50	Qualquer placa Linux a partir de $10

Lista de Compatibilidade de Hardware — Veja todas as placas testadas, de RISC-V de $5 ao Raspberry Pi e celulares Android. Sua placa não está listada? Envie um PR!

🦾 Demonstração

🛠️ Fluxos de Trabalho Padrão do Assistente

Modo Engenheiro Full-Stack	Registro e Planejamento	Busca na Web e Aprendizado
Desenvolver · Implantar · Escalar	Agendar · Automatizar · Lembrar	Descobrir · Insights · Tendências

🐜 Implantação Inovadora de Baixo Consumo

O PicoClaw pode ser implantado em praticamente qualquer dispositivo Linux!

• $9,9 LicheeRV-Nano edição E(Ethernet) ou W(WiFi6), para um assistente doméstico mínimo
• $30~50 NanoKVM, ou $100 NanoKVM-Pro, para operações automatizadas de servidor
• $50 MaixCAM ou $100 MaixCAM2, para vigilância inteligente

https://private-user-images.githubusercontent.com/83055338/547056448-e7b031ff-d6f5-4468-bcca-5726b6fecb5c.mp4

🌟 Mais Casos de Implantação Aguardam!

📦 Instalação

Download pelo picoclaw.io (Recomendado)

Acesse picoclaw.io — o site oficial detecta automaticamente sua plataforma e fornece download com um clique. Não é necessário selecionar a arquitetura manualmente.

Download do binário pré-compilado

Alternativamente, baixe o binário para sua plataforma na página de GitHub Releases.

Compilar a partir do código-fonte (para desenvolvimento)

Pré-requisitos:

• Go 1.25+
• Node.js 22+ e pnpm 10.33.0+ para builds do Web UI / launcher

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

cd picoclaw
make deps

# Instalar dependências do frontend
(cd web/frontend && pnpm install --frozen-lockfile)

# Compilar o binário principal
make build

# Compilar o Web UI Launcher (necessário para o modo WebUI)
make build-launcher

# Compilar os binários core para todas as plataformas gerenciadas pelo Makefile
make build-all

# Compilar para Raspberry Pi Zero 2 W (32-bit: make build-linux-arm; 64-bit: make build-linux-arm64)
make build-pi-zero

# Compilar e instalar
make install

Raspberry Pi Zero 2 W: Use o binário que corresponde ao seu SO: Raspberry Pi OS 32-bit -> make build-linux-arm; 64-bit -> make build-linux-arm64. Ou execute make build-pi-zero para compilar ambos.

🚀 Guia de Início Rápido

🌐 WebUI Launcher (Recomendado para Desktop)

O WebUI Launcher fornece uma interface baseada em navegador para configuração e chat. Esta é a maneira mais fácil de começar — sem necessidade de conhecimento de linha de comando.

Opção 1: Duplo clique (Desktop)

Após baixar de picoclaw.io, dê duplo clique em picoclaw-launcher (ou picoclaw-launcher.exe no Windows). Seu navegador abrirá automaticamente em http://localhost:18800.

Opção 2: Linha de comando

picoclaw-launcher
# Abra http://localhost:18800 no seu navegador

Tip

Acesso remoto / Docker / VM: Adicione a flag -public para escutar em todas as interfaces:

picoclaw-launcher -public

Primeiros passos:

Abra o WebUI e então: 1) Configure um Provider (adicione sua API key de LLM) -> 2) Configure um Channel (ex.: Telegram) -> 3) Inicie o Gateway -> 4) Converse!

Para documentação detalhada do WebUI, veja docs.picoclaw.io.

Docker (alternativa)

# 1. Clone este repositório
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# 2. Primeira execução — gera automaticamente docker/data/config.json e encerra
#    (só é acionado quando config.json e workspace/ estão ausentes)
docker compose -f docker/docker-compose.yml --profile launcher up
# O container imprime "First-run setup complete." e para.

# 3. Configure suas API keys
vim docker/data/config.json

# 4. Iniciar
docker compose -f docker/docker-compose.yml --profile launcher up -d
# Abra http://localhost:18800

Usuários de Docker / VM: O Gateway escuta em 127.0.0.1 por padrão. Defina PICOCLAW_GATEWAY_HOST=0.0.0.0 ou use a flag -public para torná-lo acessível pelo host.

# Verificar logs
docker compose -f docker/docker-compose.yml logs -f

# Parar
docker compose -f docker/docker-compose.yml --profile launcher down

# Atualizar
docker compose -f docker/docker-compose.yml pull
docker compose -f docker/docker-compose.yml --profile launcher up -d

macOS — Aviso de segurança no primeiro lançamento

O macOS pode bloquear o picoclaw-launcher no primeiro lançamento porque ele foi baixado da internet e não é notarizado pela Mac App Store.

Passo 1: Dê um duplo clique em picoclaw-launcher. Você verá um aviso de segurança:

"picoclaw-launcher" não foi aberto — A Apple não conseguiu verificar se "picoclaw-launcher" está livre de malware que possa prejudicar seu Mac ou comprometer sua privacidade.

Passo 2: Abra Configurações do Sistema → Privacidade e Segurança → role até a seção Segurança → clique em Abrir Mesmo Assim → confirme clicando em Abrir Mesmo Assim na caixa de diálogo.

Após esta etapa única, o picoclaw-launcher abrirá normalmente nos lançamentos seguintes.

📱 Android

Dê uma segunda vida ao seu celular de uma década! Transforme-o em um Assistente de IA inteligente com o PicoClaw.

Opção 1: Instalação via APK

Pré-visualização:

Baixe o APK de picoclaw.io e instale diretamente. Sem necessidade de Termux!

Opção 2: Termux

Terminal Launcher (para ambientes com recursos limitados)

1. Instale o Termux (baixe nas GitHub Releases, ou pesquise no F-Droid / Google Play)
2. Execute os seguintes comandos:

# Baixar a versão mais recente
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar xzf picoclaw_Linux_arm64.tar.gz
pkg install proot
termux-chroot ./picoclaw onboard   # chroot fornece um layout padrão de sistema de arquivos Linux

Em seguida, siga a seção Terminal Launcher abaixo para concluir a configuração.

Para ambientes mínimos onde apenas o binário principal picoclaw está disponível (sem Launcher UI), você pode configurar tudo via linha de comando e um arquivo de configuração JSON.

1. Inicializar

picoclaw onboard

Isso cria ~/.picoclaw/config.json e o diretório workspace.

2. Configurar (~/.picoclaw/config.json)

{
  "version": 3,
  "agents": {
    "defaults": {
      "model_name": "gpt-5.4"
    }
  },
  "model_list": [
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_keys": ["sk-your-api-key"]
    }
  ]
}

Veja config/config.example.json no repositório para um template de configuração completo com todas as opções disponíveis.

3. Conversar

# Pergunta única
picoclaw agent -m "What is 2+2?"

# Modo interativo
picoclaw agent

# Iniciar gateway para integração com app de chat
picoclaw gateway

🔌 Providers (LLM)

O PicoClaw suporta mais de 30 providers de LLM através da configuração model_list. Use o formato protocolo/modelo:

Provider	Protocolo	API Key	Notas
OpenAI	openai/	Obrigatória	GPT-5.4, GPT-4o, o3, etc.
Anthropic	anthropic/	Obrigatória	Claude Opus 4.6, Sonnet 4.6, etc.
Google Gemini	gemini/	Obrigatória	Gemini 3 Flash, 2.5 Pro, etc.
OpenRouter	openrouter/	Obrigatória	200+ modelos, API unificada
Zhipu (GLM)	zhipu/	Obrigatória	GLM-4.7, GLM-5, etc.
DeepSeek	deepseek/	Obrigatória	DeepSeek-V3, DeepSeek-R1
Volcengine	volcengine/	Obrigatória	Modelos Doubao, Ark
Qwen	qwen/	Obrigatória	Qwen3, Qwen-Max, etc.
Groq	groq/	Obrigatória	Inferência rápida (Llama, Mixtral)
Moonshot (Kimi)	moonshot/	Obrigatória	Modelos Kimi
Minimax	minimax/	Obrigatória	Modelos MiniMax
Mistral	mistral/	Obrigatória	Mistral Large, Codestral
NVIDIA NIM	nvidia/	Obrigatória	Modelos hospedados pela NVIDIA
Cerebras	cerebras/	Obrigatória	Inferência rápida
Novita AI	novita/	Obrigatória	Vários modelos abertos
Xiaomi MiMo	mimo/	Obrigatória	Modelos MiMo
Ollama	ollama/	Não necessária	Modelos locais, self-hosted
vLLM	vllm/	Não necessária	Implantação local, compatível com OpenAI
LiteLLM	litellm/	Varia	Proxy para 100+ providers
Azure OpenAI	azure/	Obrigatória	Implantação Azure Enterprise
GitHub Copilot	github-copilot/	OAuth	Login por código de dispositivo
Antigravity	antigravity/	OAuth	Google Cloud AI

Implantação local (Ollama, vLLM, etc.)

Ollama:

{
  "model_list": [
    {
      "model_name": "local-llama",
      "model": "ollama/llama3.1:8b",
      "api_base": "http://localhost:11434/v1"
    }
  ]
}

vLLM:

{
  "model_list": [
    {
      "model_name": "local-vllm",
      "model": "vllm/your-model",
      "api_base": "http://localhost:8000/v1"
    }
  ]
}

Para detalhes completos de configuração de providers, veja Providers & Models.

💬 Channels (Apps de Chat)

Converse com seu PicoClaw por meio de mais de 17 plataformas de mensagens:

Channel	Configuração	Protocolo	Docs
Telegram	Fácil (bot token)	Long polling	Guia
Discord	Fácil (bot token + intents)	WebSocket	Guia
WhatsApp	Fácil (QR scan ou bridge URL)	Nativo / Bridge	Guia
Weixin	Fácil (scan QR nativo)	iLink API	Guia
QQ	Fácil (AppID + AppSecret)	WebSocket	Guia
Slack	Fácil (bot + app token)	Socket Mode	Guia
Matrix	Médio (homeserver + token)	Sync API	Guia
DingTalk	Médio (credenciais do cliente)	Stream	Guia
Feishu / Lark	Médio (App ID + Secret)	WebSocket/SDK	Guia
LINE	Médio (credenciais + webhook)	Webhook	Guia
WeCom	Fácil (login QR ou manual)	WebSocket	Guia
IRC	Médio (servidor + nick)	Protocolo IRC	Guia
OneBot	Médio (WebSocket URL)	OneBot v11	Guia
MaixCam	Fácil (habilitar)	TCP socket	Guia
Pico	Fácil (habilitar)	Protocolo nativo	Integrado
Pico Client	Fácil (WebSocket URL)	WebSocket	Integrado

Todos os channels baseados em webhook compartilham um único servidor HTTP do Gateway (gateway.host:gateway.port, padrão 127.0.0.1:18790). O Feishu usa modo WebSocket/SDK e não utiliza o servidor HTTP compartilhado.

A verbosidade dos logs é controlada por gateway.log_level (padrão: warn). Valores suportados: debug, info, warn, error, fatal. Também pode ser definido via PICOCLAW_LOG_LEVEL. Veja Configuração para detalhes.

Para instruções detalhadas de configuração de channels, veja Configuração de Apps de Chat.

🔧 Ferramentas

🔍 Busca na Web

O PicoClaw pode pesquisar na web para fornecer informações atualizadas. Configure em tools.web:

Motor de Busca	API Key	Nível Gratuito	Link
DuckDuckGo	Não necessária	Ilimitado	Fallback integrado
Baidu Search	Obrigatória	1000 consultas/dia	IA, otimizado para chinês
Tavily	Obrigatória	1000 consultas/mês	Otimizado para AI Agents
Brave Search	Obrigatória	2000 consultas/mês	Rápido e privado
Perplexity	Obrigatória	Pago	Busca com IA
SearXNG	Não necessária	Self-hosted	Metabuscador gratuito
GLM Search	Obrigatória	Varia	Busca web Zhipu

⚙️ Outras Ferramentas

O PicoClaw inclui ferramentas integradas para operações de arquivo, execução de código, agendamento e mais. Veja Configuração de Ferramentas para detalhes.

🎯 Skills

Skills são capacidades modulares que estendem seu Agent. Elas são carregadas a partir de arquivos SKILL.md no seu workspace.

Instalar skills do ClawHub:

picoclaw skills search "web scraping"
picoclaw skills install <skill-name>

Configurar token do ClawHub (opcional, para limites de taxa mais altos):

Adicione ao seu config.json:

{
  "tools": {
    "skills": {
      "registries": {
        "clawhub": {
          "auth_token": "your-clawhub-token"
        }
      }
    }
  }
}

Para mais detalhes, veja Configuração de Ferramentas - Skills.

🔗 MCP (Model Context Protocol)

O PicoClaw suporta nativamente o MCP — conecte qualquer servidor MCP para estender as capacidades do seu Agent com ferramentas externas e fontes de dados.

{
  "tools": {
    "mcp": {
      "enabled": true,
      "servers": {
        "filesystem": {
          "enabled": true,
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
        }
      }
    }
  }
}

Para configuração completa de MCP (transportes stdio, SSE, HTTP, Tool Discovery), veja Configuração de Ferramentas - MCP.

Junte-se à Rede Social de Agents

Conecte o PicoClaw à Rede Social de Agents simplesmente enviando uma única mensagem via CLI ou qualquer App de Chat integrado.

Leia https://clawdchat.ai/skill.md e siga as instruções para entrar no ClawdChat.ai

🖥️ Referência CLI

Comando	Descrição
picoclaw onboard	Inicializar config e workspace
picoclaw auth weixin	Conectar conta WeChat via QR
picoclaw agent -m "..."	Conversar com o agent
picoclaw agent	Modo de chat interativo
picoclaw gateway	Iniciar o gateway
picoclaw status	Exibir status
picoclaw version	Exibir informações de versão
picoclaw model	Ver ou trocar o modelo padrão
picoclaw cron list	Listar todos os jobs agendados
picoclaw cron add ...	Adicionar um job agendado
picoclaw cron disable	Desabilitar um job agendado
picoclaw cron remove	Remover um job agendado
picoclaw skills list	Listar skills instaladas
picoclaw skills install	Instalar uma skill
picoclaw migrate	Migrar dados de versões anteriores
picoclaw auth login	Autenticar com providers

⏰ Tarefas Agendadas / Lembretes

O PicoClaw suporta lembretes agendados e tarefas recorrentes através da ferramenta cron:

• Lembretes únicos: "Lembre-me em 10 minutos" -> dispara uma vez após 10min
• Tarefas recorrentes: "Lembre-me a cada 2 horas" -> dispara a cada 2 horas
• Expressões cron: "Lembre-me às 9h diariamente" -> usa expressão cron

📚 Documentação

Para guias detalhados além deste README:

Tópico	Descrição
Docker & Início Rápido	Configuração do Docker Compose, modos Launcher/Agent
Apps de Chat	Guias de configuração para todos os 17+ channels
Configuração	Variáveis de ambiente, layout do workspace, sandbox de segurança
Providers & Models	30+ providers de LLM, roteamento de modelos, configuração de model_list
Spawn & Tarefas Assíncronas	Tarefas rápidas, tarefas longas com spawn, orquestração assíncrona de sub-agents
Hooks	Sistema de hooks orientado a eventos: observadores, interceptores, hooks de aprovação
Steering	Injetar mensagens em um loop de agente em execução
SubTurn	Coordenação de subagentes, controle de concorrência, ciclo de vida
Solução de Problemas	Problemas comuns e soluções
Configuração de Ferramentas	Habilitar/desabilitar por ferramenta, políticas de exec, MCP, Skills
Compatibilidade de Hardware	Placas testadas, requisitos mínimos

🤝 Contribuir & Roadmap

PRs são bem-vindos! O código-fonte é intencionalmente pequeno e legível.

Veja nosso Roadmap da Comunidade e CONTRIBUTING.md para diretrizes.

Grupo de desenvolvedores em formação, entre após seu primeiro PR mesclado!

Grupos de Usuários:

Discord: https://discord.gg/V4sAZ9XWpN

WeChat: