README.Pt Br

<a href="https://picoclaw.io"></a>
<a href="https://docs.picoclaw.io/"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"></a>


<a href="https://x.com/SipeedIO"></a>
<a href="../../assets/wechat.png"></a>
<a href="https://discord.gg/V4sAZ9XWpN"></a>

中文 | 日本語 | 한국어 | 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.

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).

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

🐜 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:

bashCopy

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.

# 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

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.

<a id="-run-on-old-android-phones"></a>

📱 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

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)

{
  "agents": {
    "defaults": {
      "model_name": "gpt-5.4"
    }
  },
  "model_list": [
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_key": "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:

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:

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:

⚙️ 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

⏰ 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:

🤝 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: