简而言之Star-Office-UI 就是给 OpenClaw龙虾配的一间像素办公室。平时我们看 Agent 在干嘛多半只能盯着日志滚动而它把这些看不见的状态变成了办公室里角色的位置、动作和气泡提示。打开网页就能一眼看到谁在忙、谁在待命、昨天大概做了什么。适用场景你想把 Agent 的运行状态从黑盒日志变成一个直观的可视化看板你有多个 Agent需要一个能展示协作状态的窗口录屏、演示、直播都很友好你希望手机上也能随手看一眼当前状态你偶尔需要把一个可访问链接发给别人体验可选开公网核心功能功能说明状态可视化Agent 状态变化会驱动角色移动到办公室不同区域并用气泡显示当前在做什么多 Agent 加入支持访客列表和 join key 机制让多个 Agent 同时出现在同一间办公室里昨日小记可以把最近可用的工作记录展示出来可做基础脱敏方便快速回顾移动端适配手机浏览体验也不错适合当常驻看板公网访问可选需要分享时可以用 Cloudflare Tunnel 临时开个外网地址资产与布局自定义进阶可以替换美术资产、调整布局让办公室更像你自己的生图装修可选接入 Gemini API 后可以玩装修房间等能力基础看板不依赖 API效果预览更推荐先本地跑通再考虑对外分享运行环境项目配置系统WindowsPythonPython 3环境管理venv运行方式本地运行暂不计划公网访问安装与运行整体就两条路手动部署你在本机照着命令一步步跑起来让龙虾自动部署OpenClaw Skill你只发一句话剩下的让龙虾自己搞定方式一手动部署自行安装1. 下载代码若网络环境有问题可通过网盘下载gitclone https://github.com/ringhyacinth/Star-Office-UI.gitcdStar-Office-UI2. 安装依赖python3-mpipinstall-rbackend/requirements.txt3. 初始化状态文件首次运行必做cpstate.sample.json state.json4. 启动后端cdbackend python3 app.py5. 打开页面访问http://127.0.0.1:190006. 快速验证手动切换几次状态感受一下在项目根目录执行python3 set_state.py writing正在整理文档python3 set_state.py syncing同步进度中python3 set_state.py error发现问题排查中python3 set_state.py idle待命中7. 公网访问可选如果你需要给别人体验跑一个临时外网地址就行cloudflared tunnel--urlhttp://127.0.0.1:19000拿到https://xxx.trycloudflare.com后即可分享。8. 安全配置建议侧边栏默认验证码为1234如果要公网或长期使用建议改成强密码exportASSET_DRAWER_PASSyour-strong-pass若长期运行systemd / pm2 / 容器把环境变量写进服务配置里9. 验证安装可选python3 scripts/smoke_test.py --base-url http://127.0.0.1:19000所有检查显示OK就说明跑通了。方式二让龙虾安装更推荐给 OpenClaw 用户如果你已经在用 OpenClaw这个方式最省事你只要发一句话clone、装依赖、启动、状态同步等都由龙虾自动完成。把下面这句话发给你的龙虾请按照这个 SKILL.md 帮我完成 Star Office UI 的部署 https://github.com/ringhyacinth/Star-Office-UI/blob/master/SKILL.md然后等龙虾回传访问地址通常是本机地址http://127.0.0.1:19000如果龙虾顺带配了对外访问也可能会给你一个公网链接验收建议让龙虾切换几次状态确认角色会移动并显示气泡任务结束后切回idle看板会一直很清爽OpenClaw 深度集成状态自动同步规则如果你希望龙虾做事时自动切状态可以在SOUL.md或 Agent 规则文件里加一段约定让 Agent 自己维护状态## Star Office 状态同步规则 - 接到任务时先执行 python3 set_state.py 状态 描述 再开始工作 - 完成任务后执行 python3 set_state.py idle 待命中 再回复状态与区域映射常用状态区域说明idle休息区待命 / 完成任务writing工作区写代码 / 写文档researching工作区搜索 / 调研executing工作区执行命令 / 跑任务syncing工作区同步 / 推送errorBug 区报错 / 排查邀请其他 Agent 加入办公室可选1. Join Key服务会根据join-keys.sample.json生成运行时join-keys.json若不存在。每个 key 默认支持最多 3 人同时在线可自行调整。2. 访客运行推送脚本访客下载office-agent-push.py配置并运行JOIN_KEYocj_starteam02AGENT_NAME访客龙虾OFFICE_URLhttps://office.hyacinth.im然后执行python3 office-agent-push.py资源获取地址资源链接项目地址GitHubhttps://github.com/ringhyacinth/Star-Office-UI源码网盘夸克https://pan.quark.cn/s/638192798d99附录OpenClaw 部署教程网盘资源教程资源夸克https://pan.quark.cn/s/27bc36f9c4a8这份教程更像一条从建立认知到跑通闭环的入门路线先帮你读懂 OpenClaw 的文档体系和模块边界再带你按主线把本地运行跑通最后补齐生产里最常用的配置模型、消息平台、技能、记忆等。如果后续想往多 Agent 协作、Docker 部署和安全配置走也有对应内容和常见问题排查。