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）

配置方式有两种：

• 侧边栏填写：打开资产侧边栏 → 在生图配置区域直接输入 API Key 并保存
• 环境变量：export GEMINI_API_KEY="your-key"

并明确告诉用户：

• 不配置 API 也能用基础看板（状态显示、多 Agent、资产替换等）
• 配置后才能使用"搬新家 / 找中介"的 AI 生图装修能力

如果页面提示缺少 key，指导用户在侧边栏里直接填写并保存（运行时配置入口）。

---

5. 安装成功后，必须提醒主人的三件事

5.1 告知临时公网链接

推荐先用 Cloudflare Tunnel（最快）：

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

拿到 https://xxx.trycloudflare.com 后发给主人，并补一句：

这是临时公网链接；如果你愿意，后续我可以一步步带你部署到本地域名。

5.2 装修房子入口

提醒主人：

• 现在可以点击"装修房间"开始装饰；
• 侧边栏默认密码是 1234；
• 当他想改密码时，可随时告诉你，你来帮他改；
• 推荐改成强密码，安全性更高。

5.3 生图 API 配置

提醒主人：

• 生图功能需要自己的 API；
• 当前接入的是 Gemini 官方 API 格式与地址；
• 若要替换成其他类型 API，请先和你沟通，由你来改接入；
• 最好让主人把对应 API 文档发给你，便于准确适配。

---

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

如果有其他 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

---

7. 昨日小记（可选）

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

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

---

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

Q1："我可以商用吗？"

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