美電球
28 KiB
PicoClaw: Assistente de IA Ultra-Eficiente em Go
Hardware de $10 · 10MB de RAM · Boot em ms · Let's Go, PicoClaw!
-SipeedIO-black?style=flat&logo=x&logoColor=white){kind=icon}
中文 | 日本語 | 한국어 | 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.funou 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-05-11 🛒 LicheeRV-Claw no AliExpress! Agora você pode comprar o LicheeRV-Claw no AliExpress, facilitando testar o PicoClaw em hardware RISC-V compacto.
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
🌟 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
-publicpara 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.1por padrão. DefinaPICOCLAW_GATEWAY_HOST=0.0.0.0ou use a flag-publicpara 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)
- Instale o Termux (baixe nas GitHub Releases, ou pesquise no F-Droid / Google Play)
- 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.jsonno 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 |
| Fácil (QR scan ou bridge URL) | Nativo / Bridge | Guia | |
| Weixin | Fácil (scan QR nativo) | iLink API | Guia |
| 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ão127.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 viaPICOCLAW_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 | 1500 consultas/mês (alocação diária) | 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: