freedak/MyAiDesk

Files

T

freedak f7a720204a Update: 将子项目从 submodule 转为完整内容

- 移除 GovAI, nomifun-tauri, 算力盒子 的 submodule 引用
- 添加所有子项目的完整源代码
- 保留原始 .git 为 .git.bak 备份

2026-07-04 19:20:46 +08:00

1.6 KiB

Raw Blame History

Star Office Troubleshooting

1. `Unauthorized` on `127.0.0.1:<port>`

Common causes:

Backend started but session/auth state not initialized.
Opened backend port directly instead of frontend port.
state.json missing or invalid.

Actions:

Ensure state.json exists (copy from state.sample.json if needed).
Start backend with venv Python:
- cd backend && ../.venv/bin/python app.py
Open frontend URL (usually http://127.0.0.1:19000) instead of backend API port.
Run bash skills/star-office-helper/scripts/star_office_doctor.sh and check port + HTTP status.

2. `pip install` fails with `externally-managed-environment`

Cause:

macOS/Homebrew Python follows PEP 668 and blocks system-wide pip write.

Fix:

python3 -m venv .venv
.venv/bin/python -m pip install --upgrade pip
.venv/bin/python -m pip install -r backend/requirements.txt

Avoid:

--break-system-packages unless user explicitly requires system install.

3. Nomi connected but preview does not move

Cause:

Nomi can talk to OpenClaw, but Star Office is only a visualization layer.
No event bridge from OpenClaw task stream to Star Office backend.
Wrong preview URL.

Checklist:

Confirm Star Office frontend port (default 19000) is reachable.
Confirm backend is running and receiving events.
Confirm Nomi preview panel URL exactly matches frontend URL.
Trigger a real OpenClaw task and observe backend logs.

4. Port confusion (`18791` vs `19000`)

Typical mapping:

18791: backend/service/auth endpoint (may return Unauthorized).
19000: frontend visual UI for browser preview.

Rule:

In Nomi preview panel, use frontend URL.