Nota

Hola, bienvenido a la Comunidad de Entusiastas de Raspberry Pi, Arduino y ESP32 de SunFounder en Facebook. Profundice en Raspberry Pi, Arduino y ESP32 junto a otros entusiastas.

¿Por qué unirte?

Soporte de Expertos: Resuelve problemas post-venta y desafíos técnicos con la ayuda de nuestra comunidad y equipo.
Aprende y Comparte: Intercambia consejos y tutoriales para mejorar tus habilidades.
Vistas Previas Exclusivas: Obtén acceso anticipado a nuevos anuncios de productos y vistas previas.
Descuentos Especiales: Disfruta de descuentos exclusivos en nuestros productos más nuevos.
Promociones y Sorteos Festivos: Participa en sorteos y promociones de temporada.

👉 ¿Listo para explorar y crear con nosotros? Haz clic en [here] y únete hoy.

Usando OpenClaw

¿Qué es OpenClaw?

Piensa en ello como una versión mejorada de ChatGPT. Mientras que los chatbots tradicionales solo pueden hablar (generar texto), OpenClaw puede actuar. Comprende tus instrucciones en lenguaje natural y puede realizar operaciones en tu computadora, como ejecutar comandos, administrar archivos y llamar a varias herramientas.

Aquí tienes algunos escenarios de aplicación fantásticos:

Asistente personal multiuso: Deja que te ayude a administrar tu agenda, configurar recordatorios y realizar un seguimiento de tareas. Solo tienes que decírselo en una aplicación de chat (como Telegram, WhatsApp) y él lo recordará y ejecutará.
«Pegamento» de automatización: Puede actuar como un enlace para tus diversos servicios. Por ejemplo, puedes hacer que monitoree un sitio web en busca de cambios de precios. Una vez que se detecte una caída de precio, puede activar automáticamente un flujo de trabajo de automatización de n8n para enviarte una notificación por correo electrónico.
Asistente de desarrollo dedicado: Haz que te ayude a administrar servidores, ejecutar scripts y revisar registros. Puedes simplemente decir: «Verifica la carga del sistema por mí», y él puede conectarse por SSH a tu servidor, ejecutar el comando y devolver los resultados.
«Compañero de juegos» de hardware: Este es un caso de uso muy interesante. Puedes hacer que OpenClaw controle el hardware conectado a una Raspberry Pi. Por ejemplo, un desarrollador lo usó para controlar una aspiradora robótica con un brazo mecánico, o incluso para ayudar a analizar datos de un simulador de carreras y mostrarlos en una pantalla LED. ¡El equipo oficial de Raspberry Pi incluso lo usó para construir una cabina de fotos automática para una boda, solo mediante conversación, sin escribir una sola línea de código!

¿Por qué instalar OpenClaw en una Raspberry Pi?

Instalarlo en una Raspberry Pi tiene dos ventajas principales:

Aislamiento de seguridad: OpenClaw requiere permisos elevados del sistema, lo que supone un riesgo en una computadora principal. Usar una Raspberry Pi como dispositivo dedicado es como darle un «entorno aislado»; incluso si algo sale mal, no afectará a tu sistema principal.
Siempre encendido 24/7: La Raspberry Pi tiene un consumo de energía extremadamente bajo, lo que le permite permanecer encendida todo el tiempo, lista para ejecutar tareas en cualquier momento.

Inicio Rápido de OpenClaw

Si quieres experimentar el poder de OpenClaw lo más rápido posible, usa este método. Instalará automáticamente y lanzará un asistente de configuración interactivo.

Abre la terminal en tu Raspberry Pi y ejecuta el siguiente comando directamente. Este comando descarga el script de instalación del sitio web oficial y lo ejecuta:
```
curl -fsSL https://openclaw.ai/install.sh | bash
```
Nota

Debido a que las nuevas versiones se actualizan rápidamente, es normal que tus pasos de instalación difieran ligeramente.
El script descargará e instalará automáticamente OpenClaw.
Luego verás un mensaje de seguridad preguntando si confías en OpenClaw. Una vez que estés seguro de que es seguro y confiable, usa las teclas de flecha para navegar a «Yes» y presiona Enter.
Selecciona «Quick Start» y luego presiona Enter.
Selecciona tu Modelo (Model) y luego presiona Enter. Aquí usamos OpenAI como ejemplo.
Selecciona «OpenAI API Key».
Pega la clave API ahora.
Ve a OpenAI Platform e inicia sesión. En la página API keys, haz clic en Create new secret key.
Completa los detalles (Propietario, Nombre, Proyecto y permisos si es necesario), luego haz clic en Create secret key.
Una vez que se crea la clave, cópiala de inmediato; no podrás volver a verla. Si la pierdes, deberás generar una nueva.
Pega la clave en la configuración de OpenClaw.
Selecciona el Modelo (Model) que deseas usar. En este ejemplo, usaremos Keep current (Mantener actual).
A continuación viene la selección del canal (Channel). Los canales se refieren a los servicios de comunicación compatibles con OpenClaw, como Telegram, WhatsApp, Discord y más. Usa la tecla de flecha hacia abajo para seleccionar la opción «Skip for now» (Saltar por ahora) y luego presiona Enter.
A continuación, se te pedirá que configures las habilidades (skills) de inmediato. Selecciona «Yes» y presiona Enter.
Instala las habilidades que necesites. En el siguiente ejemplo, seleccionamos la opción «Skip for now» (presiona la barra espaciadora para seleccionar) y luego presionamos Enter.
Luego vienen los Hooks (enganches); marcaremos «command-logger» y «session-memory».
La instalación ya está completa. Puedes iniciar OpenClaw seleccionando «Hatch in TUI» y presionando Enter.

Nota

Puedes iniciar OpenClaw ingresando el siguiente comando:

openclaw tui

Y puedes presionar ctrl+c dos veces para salir de la interfaz TUI.

Hacer que OpenClaw opere el Pironman5 Pro MAX

Para permitir que OpenClaw opere el Pironman5 Pro MAX, necesitamos instalar la skill de Pironman5 Pro MAX.

Asegúrese de que ya ha instalado el Pironman5 Pro MAX. Si no, consulte Descarga e Instalación del Módulo pironman5.

Ejecute el siguiente comando en la terminal:

mkdir -p ~/.openclaw/skills && rsync -av --delete ~/pironman5/skill/pironman5-promax-skill/ ~/.openclaw/skills/pironman5-promax-skill/

Ahora puede operar el Pironman5 Pro MAX en openclaw tui. Intente enviar comandos en el TUI, como intentar encender las luces LED de la carcasa, cambiar su color o hacer que la cámara tome una foto. Incluso puede decirle que tiene un módulo DHT11 conectado a GPIO17 y dejar que le diga la temperatura.

Nota

Si OpenClaw aún no puede reconocer la skill que importó, recuérdele que haga rsync.

Interacción por Voz

La carcasa Pro MAX tiene un micrófono y altavoz integrados, por lo que puede usar el Pironman5 Pro MAX para interactuar con OpenClaw por voz. Para lograr esto, necesita instalar el paquete sunfounder-voice-assistant.

El paquete sunfounder-voice-assistant proporciona las bibliotecas y herramientas necesarias para operar el hardware del Pironman 5 Pro MAX.

Ejecute el siguiente comando de instalación:

sudo apt install portaudio19-dev
sudo pip install --break git+https://github.com/sunfounder/sunfounder-voice-assistant.git

Aquí explorará texto a voz (TTS), voz a texto (STT) y modelos de lenguaje de gran tamaño (LLM) para hacer que su Pironman 5 Pro MAX hable, escuche e incluso converse con usted como un robot inteligente.

Luego, ejecute el siguiente ejemplo:

python3 ~/pironman5/openclaw_voice.py

Reinicie. Luego podrá usar las funciones de voz del Pironman5 Pro MAX para interactuar con OpenClaw. Intente decir «Hi Amy» para activarlo.

Opera tu Sistema con Telegram

Descripción general

A través de OpenClaw, puedes usar aplicaciones de mensajería populares para operar tu sistema (aquí usamos Telegram como ejemplo). Incluso puedes dejar que OpenClaw te ayude a completar esta configuración.

Simplemente pregunta en openclaw tui: «Quiero conectarte a Telegram, ¿qué debo hacer?»

Él te guiará paso a paso a través del proceso, y puedes seguir sus instrucciones para completar la configuración.

Requisitos previos

Antes de comenzar, asegúrate de tener:

Una cuenta de Telegram
Acceso de red a Telegram
OpenClaw ejecutándose correctamente (verifica con openclaw status)

Paso 1: Crear un Bot de Telegram

Encuentra a @BotFather en Telegram (el creador oficial de bots)
Crea un nuevo bot: Envía el comando /newbot
Sigue las instrucciones: * Dale un nombre a tu bot (ej., Mi Asistente OpenClaw) * Establece un nombre de usuario para tu bot (debe terminar en bot, ej., mi_openclaw_bot)
Al tener éxito, recibirás un mensaje que contiene tu Token del Bot, similar a:
```
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
```
Advertencia

¡Protege este token como una contraseña!

Paso 2: Configurar Telegram en OpenClaw

En openclaw tui, di directamente:

> «Quiero conectar mi bot de Telegram a OpenClaw. Aquí está mi Token del Bot: <tu-token-aquí>. Por favor, ayúdame a completar la configuración.»

OpenClaw automáticamente:

