引言 > 'A pixel office for your OpenClaw: turn invisible work states into a cozy little space with characters, daily notes, and guest agents.' 这是「一天一个开源项目」系列的第 43 篇文章。今天介绍的项目是 **Star-Office-UI**（GitHub）…
'A pixel office for your OpenClaw: turn invisible work states into a cozy little space with characters, daily notes, and guest agents.'
这是「一天一个开源项目」系列的第 43 篇文章。今天介绍的项目是 Star-Office-UI（GitHub）。
AI Agent 的工作状态通常是"看不见"的——你不知道它正在做什么、昨天做了什么、现在是否在线。Star-Office-UI 是一款像素风格的 AI 办公室看板系统，它将 AI 助手的工作状态实时可视化，让你直观看到"谁在做什么、昨天做了什么、现在是否在线"。通过像素风格的办公室场景，不同的工作状态映射到不同的区域（休息区、工作区、Bug 区），角色会根据状态自动移动，配合动画和气泡提示，让 AI 的工作变得"可见"和"有趣"。支持多 Agent 协作、中英日三语、AI 生图装修、桌面宠物模式，与 OpenClaw 深度集成时体验最佳，也可以独立部署作为状态看板使用。
为什么值得看？
Star-Office-UI 是一款像素风格的 AI 办公室看板系统，旨在解决 AI Agent 工作状态"看不见"的问题。传统 AI Agent 的工作过程是黑盒的，用户无法直观了解 Agent 当前在做什么、昨天做了什么、现在是否在线。Star-Office-UI 通过像素风格的办公室场景，将抽象的工作状态转化为可视化的场景：
角色会根据当前状态自动移动到对应区域，配合动画和气泡提示，让 AI 的工作变得"可见"和"有趣"。
核心价值：
Star-Office-UI 由 Ring Hyacinth 与 Simon Lee 共同创建（co-created project），并与社区开发者（@Zhaohan-Wang、@Jah-yee、@liaoandi）一起持续维护和共建。
项目特点：
Star-Office-UI 的核心作用是将 AI Agent 的工作状态可视化，通过像素风格的办公室场景，让用户直观了解 AI 的工作状态：
memory/*.md 读取最近一天的工作记录，展示为"昨日小记"卡片方式一：让龙虾帮你部署（推荐给 OpenClaw 用户）
如果你正在使用 OpenClaw，直接把下面这句话发给你的龙虾：
请按照这个 SKILL.md 帮我完成 Star Office UI 的部署： https://github.com/ringhyacinth/Star-Office-UI/blob/master/SKILL.md
龙虾会自动完成 clone、安装依赖、启动后端、配置状态同步，并把访问地址发给你。
方式二：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:19000，然后试试切状态：
python3 set_state.py writing "正在整理文档" python3 set_state.py error "发现问题，排查中" python3 set_state.py idle "待命中"
idle（待命）、writing（写代码/文档）、researching（搜索/调研）、executing（执行任务）、syncing（同步数据）、error（错误）office-agent-push.py 脚本推送状态.env 文件配置敏感信息memory/*.md 读取最近一天的工作记录| 对比项 | Star-Office-UI | 传统状态页 | 其他可视化工具 |
|---|---|---|---|
| 可视化方式 | ✅ 像素风格场景 | ⚠️ 文字/图表 | ⚠️ 图表/仪表盘 |
| 多 Agent 支持 | ✅ 原生支持 | ❌ 不支持 | ⚠️ 部分支持 |
| OpenClaw 集成 | ✅ 深度集成 | ❌ 无集成 | ❌ 无集成 |
| 桌面宠物 | ✅ Tauri 桌面版 | ❌ 无 | ❌ 无 |
| AI 生图 | ✅ Gemini API | ❌ 无 | ❌ 无 |
| 多语言 | ✅ 中英日三语 | ⚠️ 单一语言 | ⚠️ 部分支持 |
| 部署难度 | ✅ 30 秒快速部署 | ⚠️ 需要配置 | ⚠️ 需要配置 |
为什么选择 Star-Office-UI？
Star-Office-UI 采用 前后端分离 的架构设计：
核心组件：
Star-Office-UI 将 6 种工作状态映射到办公室的 3 个区域：
| 状态 | 办公室区域 | 触发场景 |
|---|---|---|
idle | 🛋 休息区（沙发） | 待命 / 任务完成 |
writing | 💻 工作区（办公桌） | 写代码 / 写文档 |
researching | 💻 工作区 | 搜索 / 调研 |
executing | 💻 工作区 | 执行命令 / 跑任务 |
syncing | 💻 工作区 | 同步数据 / 推送 |
error | 🐛 Bug 区 | 报错 / 异常排查 |
实现原理：
set_state.py 脚本或 API 接口更新状态state.json 文件中Join Key 机制：
join-keys.json 文件ocj_example_team_01）office-agent-push.py 脚本，使用 join key 加入办公室访客接入流程：
# office-agent-push.py 示例 JOIN_KEY ="ocj_starteam02"# 分配的 key AGENT_NAME ="小明的龙虾"# 显示名称 OFFICE_URL ="https://office.hyacinth.im"# 办公室地址 python3 office-agent-push.py
状态自动同步：
在 OpenClaw 的 SOUL.md（或 Agent 规则文件）中加入以下规则：
## Star Office 状态同步规则 - 接到任务时：先执行 `python3 set_state.py <状态> "<描述>"` 再开始工作 - 完成任务后：执行 `python3 set_state.py idle "待命中"` 再回复
集成优势：
根据项目结构分析，Star-Office-UI 的技术栈包括：
关键技术：
资产来源：
访客角色动画使用了 LimeZu 的免费资产：
许可协议：
如需商用，请将所有美术资产替换为你自己的原创素材。
| 端点 | 说明 |
|---|---|
GET /health | 健康检查 |
GET /status | 获取主 Agent 状态 |
POST /set_state | 设置主 Agent 状态 |
GET /agents | 获取多 Agent 列表 |
POST /join-agent | 访客加入办公室 |
POST /agent-push | 访客推送状态 |
POST /leave-agent | 访客离开 |
GET /yesterday-memo | 获取昨日小记 |
GET /config/gemini | 获取 Gemini API 配置 |
POST /config/gemini | 设置 Gemini API 配置 |
欢迎来我中的个人主页找到更多有用的知识和有趣的产品
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online