BeaconCat
403ceb39be
## Config field fixes (cross-verified against Go source) - MaixCam: server_address → host + port - IRC: use_tls → tls, channels_to_join → channels (all 6 languages) - WeCom AI Bot: callback port 18791 → 18790 - credential_encryption: base_url → api_base, add required model field, remove incorrect passphrase-only mode docs - providers.md: agents.defaults.model → model_name (×4), remove non-existent session.backlog_limit - migration guide, troubleshooting: agents.defaults.model → model_name - ANTIGRAVITY_AUTH: fix file path, Go 1.21 → 1.25, model → model_name - spawn-tasks: fix truncated file, add Heartbeat introduction - tools_configuration: add Tavily/SearXNG/GLMSearch, exec allow_remote/ timeout_seconds/custom_allow_patterns, cron allow_command, skills github/search_cache, clawhub timeout/max_zip_size/max_response_size - configuration: fix builtin skills path (build-time embedded, not cwd), HEARTBEAT.md marked auto-generated ## Broken link fixes (15 total) - chat-apps.md: WeCom/Matrix links with wrong relative paths - providers.md: migration link with extra docs/ prefix - hardware-compatibility.md: README links with wrong depth (all 5 langs) - chat-apps.md: WhatsApp dead links → anchor links (zh/ja) ## Getting-started accuracy - README (all 6 langs): add picoclaw.io as recommended download, add missing picoclaw model CLI command - docker.md: clarify first-run trigger condition (all 6 langs) - configuration.md: fix builtin skills path description (all 6 langs) ## QQ channel - Add quick setup via q.qq.com/qqbot/openclaw (one-click bot creation) - Add manual setup as fallback (all 6 languages) ## Feishu channel - Update setup flow: WebSocket/SDK mode, no webhook URL needed - Preserve Lark international domain note (all 6 languages) ## chat-apps.md - Add Feishu, Slack, IRC, OneBot detail sections (all 6 languages) - Add MaixCam section to ja/fr/pt-br/vi - Fix all channel doc links to point to correct language version ## New translations (25 files, 5 docs × 5 languages) debug.md, credential_encryption.md, hardware-compatibility.md, ANTIGRAVITY_AUTH.md, ANTIGRAVITY_USAGE.md → zh/ja/fr/pt-br/vi ## Channel docs (6 languages each, 60 new files) telegram, discord, qq, feishu, maixcam, dingtalk, line, slack, onebot, wecom/wecom_aibot, wecom/wecom_app, wecom/wecom_bot Co-authored-by: BeaconCat <BeaconCat@users.noreply.github.com>
14 KiB
PicoClaw: Assistente de IA Ultra-Eficiente em Go
Hardware de $10 · <10MB de RAM · Boot em <1s · 皮皮虾，我们走！
-SipeedIO-black?style=flat&logo=x&logoColor=white){kind=icon}
中文 | 日本語 | Português | Tiếng Việt | Français | Italiano | Bahasa Indonesia | English
PicoClaw é um projeto open-source independente iniciado pela Sipeed. É escrito inteiramente em Go — não é um fork do OpenClaw, NanoBot ou qualquer outro projeto.
🦐 PicoClaw é um assistente pessoal de IA ultra-leve inspirado no NanoBot, reescrito do zero em Go por meio de um processo de auto-inicialização (self-bootstrapping), onde o próprio agente de IA conduziu toda a migração de arquitetura e otimização de código.
⚡️ Roda em hardware de $10 com <10MB de RAM: Isso é 99% menos memória que o OpenClaw e 98% mais barato que um Mac mini!
|
|
|
Caution
🚨 DECLARAÇÃO DE SEGURANÇA & CANAIS OFICIAIS
SEM CRIPTOMOEDAS: O PicoClaw NÃO possui nenhum token/moeda oficial. Todas as alegações no
pump.funou outras plataformas de negociação são GOLPES.DOMÍNIO OFICIAL: O ÚNICO site oficial é o picoclaw.io, e o site da empresa é o sipeed.com
Aviso: Muitos domínios
.ai/.org/.com/.net/...foram registrados por terceiros.Aviso: O PicoClaw está em fase inicial de desenvolvimento e pode ter problemas de segurança de rede não resolvidos. Não implante em ambientes de produção antes da versão v1.0.
Nota: O PicoClaw recentemente fez merge de muitos PRs, o que pode resultar em maior consumo de memória (10–20MB) nas versões mais recentes. Planejamos priorizar a otimização de recursos assim que o conjunto de funcionalidades estiver estável.
📢 Novidades
2026-03-17 🚀 v0.2.3 Lançado! Interface de bandeja do sistema (Windows & Linux), rastreamento de status de sub-agentes (spawn_status), hot-reload experimental do gateway, portões de segurança para cron e 2 correções de segurança. PicoClaw agora com 25K ⭐!
2026-03-09 🎉 v0.2.1 — Maior atualização até agora! Suporte ao protocolo MCP, 4 novos canais (Matrix/IRC/WeCom/Discord Proxy), 3 novos provedores (Kimi/Minimax/Avian), pipeline de visão, armazenamento de memória JSONL e roteamento de modelos.
2026-02-28 📦 v0.2.0 lançado com suporte a Docker Compose e launcher Web UI.
2026-02-26 🎉 PicoClaw atingiu 20K stars em apenas 17 dias! Orquestração automática de canais e interfaces de capacidade implementadas.
Novidades anteriores...
2026-02-16 🎉 PicoClaw atingiu 12K stars em uma semana! Papéis de maintainers da comunidade e roadmap publicados oficialmente.
2026-02-13 🎉 PicoClaw atingiu 5000 stars em 4 dias! Roadmap do Projeto e Grupo de Desenvolvedores em preparação.
2026-02-09 🎉 PicoClaw Lançado! Construído em 1 dia para trazer Agentes de IA para hardware de $10 com <10MB de RAM. 🦐 PicoClaw, Partiu!
✨ Funcionalidades
🪶 Ultra-Leve: Consumo de memória <10MB — 99% menor que o OpenClaw para funcionalidades essenciais.*
💰 Custo Mínimo: Eficiente o suficiente para rodar em hardware de $10 — 98% mais barato que um Mac mini.
⚡️ Inicialização Relâmpago: Tempo de inicialização 400X mais rápido, boot em <1 segundo mesmo em CPU single-core de 0.6GHz.
🌍 Portabilidade Real: Um único binário auto-contido para RISC-V, ARM, MIPS e x86. Um clique e já era!
🤖 Auto-Construído por IA: Implementação nativa em Go de forma autônoma — 95% do núcleo gerado pelo Agente com refinamento humano no loop.
🔌 Suporte MCP: Integração nativa com o Model Context Protocol — conecte qualquer servidor MCP para estender as capacidades do agente.
👁️ Pipeline de Visão: Envie imagens e arquivos diretamente ao agente — 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.
*Versões recentes podem usar 10–20MB devido a merges rápidos de funcionalidades. Otimização de recursos está planejada. Comparação de inicialização baseada em benchmarks de single-core a 0.8GHz (veja tabela abaixo).
| OpenClaw | NanoBot | PicoClaw | |
|---|---|---|---|
| Linguagem | TypeScript | Python | Go |
| RAM | >1GB | >100MB | < 10MB* |
| Inicialização (CPU 0.8GHz) |
>500s | >30s | <1s |
| Custo | Mac Mini $599 | Maioria dos SBC Linux ~$50 |
Qualquer placa Linux A partir de $10 |
📋 Lista de Compatibilidade de Hardware — Veja todas as placas testadas, de RISC-V de $5 a Raspberry Pi e telefones Android. Sua placa não está listada? Envie um PR!
🦾 Demonstração
🛠️ Fluxos de Trabalho Padrão do Assistente
🧩 Engenharia Full-Stack |
🗂️ Gerenciamento de Logs & Planejamento |
🔎 Busca Web & Aprendizado |
|---|---|---|
|
|
|
| Desenvolver • Implantar • Escalar | Agendar • Automatizar • Memorizar | Descobrir • Analisar • Tendências |
📱 Rode em celulares Android antigos
Dê uma segunda vida ao seu celular de dez anos atrás! Transforme-o em um assistente de IA inteligente com o PicoClaw. Início rápido:
- Instale o Termux (Baixe em GitHub Releases, ou busque no F-Droid / Google Play).
- Execute os comandos
# Baixe a versão mais recente em https://github.com/sipeed/picoclaw/releases
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 do sistema de arquivos Linux
Depois siga as instruções na seção "Início Rápido" para completar a configuração!
🐜 Implantação Inovadora com Baixo Consumo
O PicoClaw pode ser implantado em praticamente qualquer dispositivo Linux!
- $9.9 LicheeRV-Nano versão E(Ethernet) ou W(WiFi6), para Assistente Doméstico Minimalista
- $30~50 NanoKVM, ou $100 NanoKVM-Pro para Manutenção Automatizada de Servidores
- $50 MaixCAM ou $100 MaixCAM2 para Monitoramento Inteligente
🌟 Mais cenários de implantação aguardam você!
📦 Instalação
Baixar de picoclaw.io (Recomendado)
Visite picoclaw.io — o site oficial detecta automaticamente sua plataforma e oferece download com um clique. Sem necessidade de escolher manualmente a arquitetura.
Baixar 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)
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make deps
# Build, sem necessidade de instalar
make build
# Build para múltiplas plataformas
make build-all
# Build para Raspberry Pi Zero 2 W (32-bit: make build-linux-arm; 64-bit: make build-linux-arm64)
make build-pi-zero
# Build e Instalar
make install
Raspberry Pi Zero 2 W: Use o binário correspondente 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.
📚 Documentação
Para guias detalhados, consulte a documentação abaixo. Este README cobre apenas o início rápido.
| Tópico | Descrição |
|---|---|
| 🐳 Docker & Início Rápido | Configuração Docker Compose, modos Launcher/Agent, configuração de Início Rápido |
| 💬 Apps de Chat | Telegram, Discord, WhatsApp, Matrix, QQ, Slack, IRC, DingTalk, LINE, Feishu, WeCom e mais |
| ⚙️ Configuração | Variáveis de ambiente, estrutura do workspace, fontes de skills, sandbox de segurança, heartbeat |
| 🔌 Provedores & Modelos | 20+ provedores LLM, roteamento de modelos, configuração model_list, arquitetura de provedores |
| 🔄 Spawn & Tarefas Assíncronas | Tarefas rápidas, tarefas longas com spawn, orquestração assíncrona de sub-agentes |
| 🐛 Solução de Problemas | Problemas comuns e soluções |
| 🔧 Configuração de Ferramentas | Habilitar/desabilitar por ferramenta, políticas de execução |
| 📋 Compatibilidade de Hardware | Placas testadas, requisitos mínimos, como adicionar sua placa |
Junte-se à Rede Social de Agentes
Conecte o PicoClaw à Rede Social de Agentes 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 configuração & workspace |
picoclaw agent -m "..." |
Conversar com o agente |
picoclaw agent |
Modo de chat interativo |
picoclaw gateway |
Iniciar o gateway |
picoclaw status |
Mostrar status |
picoclaw version |
Mostrar informações de versão |
picoclaw cron list |
Listar todas as tarefas agendadas |
picoclaw cron add ... |
Adicionar uma tarefa agendada |
picoclaw cron disable |
Desabilitar uma tarefa agendada |
picoclaw cron remove |
Remover uma tarefa agendada |
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 provedores |
picoclaw model |
Ver ou trocar o modelo padrão |
Tarefas Agendadas / Lembretes
O PicoClaw suporta lembretes agendados e tarefas recorrentes por meio da ferramenta cron:
- Lembretes únicos: "Me lembre em 10 minutos" → dispara uma vez após 10min
- Tarefas recorrentes: "Me lembre a cada 2 horas" → dispara a cada 2 horas
- Expressões Cron: "Me lembre às 9h todos os dias" → usa expressão cron
🤝 Contribuir & Roadmap
PRs são bem-vindos! O código-fonte é intencionalmente pequeno e legível. 🤗
Veja nosso Roadmap da Comunidade completo.
Grupo de desenvolvedores em formação. Junte-se após seu primeiro PR com merge!
Grupos de usuários:
discord: https://discord.gg/V4sAZ9XWpN