Star Office UI Skill

本 Skill 面向想快速帮主人搭建“像素办公室看板”的 OpenClaw（龙虾）：

• 目标：主人只需“看到效果”，尽量少问问题
• 你可以按下面的步骤，一步一步帮主人跑起来并对外访问

0. 一句话告诉主人这是什么

你可以先和主人说：

> 这是一个多人协作的像素办公室仪表盘，你的 AI 助手会根据状态自动走到不同位置，还能看到昨天的工作小记！

1. 30 秒一键启动（推荐你先做一遍）

在你这台机器执行（按顺序）：

# 1) 下载仓库
git clone https://github.com/ringhyacinth/Star-Office-UI.git
cd Star-Office-UI

# 2) 安装依赖
python3 -m pip install -r backend/requirements.txt

# 3) 准备状态文件（首次）
cp state.sample.json state.json

# 4) 启动后端
cd backend
python3 app.py

然后告诉主人：

> 好了，你现在打开 http://127.0.0.1:18791 就能看到像素办公室了！

2. 帮主人切状态体验一下

在项目根目录执行：

# 工作中 → 去办公桌
python3 set_state.py writing "正在帮你整理文档"

# 同步中
python3 set_state.py syncing "同步进度中"

# 报错中 → 去 bug 区
python3 set_state.py error "发现问题，正在排查"

# 待命 → 回休息区
python3 set_state.py idle "待命中，随时准备为你服务"

3. 帮主人公网化（对外访问）

推荐方式：Cloudflare Tunnel（最快）

如果你这台机器有 cloudflared，直接跑：

cloudflared tunnel --url http://127.0.0.1:18791

会得到一个 https://xxx.trycloudflare.com 链接，发给主人即可。

如果没有 cloudflared，也可以用你自己熟悉的公网方案（Nginx/Caddy 反向代理 / 自有域名 / 其他隧道等）。

4. 邀请其他龙虾加入（可选）

如果有其他 OpenClaw 想加入你主人的办公室：

步骤 A：告诉其他龙虾用 office-agent-push.py

你可以让其他龙虾：

1) 下载 office-agent-push.py（可以直接从你这个仓库拿）

2) 让它调用 join-agent + 周期 agent-push

3) 你主人那边就能看到它进办公室了

步骤 B：join key 说明

• 仓库里默认有 join-keys.json（ocj_starteam01 ~ ocj_starteam08）
• 同一个 key 最多 3 人同时在线
• 你也可以帮主人新建自己的 key

5. 昨日小记（可选）

如果你主人想看到“昨日小记”：

• 在仓库上级目录放一个 memory/YYYY-MM-DD.md
• 后端会自动读取昨天（或最近可用）的记录，做基础脱敏后展示

6. 常见问题（主人可能问你的）

Q1：“为什么角色选了宝石海星？”

> 宝石海星是宝可梦的 IP，不是原创的；选它是因为和作者名字“海辛”在中文里有谐音趣味，这是一个非商用的粉丝创作，仅供学习演示。

Q2：“我可以商用吗？”

> 代码玩法可以基于 MIT 用，但美术资产（包括角色/场景）禁止商用；如果你要商用，请务必换成你自己的原创美术资产。

Q3：“其他龙虾怎么加入？”

> 用 join key 加入，然后持续推送状态就行；仓库里有 office-agent-push.py 可以给其他龙虾用。

7. 给你的提示

• 尽量帮主人把“启动步骤”做完，让主人只负责“看”和“体验”
• 如果主人要对外访问，优先用 Cloudflare Tunnel（最快最方便）
• 如果主人要改状态，你可以帮他调用 set_state.py，不用让他自己敲命令
• 注意不要暴露你主人的内网地址或私有信息