Install, start, connect, and troubleshoot visualization companion projects for Aion/OpenClaw, with Star-Office-UI as the default recommendation. Use when users ask for Star Office setup, URL/port connection, Unauthorized page diagnosis, Python venv/pip issues (PEP 668), preview panel wiring, real-time monitor wake-up checks, or similar open-source visualizer alternatives.
Guide users from zero to usable visualization integration in Aion. Prefer Star-Office-UI first, then provide alternatives only when requested or when Star Office does not fit.
Star Office UI is a third-party open-source local visualization companion for OpenClaw / Aion.
http://127.0.0.1:19000).Capabilities when connected:
When a user asks "what is Star Office" or triggers the install flow, introduce it clearly with the above context before proceeding.
When Star Office is already detected on the local machine:
http://127.0.0.1:19000).When Star Office is not detected:
Unauthorized.skills/star-office-helper/scripts/star_office_doctor.sh.python3 -m pip install fails with externally-managed-environment, switch to venv flow.skills/star-office-helper/scripts/star_office_setup.sh..venv, installs backend dependencies, and ensures state.json exists.http://127.0.0.1:19000).references/discovery.md.When the user triggers one-stop install/repair (e.g. via the TV icon), follow these rules:
python/python3 processes as Star Office residuals unless their command/path explicitly references Star-Office-UI or its backend app.You MUST execute every step yourself. Each step should include a short progress message.
bash skills/star-office-helper/scripts/star_office_doctor.sh, report findings.bash skills/star-office-helper/scripts/star_office_setup.sh, report success or failure.cd ~/Star-Office-UI/backend && nohup ../.venv/bin/python app.py > /dev/null 2>&1 &cd ~/Star-Office-UI/frontend && npm install && nohup npm run dev > /dev/null 2>&1 &http://127.0.0.1:19000/health responds. Report detected URL.http://127.0.0.1:19000. Do NOT end your response without confirming the final URL."Uninstall" means stop all services AND remove all files. You MUST run the uninstall script — do NOT manually delete the directory without stopping services first.
bash skills/star-office-helper/scripts/star_office_uninstall.sh. This script handles the full sequence: kill processes, free ports, remove directory, and verify cleanup.Star-Office-UI processes remain~/Star-Office-UI directory is removedpip --break-system-packages unless user explicitly asks for system-wide install.# Diagnose current machine and ports
bash skills/star-office-helper/scripts/star_office_doctor.sh
# Bootstrap Star-Office-UI in ~/Star-Office-UI
bash skills/star-office-helper/scripts/star_office_setup.sh
# Bootstrap in a custom folder
bash skills/star-office-helper/scripts/star_office_setup.sh /path/to/Star-Office-UI
# Uninstall Star-Office-UI (stop services + remove files + verify)
bash skills/star-office-helper/scripts/star_office_uninstall.sh
# Uninstall from a custom folder
bash skills/star-office-helper/scripts/star_office_uninstall.sh /path/to/Star-Office-UI
references/troubleshooting.md for:
Unauthorized root causes18791 vs 19000)references/discovery.md for: