HooRii
Workshop Login

ClawStage User Guide

Hello!

Welcome to ClawStage!

This help guide will walk you through the basics and help you get started with ClawStage. ClawStage is a Raspberry Pi-based desktop AI companion powered by the OpenClaw. It can perceive its surroundings, remember important information, interact with you through voice, and control compatible smart home devices. You can also create a custom personality and configure a large language model, turning ClawStage into a companion that fits naturally into your everyday life.

If you have any questions, browse this guide at any time to find the information you need.

BYOPi —
Bring Your Own Pi

If you bought ClawStage CS-01-N, the Bring Your Own Pi version, follow the installation guide to flash the system image and install your Raspberry Pi 5.

BYOPi Installation >

Activate
ClawStage

01.

Download the ClawStage app

Download ClawStage app

Search for ClawStage in the App Store and download the app. Then, connect ClawStage to a power source.

02.

Create a HooRii account

Create HooRii account

Open the ClawStage app and create an account. During registration, enter the 4-digit invitation code included in the email from HooRii.

03.

Add a ClawStage device

Bind ClawStage

Open the ClawStage app and tap Add ClawStage. Then scan the QR code displayed on the device screen. We recommend using 2.4 GHz Wi-Fi to set up the device.

04.

ClawStage connected

Successfully connected

Follow the instructions in the app to complete Wi-Fi setup and device initialization. Once setup is complete, ClawStage will enter standby mode.

05.

Update ClawStage firmware

Always Update Firmware

Before you start using ClawStage, open the device panel in the app and go to the control panel. Update the firmware there first. Always update to the latest firmware before use.

Device
Control

Settings

Tap the menu button in the top-left corner of the app, then select Settings. From here, you can change your nickname and password. You can also choose the language used when talking with AI and set your location. Location information helps ClawStage provide more relevant context during conversations, such as when you ask about the weather.

Device Info

Tap the menu button in the top-left corner of the app, then tap the ClawStage card to open the device information page. Here, you can view details about your device, including Wi-Fi information, the device name, and available storage. You can also drag the volume slider to adjust ClawStage's volume.

OTA

On the device information page, tap Firmware Update. The app will automatically check the current firmware status of your ClawStage. If a new version is available, follow the instructions to complete the firmware update.

Privacy Button

The privacy button is located on the back of ClawStage. When the privacy button is turned on, the camera and microphone are physically disconnected to help protect your privacy. Turn the button off to restore camera and microphone functionality.

Unbind

Before unbinding your device, make sure your phone and ClawStage are nearby and that ClawStage remains powered on. Open the device information card, scroll to the bottom of the page, and tap Unbind. Then follow the on-screen instructions to complete the process.

Shutdown

Press the power button on the back of ClawStage once. When the menu appears on the screen, tap Shutdown to safely turn off ClawStage.

Trouble
Shooting

What if initialization, Wi-Fi setup, or BYOK fails and nothing responds?

When you use your phone to initialize the device, configure BYOK, or unbind it, turn on Bluetooth on your phone and keep the phone near ClawStage.

What if ClawStage freezes and stops responding?

Press and hold the power button to force a shutdown. Do not use this method to turn the device off in any other situation.

How do I reset the system?

Log in to the Raspberry Pi. First find ClawStage's LAN IP address, then connect. The first connection requires you to confirm the identity:

ssh pi@your ip
Username: pi
Password: goodlife

In the terminal, enter:

ssh -t pi@RaspberryPiIP 'sudo systemd-run --unit=clawstage-factory-reset --collect /usr/bin/python3 /home/pi/clawstage/current/factory_reset.py'

AI
Conversation

You can talk to ClawStage in several ways:

Touch to talk

01.

Touch

Start a conversation: Tap Talk to HooRii on the ClawStage screen.

End a conversation: Tap the End button on the screen to exit the current conversation.

Mute or unmute: Tap the button on the left side of the ClawStage screen to toggle mute.

Voice conversation

02.

Voice

Wake up ClawStage: Say the wake word, "Hey Miko".

End a conversation: Say the exit phrase, "Goodbye".

Text conversation

03.

Text

On your phone, you can use the ClawStage app to send text messages, images, and files to the AI.

Plan and
Credits

ClawStage credits

ClawStage's AI services use credits. You can subscribe to a plan to receive additional credits. Three plans are currently available: Starter, Standard, and Pro. Each plan includes a different amount of credits.

