v2026.4.10

v2026.4.10

✨ New Features

• Gateway Service Management — New "Service Management" panel in Settings page for managing Gateway lifecycle (start/stop/restart/install) directly from the UI
• Real-time Log Viewer — New log viewer section in Settings with auto-scroll, pause/resume, and log level highlighting
• System Service Installation — Register OpenClaw Office as a system service for auto-start on boot/login (macOS launchd + Linux systemd)
• Platform Service — Lightweight local HTTP server (bin/platform.js) exposing REST APIs for Gateway lifecycle control

🔧 Improvements

• Office sidebar now defaults to expanded with metrics panel visible
• Cost pie chart sizing increased (160px → 180px) for better readability
• Metrics section minimum height raised (120px → 280px) to prevent content clipping
• Removed "Uninstall Service" button from frontend UI to prevent accidental removal (CLI still available)
• Fixed macOS service restart command not properly restarting (setTimeout race condition)
• Added system service installation & background mode documentation to README (zh/en)

🐛 Bug Fixes (since v2026.4.8)

• Filter out models from providers without configured API keys
• Handle all Gateway agent stream types, prevent unknown stream flooding logs
• Security: auto-apply dangerouslyDisableDeviceAuth on first WebSocket connect

📦 Install / Upgrade

npm install -g @ww-ai-lab/openclaw-office
# or run directly
npx @ww-ai-lab/openclaw-office@2026.4.10

🖥️ Run as System Service (New!)

openclaw-office service install
openclaw-office service status

Full Changelog: v2026.4.8...v2026.4.10

v2026.4.8 - 事件时间轴流类型完整支持

🐛 Bug 修复

事件时间轴「未知流」刷屏问题彻底修复

根因分析：OpenClaw Gateway 除了基础的 lifecycle/tool/assistant/error 外，还会发送多种结构化追踪事件流。前端之前仅处理了基础的4种，其余所有类型都落入 default 分支显示「未知流: xxx」。

修复内容：

新增全部 Gateway 流类型支持

流类型	描述	修复版本
item	工具/命令执行的结构化追踪项（AgentItemEventData）	v2026.4.8
plan	代理计划/步骤更新	v2026.4.8
approval	Exec 命令审批请求/解决	v2026.4.8
patch	文件变更补丁摘要	v2026.4.8
thinking	模型推理思考 token	v2026.4.8
compaction	上下文窗口压缩事件	v2026.4.8
command_output	终端命令执行结果	v2026.4.7

item 流智能去重

• item 事件按 itemId 合并，同一工具任务只在时间轴显示一条记录（start → end 合并更新）
• 工具开始显示「开始: 工具名」，结束显示「完成: 工具名」或「失败: 工具名」

未来未知流容错

• 完全未知的新流类型静默忽略，不再产生「未知流: xxx」垃圾条目
• 空摘要事件不写入历史记录

EventTimeline 图标和标签完善

• 📋 item 任务项、📝 plan 计划、🔐 approval 审批
• ⌨ command_output 命令、📄 patch 文件变更、💭 thinking 思考、🗜 compaction 压缩

🎨 UI 优化

聊天界面

• 修复亮色模式下代码块背景色显示问题（灰色文字配深色背景 → 深色文字配浅色背景）
• 修复 Gateway 历史记录中工具调用消息的重建逻辑：正确将 embedded toolCalls 展开为独立工具消息
• 优化历史缓存策略：当缓存中存在富工具消息时不被 Gateway 平铺历史覆盖

📦 技术细节

• AgentStream 类型新增所有已知 Gateway 流类型
• EventHistoryItem 新增 itemId? 字段用于 item 事件去重
• 溯源自 OpenClaw 主仓库 src/infra/agent-events.ts 确认完整流类型列表
• 所有 428 项单元测试通过

v2026.3.27

OpenClaw Office v2026.3.27

新增功能

• Chat 聊天历史持久化 — 服务端按天分片缓存聊天记录（~/.openclaw/office-cache/chat/），跨浏览器/设备/刷新稳定可见
• Chat 工具调用内嵌展示 — 对话流中嵌入 Agent 工具调用状态（调用中/已完成），可折叠查看详情
• 任意文件附件 — Chat 支持图片及任意类型文件附件

优化

• Chat 历史加载策略优化：启动时优先从服务端缓存加载，异步拉取 Gateway 最新记录
• 按天分片存储避免单文件过大导致加载异常
• 消息标记来源 Agent，支持多 Agent 场景下的历史回溯

文档

• README 改为中文主版本，英文版移至 README.en.md
• 移除 3D 场景描述和演示视频链接
• 增加 Chat 对话工作区的完整功能说明

安装

npx @ww-ai-lab/openclaw-office
# 或全局安装
npm install -g @ww-ai-lab/openclaw-office

