star-office-helper

Install, start, and troubleshoot the Star-Office-UI local visualization companion for OpenHub.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/Grong/openhub-client --skill star-office-helper-grong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: star-office-helper
Source: https://github.com/Grong/openhub-client/tree/main/crates/backend/openhub-app/assets/builtin-skills/star-office-helper
Command: npx skills add https://github.com/Grong/openhub-client --skill star-office-helper-grong

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Setting up the third-party Star-Office-UI visualization companion involves cloning a repo, creating a Python virtual environment, starting backend and frontend services, and wiring the correct URL into OpenHub's preview panel — a process prone to PEP 668 pip errors, port confusion, and Unauthorized pages. ## Core Features & Use Cases - Automated Install and Repair: Run doctor and setup scripts that clone Star-Office-UI, create a .venv, install backend dependencies, and initialize state.json. - Service Verification and Troubleshooting: Diagnose port 19000/18791 status, Unauthorized responses, and missing event flow with strict verification rules. - Clean Uninstall: Stop all Star Office processes, free ports, remove the directory, and verify cleanup with a dedicated script. - Use Case: A user clicks the TV icon in OpenHub and sees a blank preview; the Skill runs the doctor script, repairs the venv, restarts the backend and frontend, and confirms the monitor is live at http://127.0.0.1:19000. ## Quick Start Install Star Office on my machine and connect it to the OpenHub preview panel so I can watch the live agent monitor.

Frequently Asked Questions about star-office-helper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install Star-Office-UI for OpenHub?

Run the setup script, which clones the Star-Office-UI repo, creates a Python virtual environment, installs backend requirements, and copies state.sample.json to state.json. Then start the backend with the venv Python and the frontend with npm, and verify http://127.0.0.1:19000 responds.

Why does Star Office show an Unauthorized page?

Unauthorized usually means the backend is running but its session or auth state is not initialized, or you opened the backend port 18791 directly instead of the frontend port 19000. Ensure state.json exists and open the frontend URL in the OpenHub preview panel.

How do I fix pip externally-managed-environment errors on macOS?

Homebrew Python follows PEP 668 and blocks system-wide pip installs. Create a virtual environment with python3 -m venv .venv, then install dependencies using .venv/bin/python -m pip install -r backend/requirements.txt instead of --break-system-packages.

Why is Star Office connected but the preview not animating?

Star Office only animates when its own backend and frontend are running and receiving events from OpenClaw. Confirm the frontend port 19000 is reachable, the backend is receiving task events, and the preview panel URL exactly matches the frontend address.

How do I completely uninstall Star-Office-UI?

Run the uninstall script, which kills backend and frontend processes, frees ports 19000 and 18791, removes the Star-Office-UI directory, and verifies cleanup. Do not manually delete the folder without stopping services first.

Is Star Office required for OpenHub or OpenClaw to work?

No. Star Office is a third-party visualization layer and is not built into OpenHub. OpenClaw executes tasks independently; Star Office only animates agent status when its own services and event bridge are active.