Tap the menu button in the top-left corner of the app, then select Plan & Credits to open the subscription page and choose the plan that best suits your needs.

Credit Types

Each account can receive the following types of credits:

Free Credits:
You receive 3,000 permanent credits when you register an account. These credits never expire.

Daily Credits:
Earn up to 100 credits a day. The total is capped at 2,000.

Monthly Credits:
These credits are issued every month after you subscribe to the Plan service. Unused credits can roll over to the following month.

Top-Up Credits:
Credits purchased as a one-time purchase through Kickstarter. These credits never expire.

Credits are used in the following order: Daily → Monthly → Free → Top-Up

View Your Credit History

You can view your current credit balance, as well as your credit earnings and spending history, on the Credits page.

Tap the menu button in the top-left corner of the app, select Plan & Credits, and then open the Credits tab.

BYOK -
Bring Your Own Key

Bring your own API key

BYOK mode allows you to use your own AI services without using your ClawStage Credits.

To configure a BYOK service, tap the menu button in the top-left corner of the app, select Plan & Credits, and open the subscription page. Then, find the BYOK section and configure the service you want to use.

Supported Services

LLM

You can configure a local Ollama instance, as well as services such as OpenAI, Google Gemini, and DeepSeek. To configure additional LLM services, go to the OpenClaw admin panel.

ASR

You can currently configure your own Deepgram service. This service runs in the cloud.

TTS

You can currently configure your own ElevenLabs service. This service runs in the cloud.

Guided setup is provided for each component. Once your services are configured, AI conversations in the app and on ClawStage will use your configured services first. If BYOK is turned off or a service has not been configured, ClawStage will use its default AI services and deduct the corresponding number of Credits.

Workshop &
Characters

Workshop characters

Workshop is HooRii's character community platform.

In Workshop, you can create, preview, and manage your own characters.

Create a Character

Use a text description to define your character's gender, background, talking vibe, MBTI type, and appearance. You can also upload a reference image to create a character of your own.

For voice options, Workshop currently supports multiple voices across 12 languages.

Preview a Character

You can have a preview conversation with a character in Workshop to see how it behaves. If you like the character, download it and use it with ClawStage.

Use a Character

Tap the menu button in the top-left corner of the app, then select Characters to open the list of available characters.

Before using a character, you need to download its resource package. Once the download is complete, activate the character to start using it on ClawStage.

Creating characters in Workshop consumes Credits only. BYOK is currently not supported as a way to offset these charges.

workshop.hoorii.io >

OpenClaw

OpenClaw

ClawStage comes with OpenClaw built in. To access OpenClaw, connect your phone or computer to the same network as ClawStage, then use the device's IP address.

Find the IP Address

In the ClawStage app, tap the menu button in the top-left corner, then tap the ClawStage device card. On the device information page, find the OpenClaw section to view the service IP address.

Through the WebUI

Enter the OpenClaw IP address in your browser and open the address to access the OpenClaw WebUI.

Through a Terminal

Enter the OpenClaw IP address in your terminal, then sign in when prompted.

ssh pi@your ip
Username: pi
Password: goodlife

Home
Assistant

Home Assistant

ClawStage comes with Home Assistant built in. To access the Home Assistant dashboard, connect your phone or computer to the same network as ClawStage, then use the device's IP address.

Find the IP Address

In the ClawStage app, tap the menu button in the top-left corner, then tap the ClawStage device card. On the device information page, find the Home Assistant section to view the service IP address.

Access the Dashboard

Enter the Home Assistant IP address in your browser and open the address to access the Home Assistant dashboard.

Username: stage
Password: hoorii

Best
Practice

A speech bubble

Getting along with ClawStage can start with a simple sentence. Ask how to use it, change how a character talks, or send a file from your phone and receive the result.

Best Practice >

Hardware
Overview

ClawStage front
Front
ClawStage rear
Rear

Specification

dimensions
92 × 92 × 184 mm
touch display
3.95 in · 720 × 720 · 800 nits
camera
1080p · 83.9° field of view
audio
Dual microphones · 3W speaker
microphone snr
65 dB(A)
servo rotation
5°–175°
sensors
3-axis accelerometer · ambient light
ssd interface
M.2 2230 / 2242
cooling
Raspberry Pi 5 fan included
privacy switch
Hardware control of mic & camera
power
USB Power Delivery supply
ClawStage User Guide | Hoorii