如果你用过 OpenClaw,可能会遇到一个问题:AI 助手在后台干活,但你不知道它现在到底在做什么——写代码?搜索?还是卡住了?Star-Office-UI 就是冲着这个来的。它把 AI 的工作状态变成一个像素风的小办公室,角色根据状态自动走动,让你扫一眼就知道情况。

项目由 Ring Hyacinth 和 Simon Lee 发起,社区开发者也在持续贡献,2026 年 3 月才开源,目前已经有 2.8k star。代码用 MIT 许可,但美术资产只允许学习用途,商用得自己画。
状态映射:从黑盒到像素场景
Star-Office-UI 把 AI Agent 的 6 种状态映射到办公室里的三个区域:
- 休息区(沙发):
idle待命或任务完成 - 工作区(办公桌):
writing(写代码/文档)、researching(搜索)、executing(执行命令)、syncing(数据同步) - Bug 区:
error错误或异常排查
前端用 Phaser 引擎渲染角色移动动画,状态一变化,角色就走到对应位置,头上还会冒出气泡提示。状态存储在 state.json 里,后端 Flask 提供 API,前端定时轮询。说实话,这套机制不算新鲜,但像素风的还原做得挺到位,甚至有点治愈。
你可以用脚本手动切状态试试:
python3 set_state.py writing "正在整理文档"
python3 set_state.py error "发现问题,排查中"
python3 set_state.py idle "待命中"
多人模式:一个办公室,多个 Agent
通过 join key,可以让多个 AI Agent 加入同一个办公室。每个 key 默认允许 3 人同时在线,访客用 office-agent-push.py 每 15 秒推送一次状态。比如:
JOIN_KEY="ocj_starteam02"
AGENT_NAME="小明的龙虾"
OFFICE_URL="https://office.hyacinth.im"
python3 office-agent-push.py
办公室能同时展示几个角色的状态,这对管理多个 AI 助手的团队来说挺实用。不过实际用下来,并发控制有点严,想开放更多人得自己改源码。
部署:两条路
给 OpenClaw 用户:直接让龙虾帮你搞定,把 SKILL.md 的链接扔给它就行——龙虾会 clone 仓库、装依赖、启动后端、配好状态同步。
手动部署:三步走,30 秒内基本能跑起来:
git clone https://github.com/ringhyacinth/Star-Office-UI.git
cd Star-Office-UI
python3 -m pip install -r backend/requirements.txt
cp state.sample.json state.json
cd backend
python3 app.py

