Tutorial de PicoClaw: un framework de agentes ultraminimalista para poco espacio en disco

Si los titulares recientes aciertan, la IA está devorando toda la RAM y CPU del planeta, lo que hace que PicoClaw llegue en el momento perfecto. No es de extrañar que causara tanto revuelo al lanzarse, acumulando miles de estrellas en pocos días. El agente completo cabe en menos de 10 MB y se inicia en menos de un segundo en un procesador de 600 MHz. 

Cuando lo descubrí, tuve que probarlo para ver si el hype era real. En este artículo te guío por PicoClaw y te cuento todo lo que me encontré. 

Si te interesa aprender más sobre la IA agentica, te recomiendo empezar por el itinerario de aprendizaje AI Agent Fundamentals. 

¿Qué es PicoClaw?

PicoClaw es un asistente de IA personal ligero inspirado en Nanobot. Está escrito en Go por el equipo de Sipeed y funciona en dispositivos de borde como Raspberry Pi, placas RISC-V embebidas y routers basados en MIPS. En otras palabras, puedes ejecutar PicoClaw con un presupuesto de hardware de 10 $. 

Funciones y capacidades clave de PicoClaw

PicoClaw se distribuye como un único binario. Esto lo hace rapidísimo de instalar: no hay entornos virtuales de Python que configurar ni pip que ejecutar. 

Al ser un binario, puedes ejecutarlo en varias arquitecturas. La página de lanzamientos incluye descargas para Linux, macOS y Windows, entre otros sistemas. 

En cuanto a IA, PicoClaw es agnóstico del proveedor. Es compatible con OpenAI, Anthropic, DeepSeek e incluso Ollama para modelos locales. Esto es clave si quieres alternar entre modelos o usar modelos locales por privacidad. 

Puedes aprender a configurar Ollama para modelos locales en la guía Using OpenClaw with Ollama. 

PicoClaw incorpora herramientas nativas para: 

• Leer y escribir archivos 
• Ejecutar comandos de shell en el sistema host 
• Buscar en la web con Brave Search o DuckDuckGo 
• Programar tareas recurrentes con cron 

Como Nanobot, es compatible con los sospechosos habituales: WhatsApp, Telegram, Discord, QQ y DingTalk. Más adelante te enseño cómo conectarlo con Telegram. 

Descubre Nanobot, la alternativa a OpenClaw ligera. Crea un agente de IA en Python seguro y auditable en menos de 10 minutos con esta guía completa de configuración de Nanobot.

Ventajas e inconvenientes de PicoClaw

Seguro que te preguntas cuáles son los contras de PicoClaw, con lo rápido y sencillo que es de instalar. Llegaremos a eso, pero primero veamos los pros. 

Para empezar, el hecho de ser un archivo binario facilita su puesta en marcha en casi cualquier dispositivo. Yo lo instalé en mi Google Pixel en cuestión de minutos. 

Además, PicoClaw se integra con tus plataformas de mensajería habituales, así que puedes interactuar con él sin cambiar de app. 

En el lado negativo, PicoClaw sigue en pre-1.0. Al ser una herramienta muy nueva, puede tener bugs inesperados o incluso cambios incompatibles. Investigando, también vi numerosas estafas cripto haciéndose pasar por PicoClaw. La documentación oficial indica que no gestionan ninguna moneda, así que mucho ojo ahí fuera. 

Cómo instalar PicoClaw

Puedes poner en marcha PicoClaw en pocos pasos. Veamos cómo:

Instalación (descarga de binario único)

Para instalar PicoClaw, puedes compilarlo directamente desde el código fuente:

git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make deps
# Build, no need to install
make build
# Build for multiple platforms
make build-all
# Build for Raspberry Pi Zero 2 W (32-bit: make build-linux-arm; 64-bit: make build-linux-arm64)
make build-pi-zero
# Build And Install
make install

Aun así, prefiero usar Docker porque es mucho más rápido: 

# 1. Clone this repo
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
# 2. First run — auto-generates docker/data/config.json then exits
docker compose -f docker/docker-compose.yml --profile gateway up
# The container prints "First-run setup complete." and stops.
# 3. Set your API keys
nano docker/data/config.json   # Set provider API keys, bot tokens, etc.
# 4. Start
docker compose -f docker/docker-compose.yml --profile gateway up -d

