reachy-mini
Control a Reachy Mini robot (by Pollen Robotics / Hugging Face) via its REST API and SSH. Use for any request involving the Reachy Mini robot — moving the head, body, or antennas; playing emotions or dances; capturing camera snapshots; adjusting volume; managing apps; checking robot status; or any physical robot interaction. The robot has a 6-DoF head, 360° body rotation, two animated antennas, a wide-angle camera (with non-disruptive WebRTC snapshot), 4-mic array, and speaker.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/afalk42/reachy-miniWhat This Skill Does
The reachy-mini skill provides comprehensive control over the Pollen Robotics Reachy Mini robot. It acts as an abstraction layer between the OpenClaw AI agent and the robot's REST API and SSH subsystems. This skill allows the agent to command complex physical behaviors, including 6-DoF head movements, 360-degree body rotation, and expressive antenna gestures. It also manages non-physical robot state, such as volume control, emotion playback, and high-quality camera snapshots via the robot's wide-angle sensor.
Installation
To integrate this skill into your environment, run the following command via the OpenClaw CLI:
clawhub install openclaw/skills/skills/afalk42/reachy-mini
Ensure that the environment variables REACHY_HOST (default: 192.168.8.17), REACHY_PORT, REACHY_SSH_USER, and REACHY_SSH_PASS are configured in your shell profile or the agent's configuration file to permit successful API and SSH communication.
Use Cases
This skill is ideal for HRI (Human-Robot Interaction) research, automated telepresence, and interactive agent applications. Users can leverage the robot to perform "check-ins" by moving the head to scan a room, playing specific emotional cues during a conversation, or capturing snapshots of an environment for visual analysis. It is also excellent for choreographing "dances" or expressive gestures to make the robot feel more anthropomorphic and engaging in a workspace.
Example Prompts
- "Reachy, please turn your body 90 degrees to the left, look up, and play a cheerful emotion to welcome our guest."
- "Take a high-quality snapshot of the desk area and save it to my home directory for review."
- "Move your head to neutral and set the speaker volume to 50 percent."
Tips & Limitations
The robot's movement API interprets values in radians. When using the goto command, ensure your pitch, yaw, and roll inputs stay within the safety boundaries (-0.5 to 0.5 for head movement) to prevent mechanical strain. The snap command requires active SSH credentials; ensure the robot is on the same local network as the agent. For fluid, natural movements, the default minjerk interpolation mode is recommended, whereas cartoon mode should be reserved for expressive or playful interaction scenarios.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-afalk42-reachy-mini": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, external-api, code-execution