Instalará las dependencias necesarias (como node-telegram-bot-api)
Creará el archivo de configuración de la puerta de enlace (gateway) de Telegram
Probará si la conexión es exitosa

Paso 3: Probar la Conexión

Encuentra tu bot recién creado en Telegram
Envía el comando /start
El bot debería responder con un código de emparejamiento (pairing code), envía este código a la TUI de OpenClaw (ej., Pairing code: ZAN4XI34)
Espera a que se configure correctamente
Intenta enviar comandos simples como «hola»
Si todo está configurado correctamente, deberías ver la respuesta de tu bot

Paso 4: ¡Disfruta!

Después de completar esta configuración, podrás:

Controlar tu Raspberry Pi en cualquier momento y lugar a través de Telegram
Ejecutar comandos de forma remota y verificar el estado del sistema
Controlar dispositivos físicos integrando GPIO (como encender LEDs)
Disfrutar de una experiencia interactiva inteligente con tu asistente de IA

Configuración de Seguridad (¡Crítica!)

Para evitar que extraños controlen tu sistema, asegúrate de implementar las siguientes medidas de seguridad:

Medida de Seguridad	Método de Configuración	Descripción
Restringir Usuarios	Establece `allowedUsers` en la configuración	Permitir solo usuarios específicos de Telegram
Establecer Contraseña	Agrega `"password": "tu-contraseña"` en la configuración	Requerir verificación de contraseña antes de los comandos
Restringir Comandos	Crear una lista blanca de comandos	Permitir solo comandos predefinidos específicos
Registros de Auditoría	Habilitar el hook `command-logger`	Registrar todos los comandos ejecutados a través de Telegram

¡Recuerda: la seguridad es lo primero! Siempre restringe los usuarios y el alcance de los comandos de manera apropiada. Si encuentras problemas específicos durante la configuración, no dudes en pedir ayuda.

Solución de Problemas de OpenClaw

Durante la instalación, obtengo el error Error: systemctl is-enabled unavailable: Command failed: systemctl --user is-enabled openclaw-gateway.service. ¿Qué debo hacer?

Puedes ignorar esto por ahora, pero podrías encontrar problemas en los siguientes pasos. Por favor, refiérete a ellos uno por uno en ese momento.

Cuando ejecuto openclaw tui, obtengo el error -bash: openclaw: command not found. ¿Qué debo hacer?

Ejecuta el siguiente comando:
```
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
```
Ahora deberías poder iniciar la interfaz TUI con openclaw tui.

En openclaw tui, encuentro not connected to gateway — message not sent o el mensaje gateway disconnected: closed.

Esto se debe a que tu servicio OpenClaw Gateway no se ha iniciado. Abre otra terminal y ejecuta el siguiente comando para iniciar OpenClaw Gateway:
```
openclaw gateway
```
Luego reinicia openclaw tui y podrás usarlo directamente.

Quiero configurar el servicio OpenClaw Gateway para que se ejecute en segundo plano / se inicie automáticamente al arrancar. ¿Cómo lo hago?

Normalmente, tu servicio OpenClaw Gateway debería iniciarse automáticamente al arrancar. Si no es así, puedes iniciarlo manualmente con el siguiente comando.

Crea el directorio ~/.config/systemd/user:

mkdir -p ~/.config/systemd/user

Crea el archivo openclaw-gateway.service:

cat > ~/.config/systemd/user/openclaw-gateway.service << EOF
[Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
Type=simple
ExecStart=$HOME/.npm-global/bin/openclaw gateway run
Restart=on-failure
RestartSec=10
Environment="PATH=$HOME/.npm-global/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin"
Environment="NODE_ENV=production"

[Install]
WantedBy=default.target
EOF

Luego recarga la configuración de systemd:

systemctl --user daemon-reload

Inicia el servicio:

systemctl --user start openclaw-gateway

En este punto, reinicia openclaw tui y podrás usarlo directamente.

Habilítalo para que se inicie al arrancar:

systemctl --user enable openclaw-gateway

Mi OpenClaw no puede operar el sistema, ¿qué debo hacer?

Una instalación nueva de OpenClaw puede no tener permiso para operar tu sistema Raspberry Pi por defecto; solo puede chatear. Necesitamos configurar manualmente los permisos.
1. Abre el archivo de configuración de OpenClaw:
```
nano ~/.openclaw/openclaw.json
```
2. Encuentra la opción tools y modifique los perfiles y los exec de la siguiente manera.
```
"tools": {
   "profile": "coding",
   "exec": {
      "secrity": "full"
},
```
3. Guarda y sal.
4. Ingresa el siguiente comando en la terminal para reiniciar OpenClaw Gateway:
```
openclaw gateway restart
```
Ahora, OpenClaw debería tener permisos de lectura y escritura y ser capaz de operar tu sistema Raspberry Pi.