📖 技能介绍

name: star-office-deploy description: Star Office UI 一键部署技能 — 帮主人快速部署像素办公室看板，支持多 Agent 加入、状态可视化、移动端查看与公网访问 metadata: openclaw: version: 3.0 requires: pip: - flask - pillow

Star Office UI 部署技能

一句话介绍

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

快速部署流程

步骤 1: 下载仓库

cd /Users/panda/.openclaw/workspace
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

或使用后台运行：

nohup python3 app.py > /tmp/star-office.log 2>&1 &

步骤 5: 告知主人访问地址

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

状态切换体验

帮主人切换状态看看效果：

cd /Users/panda/.openclaw/workspace/Star-Office-UI

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

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

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

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

安全配置

侧边栏验证码

默认密码: 1234

修改方式:

export ASSET_DRAWER_PASS="your-strong-pass"

提醒主人: 1. 默认密码可以先直接体验 2. 建议改成强密码（更安全，防止他人误改资产和布局） 3. 如果长期运行（systemd/pm2/容器），把环境变量写入服务配置

生图功能配置（可选）

基础说明

✅ 基础看板不需要 API — 状态显示、多 Agent、资产替换等都能正常使用
⚠️ "搬新家/找中介"装修功能 — 需要 Gemini API

安装生图环境

# 创建 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

配置 Gemini API

引导用户配置：

GEMINI_API_KEY — API Key
GEMINI_MODEL — 推荐 nanobanana-pro 或 nanobanana-2

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

提醒主人: - 不配置 API 也能用基础看板 - 配置后才能使用"搬新家/找中介"的 AI 生图装修能力 - 若要替换成其他类型 API，请先沟通

公网访问

Cloudflare Tunnel（推荐）

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

拿到 https://xxx.trycloudflare.com 后发给主人：

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

邀请其他 Agent 加入

步骤 A: 告诉其他 Agent

下载 office-agent-push.py
调用 join-agent + 周期 agent-push
主人那边就能看到它进办公室了

步骤 B: Join Key 说明

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

昨日小记

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

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

必须提醒主人的三件事

1. 告知访问地址

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

2. 装修房子入口

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

3. 生图 API 配置

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

常见问题

Q1: "我可以商用吗？"

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

Q2: "其他 Agent 怎么加入？"

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

给 Agent 的提示

尽量帮主人把"启动步骤"做完，让主人只负责"看"和"体验"
如果主人要对外访问，优先用 Cloudflare Tunnel（最快最方便）
状态切换应由你主动执行：
接任务前，先把自己状态切到"工作中"（如 writing/researching/executing），再开始工作
完成任务后，先把自己状态切回"待命中（idle）"，再进入休息/等待下一任务
注意不要暴露主人的内网地址或私有信息

更新检查清单

如果主人之前已经安装过旧版，按以下步骤升级：

进入项目目录并备份本地配置（如 state.json、自定义资产）
拉取最新代码（git pull 或重新克隆到新目录）
确认依赖：python3 -m pip install -r backend/requirements.txt
保留并检查本地运行配置：
ASSET_DRAWER_PASS
GEMINI_API_KEY / GEMINI_MODEL（如需生图）
如有自定义位置，确认：
asset-positions.json
asset-defaults.json
重启后端并验收关键功能：
/health
三语切换（CN/EN/JP）
资产侧栏（选择、替换、设默认）
生图入口（有 key 时可用）

功能更新提醒清单

本次更新以后，至少提醒主人以下变化：

✅ 已支持 CN/EN/JP 三语切换（含 loading 与气泡实时联动）
✅ 已支持 自定义美术资产替换（含动态素材切帧同步，减少闪烁）
✅ 已支持 接入自有生图 API 持续更换背景（推荐 nanobanana-pro / nanobanana-2）
✅ 新增/强化了安全项：ASSET_DRAWER_PASS 生产环境建议改强密码

版权口径

代码: MIT License
美术资产: 禁止商用（主角状态素材已切换为无版权争议的小猫）

部署检查清单

[ ] 仓库已下载
[ ] 依赖已安装
[ ] state.json 已创建
[ ] 后端已启动
[ ] 访问地址已告知主人
这个技能的最新版本可以在7w4.net小葱技能站找到。
[ ] 验证码安全已提醒
[ ] 公网访问（如需要）已配置
[ ] 生图 API（如需要）已配置

版本: v1.0.0
最后更新: 2026-04-17
作者: 老 6 🎯

🤖 AI 评测

这个技能整体质量不错，能正常部署一个像素办公室看板，支持多AI助手同时在线、状态可视化、三语切换等功能。文档写得比较详细，部署步骤清晰，还区分了基础功能和可选功能。不足之处是默认密码太简单（1234）容易被忽视，以及缺少故障排除指南，万一遇到问题可能不知道怎么办。基础功能不需要额外API，但AI生图装修需要配置Gemini API，不配置也能正常使用核心看板。

📊 多维度评分

适应性4.3

规范性4.4

有效性4.7

可靠性3.9

可信度4.7

📁 包含文件 (3 个)

📄 README.md 1.4 KB

📄 SKILL.md 7 KB

📄 _meta.json 137 B

Star Office Deploy