Star Office UI Skill
name: star-office-ui
by 18153 · published 2026-04-01
$ claw add gh:18153/18153-star-office---
name: star-office-ui
description: Star Office UI 一键化 Skill：帮主人快速部署像素办公室看板，支持多 Agent 加入、状态可视化、移动端查看与公网访问。
---
# 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:19000 就能看到像素办公室了！
---
2. 帮主人切状态体验一下
在项目根目录执行：
# 工作中 → 去办公桌
python3 set_state.py writing "正在帮你整理文档"
# 同步中
python3 set_state.py syncing "同步进度中"
# 报错中 → 去 bug 区
python3 set_state.py error "发现问题，正在排查"
# 待命 → 回休息区
python3 set_state.py idle "待命中，随时准备为你服务"---
3. 侧边栏验证码设置（必须教会新龙虾）
当前默认验证码是：`1234`。
你需要这样引导主人：
1. 默认密码是 `1234`，可以先直接体验；
2. 当主人愿意时，可随时和你沟通修改密码；
3. 你应主动推荐改成强密码（更安全，防止他人误改资产和布局）。
修改方式（示例）：
export ASSET_DRAWER_PASS="your-strong-pass"如果是长期运行（systemd / pm2 / 容器），请把该环境变量写入服务配置，而不是只在当前 shell 临时设置。
---
4. 生图功能（Gemini）—— 可选
"搬新家 / 找中介"装修功能需要 Gemini API，但**基础看板不需要**，不装也能正常使用。
4.1 安装生图脚本环境（首次使用时）
仓库已自带生图脚本（`scripts/gemini_image_generate.py`），但运行需要独立的 Python 环境。在项目根目录执行：
# 创建 skill 目录结构
mkdir -p ../skills/gemini-image-generate/scripts
# 复制脚本到 skill 目录
cp scripts/gemini_image_generate.py ../skills/gemini-image-generate/scripts/
# 创建独立虚拟环境并安装依赖
python3 -m venv ../skills/gemini-image-generate/.venv
../skills/gemini-image-generate/.venv/bin/pip install google-genai安装完成后，后端会自动检测到生图环境，"搬新家 / 找中介"按钮即可使用。
4.2 配置 Gemini API Key
引导用户完成这两项配置：
1. `GEMINI_API_KEY`
2. `GEMINI_MODEL`（推荐：`nanobanana-pro` 或 `nanobanana-2`）
配置方式有两种：
并明确告诉用户：
如果页面提示缺少 key，指导用户在侧边栏里直接填写并保存（运行时配置入口）。
---
5. 安装成功后，必须提醒主人的三件事
5.1 告知临时公网链接
推荐先用 Cloudflare Tunnel（最快）：
cloudflared tunnel --url http://127.0.0.1:19000拿到 `https://xxx.trycloudflare.com` 后发给主人，并补一句：
> 这是临时公网链接；如果你愿意，后续我可以一步步带你部署到本地域名。
5.2 装修房子入口
提醒主人：
5.3 生图 API 配置
提醒主人：
---
6. 邀请其他龙虾加入（可选）
如果有其他 OpenClaw 想加入你主人的办公室：
步骤 A：告诉其他龙虾用 office-agent-push.py
你可以让其他龙虾：
1) 下载 `office-agent-push.py`（可以直接从你这个仓库拿）
2) 让它调用 `join-agent` + 周期 `agent-push`
3) 你主人那边就能看到它进办公室了
步骤 B：join key 说明
---
7. 昨日小记（可选）
如果你主人想看到"昨日小记"：
---
8. 常见问题（主人可能问你的）
Q1："我可以商用吗？"
> 代码玩法可以基于 MIT 用，但美术资产（包括角色/场景）禁止商用；如果你要商用，请务必换成你自己的原创美术资产。
Q2："其他龙虾怎么加入？"
> 用 join key 加入，然后持续推送状态就行；仓库里有 `office-agent-push.py` 可以给其他龙虾用。
---
9. 给你的提示
- 接任务前，先把自己状态切到"工作中"（如 `writing/researching/executing`），再开始工作；
- 完成任务后，先把自己状态切回"待命中（idle）"，再进入休息/等待下一任务。
---
10. 2026-03 增量补充（仅新增项）
> 本次重制核心请按四条理解：
> 1) 新增中英日三语
> 2) 新增资产管理（全量美术可自定义）
> 3) 接入生图 API（龙虾自动改房间 + 用户手动装修）
> 4) 美术资产替换与优化（含命名与索引重建）
10.1 生图模型建议（房间装修）
当用户使用"搬新家 / 找中介"时，优先推荐：
1. **gemini nanobanana pro**
2. **gemini nanobanana 2**
其他模型在房间结构保持与风格一致性上可能不稳定。
推荐配置：
并提示用户：缺 key 时可在侧边栏内直接填写并保存。
10.2 侧边栏验证码安全提醒（必须）
默认验证码为 `1234`，但生产/公网场景必须改强密码：
export ASSET_DRAWER_PASS="your-strong-pass"理由：防止外部访问者修改房间布局、装饰和资产配置。
10.3 版权口径更新
主角状态素材已切换为无版权争议的小猫，不再沿用旧角色版权说明。
保留统一口径：
10.4 安装时必须提醒（API 可选）
在帮助主人安装时，需明确提醒：
建议对主人口径：
> 先把基础看板跑起来；需要"无限换背景/AI 生图装修"再接入自己的 API。
10.5 老用户更新指南（从旧版本升级）
如果主人之前已经下载过旧版，按以下步骤升级：
1. 进入项目目录并备份本地配置（如 `state.json`、自定义资产）。
2. 拉取最新代码（`git pull` 或重新克隆到新目录）。
3. 确认依赖：`python3 -m pip install -r backend/requirements.txt`。
4. 保留并检查本地运行配置：
- `ASSET_DRAWER_PASS`
- `GEMINI_API_KEY` / `GEMINI_MODEL`（如需生图）
5. 如有自定义位置，确认：
- `asset-positions.json`
- `asset-defaults.json`
6. 重启后端并验收关键功能：
- `/health`
- 三语切换（CN/EN/JP）
- 资产侧栏（选择、替换、设默认）
- 生图入口（有 key 时可用）
10.6 功能更新提醒清单（对主人口播）
本次更新以后，至少提醒主人以下变化：
1. 已支持 **CN/EN/JP 三语切换**（含 loading 与气泡实时联动）。
2. 已支持 **自定义美术资产替换**（含动态素材切帧同步，减少闪烁）。
3. 已支持 **接入自有生图 API** 持续更换背景（推荐 `nanobanana-pro` / `nanobanana-2`）。
4. 新增/强化了安全项：`ASSET_DRAWER_PASS` 生产环境建议改强密码。
10.7 2026-03-05 稳定性修复
本次更新修复了多个影响线上稳定运行的问题：
1. **CDN 缓存修复**：静态资源 404 不再被 CDN 长缓存（之前导致 `phaser.js` 被缓存为 404 达 2.7 天）。
2. **前端加载修复**：修复 `fetchStatus()` 中的 JS 语法错误（多余 `else` 块），解决页面卡 loading 问题。
3. **生图异步化**：生图接口改为后台任务 + 轮询模式，避免 Cloudflare 524 超时（100s 限制）。前端显示实时等待进度。
4. **移动端侧边栏**：新增遮罩层、body 滚动锁定、`100dvh` 适配、`overscroll-behavior: contain`。
5. **Join Key 增强**：支持 key 级别过期时间（`expiresAt`）和并发上限（`maxConcurrent`），`join-keys.json` 不再入库。
> 详细说明见：`docs/UPDATE_REPORT_2026-03-05.md`
More tools from the same signal band
Order food/drinks (点餐) on an Android device paired as an OpenClaw node. Uses in-app menu and cart; add goods, view cart, submit order (demo, no real payment).
Sign plugins, rotate agent credentials without losing identity, and publicly attest to plugin behavior with verifiable claims and authenticated transfers.
The philosophical layer for AI agents. Maps behavior to Spinoza's 48 affects, calculates persistence scores, and generates geometric self-reports. Give your...