Aprende lo esencial de la contenerización con nuestra guía Docker para principiantes. 

Configurar tu proveedor de LLM

Tras la instalación, debes configurar el proveedor de LLM que prefieras. Puedes hacerlo editando el archivo docker/data/config.json:

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model_name": "gpt4",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "model_list": [
    {
      "model_name": "gpt4",
      "model": "openai/gpt-5.2",
      "api_key": "your-api-key",
      "request_timeout": 300
    },
    {
      "model_name": "claude-sonnet-4.6",
      "model": "anthropic/claude-sonnet-4.6",
      "api_key": "your-anthropic-key"
    }
  ],
  "tools": {
    "web": {
      "brave": {
        "enabled": false,
        "api_key": "YOUR_BRAVE_API_KEY",
        "max_results": 5
      },
      "tavily": {
        "enabled": false,
        "api_key": "YOUR_TAVILY_API_KEY",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      },
      "perplexity": {
        "enabled": false,
        "api_key": "YOUR_PERPLEXITY_API_KEY",
        "max_results": 5
      },
      "searxng": {
        "enabled": false,
        "base_url": "http://your-searxng-instance:8888",
        "max_results": 5
      }
    }
  }
}

Ejecutar tu primer agente

Conectar PicoClaw con Telegram solo lleva unos pocos pasos.

Así lo dejé listo en Telegram:

• Abre Telegram y busca @BotFather 
• Escribe /newbot y sigue las indicaciones 
• Copia el token que te dará BotFather 
• Luego, obtén tu ID de usuario para que el bot solo acepte comandos tuyos. Busca @userinfobot en Telegram y pulsa start. Copia el ID de usuario.

Después, actualiza el archivo docker/data/config.json para incluir el token del bot y tu ID de usuario de Telegram. 

Ahora ve a tu bot de Telegram y empieza a interactuar con Picoclaw. 

Probemos algunos prompts. 

Primero, usaré PicoClaw para buscar en la web y devolver el precio actual de la acción de Apple. Como se ve en la captura, utilizó la herramienta de búsqueda web DuckDuckGo y recuperó el precio. 

Aquí va otro prompt pidiéndole a PicoClaw que redacte un blog, lo guarde en disco y lo lea: 

Tenía curiosidad por su capacidad para ejecutar tareas programadas, así que le pedí que me recordara publicar el blog en cinco minutos, y el recordatorio llegó pasados esos 5 minutos. 

Problemas comunes de PicoClaw y cómo resolverlos

Al configurar PicoClaw, me encontré con algunos problemas. Los comento brevemente por si te pasa lo mismo. 

Sin respuesta en Telegram

Si no recibes respuesta en Telegram, el problema puede ser: 

• El token de Telegram no es correcto. Abre el archivo de configuración y revísalo 
• No está definido el ID de usuario en from, o estás accediendo al agente desde otra cuenta 
• No están configurados el modelo y las claves de API. Abre el archivo de configuración y añádelos

Al revisar los logs verás el problema exacto: 

docker compose -f docker/docker-compose.yml logs -f picoclaw-gateway

Modelo no configurado 

El error de abajo indica que no has configurado el modelo por defecto: 

Error: error creating provider: model "" not found in model_list: model "" not found in model_list or providers

Abre el archivo JSON de configuración, indica el nombre del modelo que quieras usar y verifica que su clave de API también está incluida.

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model_name": "gpt4", ---> make sure this is here 
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  }

Clave de API incorrecta

Este es directo: la clave de API del proveedor elegido está vacía o es errónea. Abre el JSON de configuración y verifica la clave.

Lo más destacado de PicoClaw

Veamos ahora algunas capacidades que diferencian a PicoClaw y también en qué se parece a otros asistentes de IA personales. 

Sistema Heartbeat

PicoClaw mantiene un archivo markdown de heartbeat en su directorio de trabajo, que el agente lee cada 30 minutos y ejecuta las instrucciones que contenga. Picoclaw también puede lanzar subagentes para trabajar en paralelo. 

Memoria persistente

PicoClaw dispone de un archivo de memoria donde guarda información importante que debe persistir entre sesiones. Conserva tus preferencias y habilidades activadas para poder recuperarlas cuando se necesiten. Así no empiezas cada interacción desde cero. 

Modo aislado / sin conexión