v2026.3.25-beta.2 — 全新聊天工作区 · 移除 3D · 支持任意附件

v2026.3.25-beta.2

⚠️ Beta 版本 — 此版本包含重大功能变更，建议测试环境使用。

---

🐛 此版本 Bug 修复（相对 beta.1）

修复聊天界面只能发送图片的致命 Bug

• 问题：聊天输入框的附件按钮（回形针）使用了 accept="image/*" 限制，导致用户只能选择图片文件
• 修复：移除文件类型限制，现在支持选择并发送任意类型的文件（文档、PDF、代码文件、压缩包等）
• 预览改善：非图片文件现在显示文件图标（文本类型显示 📄，其他类型显示 📁）+ 文件名，不再尝试用 <img> 渲染
• Gateway 传输：ws-adapter.ts 中 attachment type 改为根据 mimeType 动态判断（image/* 为 image，其余为 file），不再硬编码 "image"
• 涉及文件：ChatPage.tsx、ChatDockBar.tsx、ws-adapter.ts

---

🚀 本次大版本核心变更（v2026.3.23 → v2026.3.25）

1. 新增独立聊天工作区页面（/chat）

全新的 ChatPage 替代了原有的 ChatDialog 浮层，提供：

• 三栏式布局：左侧会话历史列表 + 中间消息区 + 底部输入框
• 会话管理：新建会话、切换会话、导出当前会话（Markdown 格式）
• 专注模式（Focus Mode）：隐藏侧边栏，居中最大化内容区域
• 消息固定（Pin）：支持将重要消息固定到顶栏快速跳转
• Slash 命令：/export、/clear、/help 等快捷命令
• 流式 Markdown 渲染：实时渲染 Agent 回复，含 GFM 表格/代码块支持
• 任意附件发送：支持上传任意类型文件随消息发送（本版本修复）
• 自动滚动控制：消息过多时显示「回到最新」按钮

2. 完整移除 3D 渲染模块

移除了全部 Three.js / React Three Fiber 相关代码，减少包体积和依赖复杂度：

• 删除 src/components/office-3d/ 整个目录（11 个组件）
• 删除 src/components/living-office/ 整个目录（感知引擎、HUD、2.5D 场景等）
• 删除 src/perception/ 感知引擎层（状态机、事件分类器、运动队列等）
• 删除 WebGL 检测工具 src/lib/webgl-detect.ts

保留二维 SVG 办公室平面图（office-2d/），这是当前主视图。

3. 兼容新版 OpenClaw Gateway（2026.3.23+）

• 修复 WebSocket 认证 scope：新增 operator.read 请求权限，兼容 Gateway 2026.3.23 接口变更
• 改善设备标识处理逻辑（Device Identity），提升连接稳定性
• 修复 SubAgent 过早从 2D 楼层图消失的问题
• 过滤 placeholder Agent，不在 UI 列表和渲染中显示
• 压制 WS 代理错误日志噪音

4. 聊天 i18n 术语统一

全局将 "对话" 统一改为 "聊天"，对应 Gateway 协议术语，中英文键值同步更新。

---

📦 安装

# 安装 beta 版本
npm install -g @ww-ai-lab/openclaw-office@beta

# 或指定版本
npm install -g @ww-ai-lab/openclaw-office@2026.3.25-beta.2

# 启动
openclaw-office

🔧 运行依赖

• Node.js >= 22
• OpenClaw Gateway >= 2026.3.23
• 需配置 OPENCLAW_GATEWAY_TOKEN 环境变量或 .env.local 文件

---

⚠️ 破坏性变更

• 移除 3D 视图：原 /living-office 3D 场景路由已删除
• 聊天入口变更：原底部浮动 ChatDockBar 调整为导航到 /chat 独立页面

v2026.3.23

OpenClaw Office v2026.3.23

Bug Fixes

• Gateway 2026.3.23 兼容性修复: 修复 missing scope: operator.read 错误
  • 连接时同时请求 operator.admin 和 operator.read scope
  • 保存 hello-ok 返回的 auth 信息（含已授予 scopes）
  • 从正确位置（auth.scopes）读取 Gateway 授予的 scopes

Maintenance

• 从 git 跟踪中移除 docs/ 和 openspec/ 目录

配置要求

使用 Gateway 2026.3.23+ 时，如果使用 dangerouslyDisableDeviceAuth 模式，需要额外设置：

openclaw config set gateway.controlUi.allowInsecureAuth true
openclaw gateway restart

Install

npm install -g @ww-ai-lab/openclaw-office@2026.3.23

v2026.3.21

v2026.3.21

Bug Fixes

• fix: filter placeholder agents from UI lists and 2D/3D rendering — Lounge zone placeholder agents (reserves for sub-agent spawn animation) were leaking into user-facing UI:

  • Sidebar agent list and sub-agent count now exclude placeholders
  • Chat AgentSelector no longer shows placeholder entries
  • 2D FloorPlan: lounge, meeting, walking, and corridor zones filter out placeholders
  • 3D Scene: agent characters and parent-child links exclude placeholders
  • Credit: minitaisama (PR #13 partial cherry-pick)

• fix: suppress ws proxy error in vite dev config — WebSocket proxy errors no longer crash the dev server when Gateway is unavailable

• fix: sub-agent retire state machine improvements — Prevent premature sub-agent disappearance from 2D floor plan; enforce minimum hotDesk stay before retirement walk-back

Maintenance

• Cost pie chart improvements — Better rendering for cost distribution visualization

Install / Upgrade

npm install -g @ww-ai-lab/openclaw-office@2026.3.21

Full Changelog: v2026.3.18...v2026.3.21

v2026.3.18

v2026.3.18

Bug Fixes

• Sub-Agent 2D 显示修复: 修复 sub-agent 在 2D 办公室中过早消失的问题
  • 修复快速结束的 sub-agent（lifecycle:end 在走路动画完成前到达）被直接移除，未完成 走入热工位 → 停留10秒 → 走回休息区 完整动画流程的问题
  • 修复 Gateway health 心跳事件触发 initAgents() 全量重置 agents Map，导致正在动画中的 sub-agent 被意外清除的问题。新增 syncMainAgents() 增量同步方法，仅更新/添加 main agent 而保留所有 sub-agent 运行时状态

Enhancements

• Gateway 设备身份处理: 增强 WebSocket 连接的设备身份认证处理逻辑
• Sub-Agent Poller 改进: 优化 sub-agent 轮询与 office store 的状态同步
• Usage Poller 增强: 改进用量轮询的稳定性
• i18n 更新: 更新中英文办公室场景翻译

Internal

• 新增 sub-agent 退场动画的完整单元测试覆盖
• 531 项测试全部通过

npm: npm install @ww-ai-lab/openclaw-office@2026.3.18

OpenClaw Office v2026.3.8-1

Highlights

• Added unified remote Gateway support through the local Node /gateway-ws proxy, so browser connections stay consistent for both local and hosted deployments.
• Added first-launch connection onboarding to choose Local Gateway or Remote Gateway, with automatic token extraction from full access links.
• Confirmed compatibility with hosted OpenClaw services including Aliyun and Tencent Cloud style gateway access links.

Included in this release

• Runtime proxy target switching for both dev and production Office Server modes.
• Remote gateway connection setup UI with local/remote mode persistence.
• Security hardening cleanup to avoid shipping sensitive test fixtures and real gateway examples in tracked files.
• Updated English and Chinese README documentation to highlight remote gateway onboarding and hosted deployment support.

v2026.3.7

Highlights

• Unified console configuration lifecycle so config changes now follow clear runtime, save, apply, and CLI-restart flows instead of forcing restarts through config.patch.
• Provider management now uses the native OpenClaw config save/apply capabilities, including hot-reload-compatible saves and explicit restart scheduling when needed.
• Agent tools and agent skills allowlist editing now save through the shared config lifecycle path rather than pseudo-restart behavior.
• Agent model updates now clear stale external channel sessions so new Feishu and other channel conversations rebuild against the latest model config.
• Added full agent management tabs for tools, skills, channels, and cron with editing support.
• Stabilized Gateway adapter initialization by removing the fragile dynamic ws-adapter import path and surfacing real initialization errors immediately.
• Added regression coverage for adapter initialization, provider lifecycle flows, restart messaging, and released-package validation.

OpenClaw Office v2026.3.6

What's New in v2026.3.6

Bug Fixes

• Fix crypto.randomUUID() compatibility — In non-secure contexts (HTTP pages) or older browsers/WebViews, crypto.randomUUID() is not available, causing WebSocket handshake to fail silently. Added a uuid() utility with crypto.getRandomValues() fallback to support all environments. (Closes #3)
• Dashboard connection guide — When Gateway is unreachable, the dashboard now shows a clear troubleshooting guide with step-by-step instructions instead of an infinite loading spinner.
• Speaking bubble SVG rendering — Fixed speech bubble being rendered inside the agent avatar SVG instead of as an HTML overlay.
• Chat session creation UX — Improved chat session initialization flow.
• Ghost agent prevention — Route agent events by sessionKey pattern to prevent ghost agents from appearing in the Desk Zone.

Features

• Enhanced sub-agent polling — Improved sub-agent lifecycle tracking and office store management for better real-time monitoring.
• ChatDialog & ChatDockBar improvements — Enhanced chat dialog with new features and UI refinements.

Quick Start

npx @ww-ai-lab/openclaw-office@2026.3.6

Or install globally:

npm install -g @ww-ai-lab/openclaw-office
openclaw-office

Full Changelog: v2026.3.4...v2026.3.6