Guia de Configuracion de PicoClaw: Asistente IA en Go para Hardware de $10

PicoClaw es una reescritura de nanobot en Go que compila a un unico binario, arranca en menos de un segundo, y usa menos de 10MB de RAM. Sipeed, la empresa de hardware RISC-V detras de NanoKVM y MaixCAM, lo construyo para ejecutarse en sus placas LicheeRV-Nano de $10. He estado ejecutandolo junto con mis configuraciones de nanobot y ZeroClaw durante la ultima semana, y los numeros de recursos son reales. Si quieres un asistente de IA en hardware donde Python se ahogaria, este es el que debes mirar.

Esta guia te lleva paso a paso para poner PicoClaw en funcionamiento en un VPS o SBC con MiniMax M2.5 y GLM-5 como modelos, Brave Search para acceso web, y Discord como canal de chat.

Si estas comparando opciones de bots auto-alojados, nuestro resumen de alternativas a OpenClaw incluye PicoClaw junto con nanobot, NanoClaw, memU, IronClaw y ZeroClaw.

Que es realmente PicoClaw

PicoClaw es un asistente de IA de codigo abierto de Sipeed. El proyecto comenzo como un port de nanobot a Go, y supuestamente el 95% de la migracion fue realizada por el propio agente de IA con revision humana. El resultado es un unico binario que se ejecuta en RISC-V, ARM y x86 sin ninguna dependencia de runtime.

La arquitectura sigue el mismo patron que nanobot:

Tu (Discord / Telegram / DingTalk / LINE / QQ / CLI)
    ↓
PicoClaw Gateway (ejecutandose en tu VPS o SBC)
    ↓
Proveedor LLM (OpenRouter, Zhipu, Anthropic, OpenAI, Gemini, Groq, DeepSeek)
    ↓
Herramientas (shell, acceso a archivos, busqueda web, memoria, tareas programadas)

Los mensajes llegan desde tu app de chat, PicoClaw los enruta al LLM que hayas configurado, y el modelo puede usar herramientas integradas para ejecutar comandos shell, leer y escribir archivos, y buscar en la web. Todo excepto las llamadas a la API del LLM se queda en tu maquina.

Como se compara

Por que MiniMax M2.5 y GLM-5

Ambos modelos salieron en febrero de 2026 y funcionan bien con un bot ligero como PicoClaw.

MiniMax M2.5

MiniMax M2.5 es un modelo Mixture-of-Experts de 230B con solo 10B parametros activos por pasada. Es rapido y barato:

Obtiene 80.2% en SWE-Bench Verified, igualando a Claude Opus 4.6 a aproximadamente 1/20 del costo. La ventana de contexto de 1M tokens significa que PicoClaw no alcanzara limites de contexto ni con conversaciones largas.

GLM-5

GLM-5 de Zhipu AI es un modelo MoE de 744B con 40-44B parametros activos:

GLM-5 ocupa el primer lugar entre modelos de codigo abierto en BrowseComp (tareas de agentes de busqueda web), asi que es una opcion solida para un bot que hace muchas consultas web. Ambos modelos estan disponibles a traves de sus propias APIs y a traves de OpenRouter.

Instalacion

Tres formas de instalar PicoClaw. El binario precompilado es la ruta mas rapida.

# Ejemplo para Linux amd64 — revisa releases para la ultima version
wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-amd64
chmod +x picoclaw-linux-amd64
sudo mv picoclaw-linux-amd64 /usr/local/bin/picoclaw

wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-arm64
chmod +x picoclaw-linux-arm64
sudo mv picoclaw-linux-arm64 /usr/local/bin/picoclaw

git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make deps
make build

make install

make build-all

git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# Configura tu config
cp config/config.example.json config/config.json
nano config/config.json

# Inicia el gateway
docker compose --profile gateway up -d

# Revisa los logs
docker compose logs -f picoclaw-gateway

docker compose run --rm picoclaw-agent -m "What is 2+2?"

Despues de instalar, inicializa el workspace y la configuracion:

picoclaw onboard

Esto crea el directorio ~/.picoclaw/ con un config.json por defecto y una carpeta workspace/.

Verifica que todo funciona:

picoclaw status

Configurar MiniMax M2.5

PicoClaw usa un archivo de configuracion JSON en ~/.picoclaw/config.json. El sistema de proveedores enruta modelos basandose en palabras clave en el nombre del modelo, similar a como lo hace nanobot.

Obtener una clave API

1. Ve a platform.minimax.io (global) o minimaxi.com (China continental)
2. Crea una cuenta y genera una clave API

Agregar a la configuracion

La forma mas simple es a traves de OpenRouter, que te da acceso a MiniMax junto con cientos de otros modelos:

{
  "agents": {
    "defaults": {
      "model": "minimax/MiniMax-M2.5",
      "max_tokens": 8192,
      "temperature": 0.7
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "sk-or-your-openrouter-key",
      "api_base": "https://openrouter.ai/api/v1"
    }
  }
}

Para conectarte directamente a la API de MiniMax, configura un proveedor dedicado:

{
  "agents": {
    "defaults": {
      "model": "MiniMax-M2.5"
    }
  },
  "providers": {
    "minimax": {
      "api_key": "your-minimax-api-key"
    }
  }
}

Para el endpoint de China continental, agrega "api_base": "https://api.minimaxi.com/v1" al proveedor minimax.

Probar

picoclaw agent -m "What's 42 * 17?"

Si obtienes una respuesta, MiniMax esta funcionando.

Configurar GLM-5 (Zhipu)

PicoClaw tiene soporte integrado para Zhipu. El proveedor enruta automaticamente cuando detecta glm en el nombre del modelo.

Obtener una clave API

1. Ve a bigmodel.cn
2. Registrate y crea una clave API

Agregar a la configuracion

{
  "agents": {
    "defaults": {
      "model": "glm-4.7",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "providers": {
    "zhipu": {
      "api_key": "your-zhipu-api-key",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    }
  }
}

Cambiar entre modelos

Configura ambos proveedores y cambia el modelo por defecto cuando quieras. Cambia "model" a "MiniMax-M2.5" o "glm-4.7" y PicoClaw elige el proveedor correcto automaticamente. No se necesita reinicio para uso CLI. Para el gateway, reinicia con picoclaw gateway.

Configurar busqueda web

PicoClaw soporta tanto Brave Search como DuckDuckGo. Brave da mejores resultados pero necesita una clave API. DuckDuckGo funciona de inmediato sin necesidad de clave.

Brave Search

1. Ve a brave.com/search/api
2. Registrate para una cuenta
3. El tier gratuito te da 2,000 busquedas al mes
4. Genera una clave API desde el dashboard

Agregar a la configuracion

{
  "tools": {
    "web": {
      "brave": {
        "enabled": true,
        "api_key": "your-brave-search-api-key",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      }
    }
  }
}

Mantén ambos habilitados. Si Brave alcanza un limite de velocidad o falla, PicoClaw hace fallback a DuckDuckGo automaticamente. La configuracion max_results controla cuantos resultados se obtienen por busqueda. Cinco es un valor razonable por defecto.

Configuracion de Discord

Discord es uno de los canales que PicoClaw soporta junto con Telegram, QQ, DingTalk y LINE.

Crear un bot de Discord

1. Ve a discord.com/developers/applications
2. Haz clic en New Application, dale un nombre
3. Ve a Bot en la barra lateral izquierda, haz clic en Add Bot
4. Copia el token del bot

Habilitar intents

Todavia en la pagina de configuracion del Bot:

1. Baja hasta Privileged Gateway Intents
2. Habilita MESSAGE CONTENT INTENT (obligatorio, si no el bot no puede leer mensajes)
3. Opcionalmente habilita SERVER MEMBERS INTENT si planeas usar listas de permitidos

Obtener tu ID de usuario

1. Abre Configuracion de Discord → Advanced → habilita Developer Mode
2. Haz clic derecho en tu avatar en cualquier parte de Discord
3. Haz clic en Copy User ID

Configurar PicoClaw

Agrega el canal de Discord a tu ~/.picoclaw/config.json:

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_DISCORD_BOT_TOKEN",
      "allow_from": ["YOUR_USER_ID"]
    }
  }
}

El array allow_from restringe quien puede hablar con el bot. Dejalo vacio para permitir que cualquiera en tu servidor lo use. Para un bot personal, siempre bloquealo a tu ID de usuario.

Invitar el bot a tu servidor

1. En el portal de desarrolladores de Discord, ve a OAuth2 → URL Generator
2. En Scopes, marca bot
3. En Bot Permissions, marca Send Messages y Read Message History
4. Copia la URL generada y abrela en tu navegador
5. Selecciona el servidor al que quieres agregar el bot

Iniciar el gateway

picoclaw gateway

Envia un mensaje en Discord. El bot deberia responder. Si no pasa nada, revisa picoclaw status y mira los logs del gateway.

Ejemplo de configuracion completa

Asi se ve un ~/.picoclaw/config.json completo con OpenRouter, Zhipu, Brave Search, DuckDuckGo y Discord:

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model": "minimax/MiniMax-M2.5",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "sk-or-your-openrouter-key",
      "api_base": "https://openrouter.ai/api/v1"
    },
    "zhipu": {
      "api_key": "your-zhipu-api-key",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    },
    "groq": {
      "api_key": "gsk_your-groq-key"
    }
  },
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_DISCORD_BOT_TOKEN",
      "allow_from": ["YOUR_USER_ID"]
    },
    "telegram": {
      "enabled": false,
      "token": "",
      "allow_from": []
    }
  },
  "tools": {
    "web": {
      "brave": {
        "enabled": true,
        "api_key": "your-brave-search-api-key",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      }
    },
    "cron": {
      "exec_timeout_minutes": 5
    }
  },
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}

Explicacion de las configuraciones

Sistema de proveedores

PicoClaw enruta proveedores por familia de protocolo. Los endpoints compatibles con OpenAI (OpenRouter, Groq, Zhipu) comparten una ruta de codigo. Anthropic tiene la suya propia. Agregar un nuevo proveedor compatible con OpenAI es principalmente una operacion de configuracion con api_base y api_key.

Memoria y workspace

PicoClaw almacena la memoria y configuracion en el directorio de workspace:

~/.picoclaw/workspace/
├── sessions/          # Sesiones de conversacion e historial
├── memory/            # Memoria a largo plazo (MEMORY.md)
├── state/             # Estado persistente (ultimo canal, etc.)
├── cron/              # Base de datos de trabajos programados
├── skills/            # Skills personalizadas
├── AGENTS.md          # Guia de comportamiento del agente
├── HEARTBEAT.md       # Prompts de tareas periodicas
├── IDENTITY.md        # Identidad del agente
├── SOUL.md            # Alma del agente / personalidad
├── TOOLS.md           # Descripciones de herramientas
└── USER.md            # Tu informacion personal y preferencias

Dile al bot que recuerde algo y lo escribe en memory/MEMORY.md. Las sesiones se almacenan por conversacion. Los archivos de bootstrap (SOUL.md, USER.md, etc.) se cargan en el prompt del sistema cada vez que el bot procesa un mensaje.

nano ~/.picoclaw/workspace/USER.md

Agrega el contexto que quieras que el bot siempre tenga — detalles de proyectos, preferencias de comunicacion,背景 tecnico. Esto funciona igual que los archivos de workspace de nanobot.

Heartbeat y tareas programadas

PicoClaw puede ejecutar tareas periodicas automaticamente. Crea un archivo HEARTBEAT.md en tu workspace:

# Tareas Periodicas

- Revisar el pronostico del clima
- Buscar noticias de IA en la web y resumir

El agente lee este archivo cada 30 minutos (configurable) y ejecuta cada tarea usando las herramientas disponibles. Para tareas de larga duracion, PicoClaw genera un subagente que trabaja independientemente sin bloquear el loop principal de heartbeat.

Tambien puedes gestionar trabajos puntuales y recurrentes desde el CLI:

# Agregar un recordatorio
picoclaw cron add --name "morning" --message "Good morning! What's in the news?" --cron "0 9 * * *"

# Listar todos los trabajos
picoclaw cron list

Los trabajos se almacenan en ~/.picoclaw/workspace/cron/ y se procesan automaticamente.

Sandbox de seguridad

PicoClaw se ejecuta en un entorno aislado por defecto. Con restrict_to_workspace establecido en true, el agente solo puede acceder a archivos y ejecutar comandos dentro del directorio de workspace.

Herramientas protegidas

Bloqueo de comandos peligrosos

Incluso con restrict_to_workspace en false, PicoClaw bloquea comandos destructivos:

• rm -rf, del /f, rmdir /s — eliminacion masiva
• format, mkfs, diskpart — formateo de disco
• dd if= — imagen de disco
• Escritura a /dev/sd[a-z] — escritura directa a disco
• shutdown, reboot, poweroff — apagado del sistema
• Fork bombs

El limite del sandbox se aplica consistentemente a traves del agente principal, subagentes y tareas de heartbeat. No hay forma de evadirlo a traves de subagentes o trabajos programados.

Deshabilitar restricciones

Si necesitas que el agente acceda a rutas fuera del workspace:

{
  "agents": {
    "defaults": {
      "restrict_to_workspace": false
    }
  }
}

Despliegue con Docker

PicoClaw tiene una configuracion de Docker Compose con perfiles separados para modo agente y modo gateway.

Usando Docker Compose

git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# Configurar
cp config/config.example.json config/config.json
nano config/config.json

# Iniciar gateway (ejecucion continua)
docker compose --profile gateway up -d

# Revisar logs
docker compose logs -f picoclaw-gateway

# Detener
docker compose --profile gateway down

Modo agente (consultas puntuales)

# Hacer una pregunta
docker compose run --rm picoclaw-agent -m "What is 2+2?"

# Modo interactivo
docker compose run --rm picoclaw-agent

Recompilar despues de actualizaciones

docker compose --profile gateway build --no-cache
docker compose --profile gateway up -d

El archivo compose monta config.json como solo lectura y usa un volumen con nombre para el workspace, asi que tus datos sobreviven a reinicios del contenedor.

Referencia del CLI

En modo interactivo, escribe exit, quit, o presiona Ctrl+D para salir.

Hosting en VPS

PicoClaw se ejecuta en practicamente cualquier cosa. El binario unico con menos de 10MB de RAM significa que puedes desplegarlo en placas tan baratas como $10. Para un VPS, un Hetzner CX22 (2 vCPU, 4GB RAM) a €4.35/mes es excesivo, pero deja espacio para otros servicios.

Configuracion rapida en un VPS Ubuntu 24.04 nuevo:

ssh root@YOUR_SERVER_IP

# Actualizar sistema
apt update && apt upgrade -y

# Descargar binario (revisa releases para la ultima version)
wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-amd64
chmod +x picoclaw-linux-amd64
mv picoclaw-linux-amd64 /usr/local/bin/picoclaw

# Inicializar
picoclaw onboard

# Editar config
nano ~/.picoclaw/config.json

# Iniciar gateway en segundo plano
nohup picoclaw gateway > /var/log/picoclaw.log 2>&1 &

Para una configuracion de daemon apropiada, crea un servicio systemd:

[Unit]
Description=PicoClaw gateway
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/picoclaw gateway
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Guarda en /etc/systemd/system/picoclaw.service, luego:

systemctl daemon-reload
systemctl enable picoclaw
systemctl start picoclaw

Ejecutar en hardware economico

PicoClaw fue diseñado para esto. Una LicheeRV-Nano de $10 con Ethernet o WiFi6 puede servir como asistente doméstico minimal. Un NanoKVM de $30-50 funciona para mantenimiento automatizado de servidores. Un MaixCAM maneja casos de uso de monitoreo inteligente.

Para telefonos Android antiguos, instala Termux y ejecuta el binario ARM64:

pkg install proot wget
wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-arm64
chmod +x picoclaw-linux-arm64
termux-chroot ./picoclaw-linux-arm64 onboard

Si quieres ejecutar modelos locales junto con PicoClaw, revisa nuestra guia de instalar Ollama con Docker. PicoClaw funciona con cualquier endpoint compatible con OpenAI, asi que apuntarlo a un servidor Ollama local es un cambio de configuracion de una linea.

PicoClaw vs nanobot vs ZeroClaw

Uso los tres en este punto, asi que aqui va una comparacion directa:

PicoClaw es el mas facil de desplegar: descarga un binario, ejecutalo, listo. nanobot tiene mejor cobertura de canales y una comunidad mas grande. ZeroClaw tiene el sistema de memoria mas capaz y el soporte de proveedores mas amplio. Para la guia de configuracion de nanobot, ve nuestro tutorial completo. Para ZeroClaw, ve la guia de configuracion.

Si quieres explorar otras herramientas de codificacion con IA, nuestra comparacion de herramientas de codificacion con IA cubre el panorama actual. Para conceptos basicos de MCP que funcionan en todos estos asistentes, revisa la introduccion a MCP para principiantes.

Este articulo tambien esta disponible en ingles: PicoClaw Setup Guide.