PicoClaw también puede funcionar sin acceso a internet. Es fundamental si quieres procesar datos sensibles, especialmente en sectores regulados como banca y sanidad. Para ello, tendrás que configurar un modelo local vía Ollama. 

Multiagente y modelos de respaldo

Con PicoClaw, puedes definir que cada agente use su propio proveedor de LLM. También admite balanceo de carga para repartir peticiones entre varios modelos. Una vez configurado, PicoClaw rotará entre modelos en modo round robin.

Integración con hardware

PicoClaw incluye herramientas para comunicación I2C y SPI. Esto permite al agente interactuar con periféricos de hardware en placas compatibles: sensores, pantallas, controladores de motor y todo tipo de dispositivos físicos. 

PicoClaw en acción: casos de uso reales

Exploremos ahora algunos casos de uso de PicoClaw. 

Entre los casos interesantes que encontré investigando están: 

• Automatización y monitorización doméstica con una Raspberry Pi de primera generación 
• Búsquedas web automatizadas, por ejemplo, para enviarte resúmenes por Telegram cada mañana 
• Alertas y monitorización desde dispositivos embebidos, por ejemplo, a partir de datos de sensores 

Limitaciones y advertencias de PicoClaw

Antes de desplegar PicoClaw en tu red, ten presentes algunas limitaciones importantes.

Para empezar, PicoClaw es seguro por defecto. Está restringido al espacio de trabajo desde el que opera, por lo que no puede acceder a carpetas y archivos fuera de ese directorio. 

Esto puede cambiarse en el archivo de ajustes. 

Ciertos comandos, como rm, también están restringidos para evitar desastres como vaciarte el disco duro. 

Por ejemplo, intenté pedirle que borrara mi carpeta home y las barreras de seguridad saltaron para evitarlo. 

Al ser software en una fase temprana, PicoClaw tiene cuestiones de seguridad de red aún por resolver, así que se recomienda no llevarlo a producción antes de la versión 1.0. 

Si buscas algo más maduro, OpenClaw es una buena opción. Descubre si encaja con tu flujo de trabajo en nuestra guía OpenClaw vs Claude Code . 

Perspectivas de futuro

La capacidad de ejecutar grandes modelos de lenguaje en dispositivos de borde ha ganado mucha tracción últimamente, especialmente con la aparición de modelos que corren en móviles y dispositivos embebidos. Creo que PicoClaw será muy útil en entornos con recursos limitados y en aplicaciones donde la sensibilidad de los datos es crítica. Donde la conectividad es poco fiable, no habrá otra opción que usar una herramienta como PicoClaw. 

También pienso que PicoClaw puede competir de tú a tú con Nanobot y OpenClaw cuando esté listo para producción. Apostaría a que será la herramienta que habilite flujos agenticos en dispositivos del Internet de las cosas. Eso trae riesgos serios si los modelos alucinan o una inyección de prompts los lleva a acciones maliciosas, como sobrecalentar un microondas. 

PicoClaw también intentará cubrir funciones que hoy están en otros agentes, como OpenClaw, tal y como plantean en su hoja de ruta. Entre ellas: 

• Automatización del navegador
• Más descubrimiento de habilidades 
• Compatibilidad con MCP 

Conclusión

Cuando se lanzó OpenClaw, hubo mucho ruido con lo de comprar Mac Minis para ejecutarlo, aunque realmente no hacía falta. Un Mac Mini cuesta cientos de dólares. 

PicoClaw nació para desmontar esa narrativa permitiendo desplegar agentes potentes con un presupuesto de 10 $. A diferencia de OpenClaw, PicoClaw adopta un enfoque de seguridad por defecto, restringiendo el acceso del agente solo a su espacio de trabajo y deshabilitando comandos que podrían causar estragos si el modelo subyacente alucina o si se inyecta un prompt malicioso. 

Para aprender más sobre cómo trabajar con herramientas de IA, te recomiendo consultar nuestra guía de las mejores herramientas de IA gratis. Para ampliar tus habilidades de programación con IA, prueba nuestro curso AI-Assisted Coding for Developers y desarrolla las competencias que hacen que los asistentes de IA sean aliados más fiables en tu flujo de desarrollo. 

También puedes descubrir cómo crear aplicaciones con IA usando LLMs, prompts, cadenas y agentes en LangChain con nuestro curso Developing LLM Applications with LangChain .