Requisitos del sistema
Los requisitos de hardware de PicoClaw son mínimos:
- Sistema operativo: Linux / macOS / Windows (WSL2)
- Arquitectura: x86_64 / ARM64 / RISC-V
- Memoria mínima: 64 MB (se recomiendan más de 512 MB)
- Dependencias: Clave de API de LLM (necesaria para las funciones de IA)
Plataformas compatibles: macOS, Linux, Windows (WSL2), Raspberry Pi, Docker.
Paso 1: Clonar el repositorio
Abre tu terminal y ejecuta el siguiente comando:
git clone https://github.com/sipeed/picoclaw.gitUna vez completada la descarga, accede al directorio del proyecto:
cd picoclawPaso 2: Inicializar la configuración
Ejecuta el comando onboard para iniciar la configuración:
picoclaw onboardSigue las instrucciones en pantalla:
- LLM API Key: Introduce la clave API de tu proveedor de LLM.
- Preferencias de modelo: Selecciona el modelo de IA que deseas usar por defecto.
- Token de plataforma de mensajería (opcional): Si deseas habilitar la integración con Telegram, Discord, QQ o DingTalk, introduce el token del bot correspondiente.
El archivo de configuración se guarda localmente; todos los datos permanecen en tu dispositivo y no se suben a la nube.
Paso 3: Iniciar la conversación
Una vez configurado, puedes empezar a interactuar con la IA.
Modo interactivo
picoclaw agentInicia una interfaz de chat interactiva donde puedes enviar mensajes y recibir respuestas de forma continua.
Modo de consulta única
picoclaw agent -m "Hola, ¿podrías presentarte?"Envía un mensaje único, recibe la respuesta y sal del programa; ideal para usar en scripts.
Iniciar el servicio de pasarela (Gateway)
Si deseas utilizar PicoClaw en plataformas como Telegram o QQ:
picoclaw gatewayUna vez iniciado, podrás interactuar con PicoClaw a través del bot en la plataforma correspondiente.
Configuración de bots multiplataforma
Telegram Bot
Busca a @BotFather en Telegram, envía /newbot para crear tu bot y obtener el token. Inserta el token en el archivo de configuración y ejecuta picoclaw gateway.
Discord Bot
Crea una aplicación en el Portal de Desarrolladores de Discord, obtén el token en la configuración del Bot, invita al bot a tu servidor e introduce el token en la configuración.
QQ Bot
Consulta la documentación de la plataforma abierta de QQ para registrar un bot, obtener el AppID y el Token, e introducirlos en el archivo de configuración.
DingTalk Bot
Crea una aplicación de robot en la plataforma abierta de DingTalk, obtén la URL del Webhook y la clave secreta, e insértalas en el archivo de configuración.
Despliegue con Docker
PicoClaw admite despliegue mediante Docker, ideal para servidores o entornos sin interfaz gráfica:
docker pull ghcr.io/sipeed/picoclaw:latestdocker run -d --name picoclaw -v /path/to/config:/config -e PICOCLAW_API_KEY=your_key ghcr.io/sipeed/picoclaw:latestConfiguración de tareas programadas
PicoClaw incluye soporte nativo para cron, gestionado a través del archivo de configuración.
Recordatorio único
tasks: - type: reminder time: "1h" message: "Recordatorio de reunión: Reunión semanal del equipo"Tareas periódicas
tasks: - type: cron schedule: "0 8 * * *" message: "Generar resumen de trabajo diario"Preguntas frecuentes
¿PicoClaw requiere conexión a Internet?
PicoClaw puede ejecutarse sin conexión, pero requiere acceso a Internet para llamar a la API de LLM y para las integraciones con plataformas de mensajería.
¿Qué proveedores de LLM son compatibles?
Es compatible con OpenRouter, Zhipu AI, Anthropic, OpenAI, DeepSeek, Groq, entre otros, y puedes cambiar entre ellos fácilmente mediante el archivo de configuración.
¿Cómo actualizo PicoClaw?
Accede al directorio del proyecto, ejecuta git pull para obtener el código más reciente y vuelve a compilar.
¿Dónde se almacenan los datos?
Todo el historial de conversaciones y los datos de configuración se almacenan en el sistema de archivos local, bajo control total del usuario.
¿Qué tamaño tiene la imagen de Docker?
La imagen de Docker de PicoClaw pesa aproximadamente 15 MB, mucho menos que los 350 MB+ de productos similares.
¿Se puede ejecutar en una Raspberry Pi?
Sí, PicoClaw es compatible con la arquitectura ARM64; una Raspberry Pi 4 (con 4 GB de RAM o más) es suficiente para una ejecución fluida.
¿Cómo configuro varios bots para usarlos simultáneamente?
Simplemente añade los tokens y la configuración de cada plataforma en el archivo de configuración y ejecuta picoclaw gateway para activar todos los bots a la vez.