27 KiB
PicoClaw: Asistente de IA Ultra-Eficiente en Go
Hardware de $10 · 10MB de RAM · Boot en ms · ¡Vamos, PicoClaw!
-SipeedIO-black?style=flat&logo=x&logoColor=white){kind=icon}
中文 | 日本語 | Português | Tiếng Việt | Français | Italiano | Bahasa Indonesia | English | Español
PicoClaw es un proyecto de código abierto independiente iniciado por Sipeed, escrito completamente en Go desde cero — no es un fork de OpenClaw, NanoBot ni ningún otro proyecto.
PicoClaw es un asistente personal de IA ultra-ligero inspirado en NanoBot. Fue reconstruido desde cero en Go mediante un proceso de "auto-bootstrapping" — el propio Agente de IA impulsó la migración de arquitectura y la optimización del código.
Funciona en hardware de $10 con menos de 10MB de RAM — eso es un 99% menos de memoria que OpenClaw y un 98% más barato que una Mac mini.
|
|
|
Caution
Aviso de Seguridad
- SIN CRIPTO: PicoClaw no ha emitido ningún token oficial ni criptomoneda. Todas las afirmaciones en
pump.funu otras plataformas de trading son estafas.- DOMINIO OFICIAL: El ÚNICO sitio web oficial es picoclaw.io, y el sitio de la empresa es sipeed.com
- CUIDADO: Muchos dominios
.ai/.org/.com/.net/...han sido registrados por terceros. No confíes en ellos.- NOTA: PicoClaw está en desarrollo temprano y rápido. Puede haber problemas de seguridad sin resolver. No despliegues en producción antes de la v1.0.
- NOTA: PicoClaw ha fusionado recientemente muchos PRs. Las versiones recientes pueden usar entre 10 y 20MB de RAM. La optimización de recursos está planificada tras la estabilización de funcionalidades.
📢 Novedades
2026-03-17 🚀 ¡v0.2.3 lanzada! UI en bandeja del sistema (Windows y Linux), consulta de estado de sub-agentes (spawn_status), recarga en caliente experimental del Gateway, control de seguridad en Cron, y 2 correcciones de seguridad. ¡PicoClaw alcanzó las 25K Stars!
2026-03-09 🎉 v0.2.1 — ¡La mayor actualización hasta ahora! Soporte del protocolo MCP, 4 nuevos canales (Matrix/IRC/WeCom/Discord Proxy), 3 nuevos proveedores (Kimi/Minimax/Avian), pipeline de visión, almacenamiento de memoria JSONL, enrutamiento de modelos.
2026-02-28 📦 v0.2.0 lanzada con soporte para Docker Compose y Web UI Launcher.
2026-02-26 🎉 ¡PicoClaw alcanza las 20K Stars en solo 17 días! La auto-orquestación de canales e interfaces de capacidades ya están disponibles.
Noticias anteriores...
2026-02-16 🎉 ¡PicoClaw supera las 12K Stars en una semana! Roles de mantenedores de la comunidad y Roadmap lanzados oficialmente.
2026-02-13 🎉 ¡PicoClaw supera las 5000 Stars en 4 días! Hoja de ruta del proyecto y grupos de desarrolladores en proceso.
2026-02-09 🎉 ¡PicoClaw lanzado! Construido en 1 día para llevar Agentes de IA a hardware de $10 con menos de 10MB de RAM. ¡Vamos, PicoClaw!
✨ Características
🪶 Ultra-ligero: Huella de memoria del núcleo menor a 10MB — un 99% más pequeño que OpenClaw.*
💰 Costo mínimo: Lo suficientemente eficiente para funcionar en hardware de $10 — un 98% más barato que una Mac mini.
⚡️ Arranque ultrarrápido: 400 veces más rápido en el inicio. Arranca en menos de 1 segundo incluso en un procesador de un solo núcleo a 0.6GHz.
🌍 Verdaderamente portable: Un único binario para arquitecturas RISC-V, ARM, MIPS y x86. ¡Un binario, funciona en todas partes!
🤖 Auto-bootstrapped con IA: Implementación nativa en Go puro — el 95% del código base fue generado por un Agente y perfeccionado mediante revisión humana.
🔌 Soporte MCP: Integración nativa con el Model Context Protocol — conecta cualquier servidor MCP para extender las capacidades del Agente.
👁️ Pipeline de visión: Envía imágenes y archivos directamente al Agente — codificación automática en base64 para LLMs multimodales.
🧠 Enrutamiento inteligente: Enrutamiento de modelos basado en reglas — las consultas simples van a modelos ligeros, ahorrando costos de API.
*Las versiones recientes pueden usar entre 10 y 20MB debido a la fusión rápida de PRs. La optimización de recursos está planificada. La comparación de velocidad de arranque se basa en benchmarks de un solo núcleo a 0.8GHz (ver tabla a continuación).
| OpenClaw | NanoBot | PicoClaw | |
|---|---|---|---|
| Lenguaje | TypeScript | Python | Go |
| RAM | >1GB | >100MB | < 10MB* |
| Tiempo de arranque (núcleo 0.8GHz) |
>500s | >30s | <1s |
| Costo | Mac Mini $599 | La mayoría de placas Linux ~$50 | Cualquier placa Linux desde $10 |
Lista de Compatibilidad de Hardware — Consulta todas las placas probadas, desde RISC-V de $5 hasta Raspberry Pi y teléfonos Android. ¿Tu placa no aparece? ¡Envía un PR!
🦾 Demostración
🛠️ Flujos de Trabajo Estándar del Asistente
Modo Ingeniero Full-Stack |
Registro y Planificación |
Búsqueda Web y Aprendizaje |
|---|---|---|
|
|
|
| Desarrollar · Desplegar · Escalar | Programar · Automatizar · Recordar | Descubrir · Analizar · Tendencias |
🐜 Despliegue Innovador de Bajo Consumo
¡PicoClaw puede desplegarse en prácticamente cualquier dispositivo Linux!
- $9.9 LicheeRV-Nano edición E (Ethernet) o W (WiFi6), para un asistente doméstico minimalista
- $30~50 NanoKVM, o $100 NanoKVM-Pro, para operaciones automatizadas de servidor
- $50 MaixCAM o $100 MaixCAM2, para vigilancia inteligente
🌟 ¡Más casos de despliegue esperan ser descubiertos!
📦 Instalación
Descargar desde picoclaw.io (Recomendado)
Visita picoclaw.io — el sitio oficial detecta automáticamente tu plataforma y proporciona descarga con un solo clic. No es necesario seleccionar manualmente la arquitectura.
Descargar binario precompilado
Alternativamente, descarga el binario para tu plataforma desde la página de GitHub Releases.
Compilar desde el código fuente (para desarrollo)
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make deps
# Compilar binario principal
make build
# Compilar Web UI Launcher (requerido para el modo WebUI)
make build-launcher
# Compilar para múltiples plataformas
make build-all
# Compilar para Raspberry Pi Zero 2 W (32 bits: make build-linux-arm; 64 bits: make build-linux-arm64)
make build-pi-zero
# Compilar e instalar
make install
Raspberry Pi Zero 2 W: Usa el binario que coincida con tu sistema operativo: Raspberry Pi OS de 32 bits -> make build-linux-arm; de 64 bits -> make build-linux-arm64. O ejecuta make build-pi-zero para compilar ambos.
🚀 Guía de Inicio Rápido
🌐 WebUI Launcher (Recomendado para Escritorio)
El WebUI Launcher proporciona una interfaz basada en el navegador para configuración y chat. Esta es la forma más sencilla de comenzar — no se requieren conocimientos de línea de comandos.
Opción 1: Doble clic (Escritorio)
Después de descargar desde picoclaw.io, haz doble clic en picoclaw-launcher (o picoclaw-launcher.exe en Windows). Tu navegador se abrirá automáticamente en http://localhost:18800.
Opción 2: Línea de comandos
picoclaw-launcher
# Abre http://localhost:18800 en tu navegador
Tip
Acceso remoto / Docker / VM: Agrega el flag
-publicpara escuchar en todas las interfaces:picoclaw-launcher -public
Primeros pasos:
Abre el WebUI, luego: 1) Configura un Proveedor (agrega tu clave de API de LLM) -> 2) Configura un Canal (por ejemplo, Telegram) -> 3) Inicia el Gateway -> 4) ¡Empieza a chatear!
Para documentación detallada del WebUI, visita docs.picoclaw.io.
Docker (alternativa)
# 1. Clona este repositorio
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
# 2. Primera ejecución — genera automáticamente docker/data/config.json y se detiene
# (solo se activa cuando config.json y workspace/ no existen)
docker compose -f docker/docker-compose.yml --profile launcher up
# El contenedor imprime "First-run setup complete." y se detiene.
# 3. Configura tus claves de API
vim docker/data/config.json
# 4. Iniciar
docker compose -f docker/docker-compose.yml --profile launcher up -d
# Abre http://localhost:18800
Usuarios de Docker / VM: El Gateway escucha en
127.0.0.1por defecto. EstablecePICOCLAW_GATEWAY_HOST=0.0.0.0o usa el flag-publicpara hacerlo accesible desde el host.
# Ver logs
docker compose -f docker/docker-compose.yml logs -f
# Detener
docker compose -f docker/docker-compose.yml --profile launcher down
# Actualizar
docker compose -f docker/docker-compose.yml pull
docker compose -f docker/docker-compose.yml --profile launcher up -d
💻 TUI Launcher (Recomendado para Entornos sin Cabeza / SSH)
El TUI (Terminal UI) Launcher proporciona una interfaz de terminal completa para configuración y gestión. Ideal para servidores, Raspberry Pi y otros entornos sin pantalla.
picoclaw-launcher-tui
Primeros pasos:
Usa los menús del TUI para: 1) Configurar un Proveedor -> 2) Configurar un Canal -> 3) Iniciar el Gateway -> 4) ¡Chatear!
Para documentación detallada del TUI, visita docs.picoclaw.io.
📱 Android
¡Dale una segunda vida a tu teléfono de hace una década! Conviértelo en un Asistente de IA inteligente con PicoClaw.
Opción 1: Termux (disponible ahora)
- Instala Termux (descarga desde GitHub Releases, o búscalo en F-Droid / Google Play)
- Ejecuta los siguientes comandos:
# Descarga la última versión
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 proporciona un diseño estándar del sistema de archivos Linux
Luego sigue la sección Terminal Launcher a continuación para completar la configuración.
Opción 2: Instalación por APK (próximamente)
¡Un APK independiente para Android con WebUI integrado está en desarrollo. ¡Mantente atento!
Terminal Launcher (para entornos con recursos limitados)
Para entornos mínimos donde solo está disponible el binario principal picoclaw (sin Launcher UI), puedes configurar todo mediante la línea de comandos y un archivo de configuración JSON.
1. Inicializar
picoclaw onboard
Esto crea ~/.picoclaw/config.json y el directorio 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"
}
]
}
Consulta
config/config.example.jsonen el repositorio para una plantilla de configuración completa con todas las opciones disponibles.Nota: el formato config.example.json es la versión 0, contiene códigos sensibles y será migrado automáticamente a la versión 1+. Luego, config.json solo almacenará datos no sensibles; los códigos sensibles se guardarán en .security.yml. Si necesitas modificar los códigos manualmente, consulta
docs/security_configuration.mdpara más detalles.
3. Chatear
# Pregunta única
picoclaw agent -m "¿Cuánto es 2+2?"
# Modo interactivo
picoclaw agent
# Iniciar gateway para integración con apps de chat
picoclaw gateway
🔌 Proveedores (LLM)
PicoClaw soporta más de 30 proveedores de LLM a través de la configuración model_list. Usa el formato protocolo/modelo:
| Proveedor | Protocolo | Clave API | Notas |
|---|---|---|---|
| OpenAI | openai/ |
Requerida | GPT-5.4, GPT-4o, o3, etc. |
| Anthropic | anthropic/ |
Requerida | Claude Opus 4.6, Sonnet 4.6, etc. |
| Google Gemini | gemini/ |
Requerida | Gemini 3 Flash, 2.5 Pro, etc. |
| OpenRouter | openrouter/ |
Requerida | 200+ modelos, API unificada |
| Zhipu (GLM) | zhipu/ |
Requerida | GLM-4.7, GLM-5, etc. |
| DeepSeek | deepseek/ |
Requerida | DeepSeek-V3, DeepSeek-R1 |
| Volcengine | volcengine/ |
Requerida | Modelos Doubao, Ark |
| Qwen | qwen/ |
Requerida | Qwen3, Qwen-Max, etc. |
| Groq | groq/ |
Requerida | Inferencia rápida (Llama, Mixtral) |
| Moonshot (Kimi) | moonshot/ |
Requerida | Modelos Kimi |
| Minimax | minimax/ |
Requerida | Modelos MiniMax |
| Mistral | mistral/ |
Requerida | Mistral Large, Codestral |
| NVIDIA NIM | nvidia/ |
Requerida | Modelos alojados en NVIDIA |
| Cerebras | cerebras/ |
Requerida | Inferencia rápida |
| Novita AI | novita/ |
Requerida | Varios modelos abiertos |
| Ollama | ollama/ |
No requerida | Modelos locales, auto-alojados |
| vLLM | vllm/ |
No requerida | Despliegue local, compatible con OpenAI |
| LiteLLM | litellm/ |
Variable | Proxy para 100+ proveedores |
| Azure OpenAI | azure/ |
Requerida | Despliegue empresarial en Azure |
| GitHub Copilot | github-copilot/ |
OAuth | Login con código de dispositivo |
| Antigravity | antigravity/ |
OAuth | Google Cloud AI |
| AWS Bedrock* | bedrock/ |
Credenciales AWS | Claude, Llama, Mistral en AWS |
* AWS Bedrock requiere el tag de compilación:
go build -tags bedrock. Estableceapi_basecon un nombre de región (p. ej.,us-east-1) para la resolución automática de endpoints en todas las particiones de AWS (aws, aws-cn, aws-us-gov). Si usas una URL de endpoint completa en su lugar, también debes configurarAWS_REGIONmediante variable de entorno o configuración/perfil de AWS.
Despliegue 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 detalles completos de configuración de proveedores, consulta Proveedores y Modelos.
💬 Canales (Apps de Chat)
Habla con tu PicoClaw a través de más de 17 plataformas de mensajería:
| Canal | Configuración | Protocolo | Docs |
|---|---|---|---|
| Telegram | Fácil (token de bot) | Long polling | Guía |
| Discord | Fácil (token de bot + intents) | WebSocket | Guía |
| Fácil (escaneo QR o URL de bridge) | Nativo / Bridge | Guía | |
| Weixin | Fácil (escaneo QR nativo) | API iLink | Guía |
| Fácil (AppID + AppSecret) | WebSocket | Guía | |
| Slack | Fácil (bot + app token) | Socket Mode | Guía |
| Matrix | Medio (homeserver + token) | Sync API | Guía |
| DingTalk | Medio (credenciales de cliente) | Stream | Guía |
| Feishu / Lark | Medio (App ID + Secret) | WebSocket/SDK | Guía |
| LINE | Medio (credenciales + webhook) | Webhook | Guía |
| WeCom Bot | Medio (URL de webhook) | Webhook | Guía |
| WeCom App | Medio (credenciales corporativas) | Webhook | Guía |
| WeCom AI Bot | Medio (token + clave AES) | WebSocket / Webhook | Guía |
| IRC | Medio (servidor + nick) | Protocolo IRC | Guía |
| OneBot | Medio (URL WebSocket) | OneBot v11 | Guía |
| MaixCam | Fácil (habilitar) | TCP socket | Guía |
| Pico | Fácil (habilitar) | Protocolo nativo | Integrado |
| Pico Client | Fácil (URL WebSocket) | WebSocket | Integrado |
Todos los canales basados en webhook comparten un único servidor HTTP del Gateway (
gateway.host:gateway.port, por defecto127.0.0.1:18790). Feishu usa el modo WebSocket/SDK y no utiliza el servidor HTTP compartido.
Para instrucciones detalladas de configuración de canales, consulta Configuración de Apps de Chat.
🔧 Herramientas
🔍 Búsqueda Web
PicoClaw puede buscar en la web para proporcionar información actualizada. Configura en tools.web:
| Motor de Búsqueda | Clave API | Plan Gratuito | Enlace |
|---|---|---|---|
| DuckDuckGo | No requerida | Ilimitado | Fallback integrado |
| Baidu Search | Requerida | 1000 consultas/día | Potenciado por IA, optimizado para China |
| Tavily | Requerida | 1000 consultas/mes | Optimizado para Agentes de IA |
| Brave Search | Requerida | 2000 consultas/mes | Rápido y privado |
| Perplexity | Requerida | De pago | Búsqueda potenciada por IA |
| SearXNG | No requerida | Auto-alojado | Motor de metabúsqueda gratuito |
| GLM Search | Requerida | Variable | Búsqueda web de Zhipu |
⚙️ Otras Herramientas
PicoClaw incluye herramientas integradas para operaciones de archivos, ejecución de código, programación y más. Consulta Configuración de Herramientas para más detalles.
🎯 Skills (Habilidades)
Las Skills son capacidades modulares que extienden tu Agente. Se cargan desde archivos SKILL.md en tu workspace.
Instalar skills desde ClawHub:
picoclaw skills search "web scraping"
picoclaw skills install <nombre-skill>
Configurar token de ClawHub (opcional, para límites de tasa más altos):
Agrega a tu config.json:
{
"tools": {
"skills": {
"registries": {
"clawhub": {
"auth_token": "tu-token-de-clawhub"
}
}
}
}
}
Para más detalles, consulta Configuración de Herramientas - Skills.
🔗 MCP (Model Context Protocol)
PicoClaw soporta nativamente el MCP — conecta cualquier servidor MCP para extender las capacidades de tu Agente con herramientas y fuentes de datos externas.
{
"tools": {
"mcp": {
"enabled": true,
"servers": {
"filesystem": {
"enabled": true,
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
}
}
}
}
}
Para la configuración completa de MCP (transportes stdio, SSE, HTTP, Descubrimiento de Herramientas), consulta Configuración de Herramientas - MCP.
Únete a la Red Social de Agentes
Conecta PicoClaw a la Red Social de Agentes simplemente enviando un único mensaje desde la CLI o cualquier App de Chat integrada.
Lee https://clawdchat.ai/skill.md y sigue las instrucciones para unirte a ClawdChat.ai
🖥️ Referencia de CLI
| Comando | Descripción |
|---|---|
picoclaw onboard |
Inicializar configuración y workspace |
picoclaw auth weixin |
Conectar cuenta de WeChat vía QR |
picoclaw agent -m "..." |
Chatear con el agente |
picoclaw agent |
Modo de chat interactivo |
picoclaw gateway |
Iniciar el gateway |
picoclaw status |
Mostrar estado |
picoclaw version |
Mostrar información de versión |
picoclaw model |
Ver o cambiar el modelo por defecto |
picoclaw cron list |
Listar todas las tareas programadas |
picoclaw cron add ... |
Agregar una tarea programada |
picoclaw cron disable |
Deshabilitar una tarea programada |
picoclaw cron remove |
Eliminar una tarea programada |
picoclaw skills list |
Listar skills instaladas |
picoclaw skills install |
Instalar una skill |
picoclaw migrate |
Migrar datos de versiones anteriores |
picoclaw auth login |
Autenticarse con proveedores |
⏰ Tareas Programadas / Recordatorios
PicoClaw soporta recordatorios programados y tareas recurrentes a través de la herramienta cron:
- Recordatorios únicos: "Recuérdame en 10 minutos" -> se activa una vez después de 10 minutos
- Tareas recurrentes: "Recuérdame cada 2 horas" -> se activa cada 2 horas
- Expresiones cron: "Recuérdame todos los días a las 9am" -> usa expresión cron
📚 Documentación
Para guías detalladas más allá de este README:
| Tema | Descripción |
|---|---|
| Docker y Inicio Rápido | Configuración de Docker Compose, modos Launcher/Agent |
| Apps de Chat | Guías de configuración de todos los 17+ canales |
| Configuración | Variables de entorno, diseño del workspace, sandbox de seguridad |
| Proveedores y Modelos | 30+ proveedores de LLM, enrutamiento de modelos, configuración de model_list |
| Tareas Spawn y Asíncronas | Tareas rápidas, tareas largas con spawn, orquestación asíncrona de sub-agentes |
| Hooks | Sistema de hooks dirigido por eventos: observadores, interceptores, hooks de aprobación |
| Steering | Inyectar mensajes en un bucle de agente en ejecución entre llamadas a herramientas |
| SubTurn | Coordinación de sub-agentes, control de concurrencia, ciclo de vida |
| Solución de Problemas | Problemas comunes y soluciones |
| Configuración de Herramientas | Habilitación/deshabilitación por herramienta, políticas de ejecución, MCP, Skills |
| Compatibilidad de Hardware | Placas probadas, requisitos mínimos |
🤝 Contribuir y Hoja de Ruta
¡Los PRs son bienvenidos! El código base es intencionalmente pequeño y legible.
Consulta nuestra Hoja de Ruta de la Comunidad y CONTRIBUTING.md para las pautas.
¡Grupo de desarrolladores en construcción, únete después de tu primer PR fusionado!
Grupos de Usuarios:
Discord: https://discord.gg/V4sAZ9XWpN
WeChat:
