From da5b86981f97b1443dd5e8040266ec413c890b12 Mon Sep 17 00:00:00 2001
From: "Anqi (Anthony) Tang"
Date: Fri, 27 Mar 2026 23:24:49 +0800
Subject: [PATCH 1/9] remove: delete obsolete docs
Troubleshooting and checklist docs are no longer needed.
---
...mount_permission_troubleshooting_prompt.md | 44 -----------
.../windows-installer-regression-checklist.md | 73 -------------------
2 files changed, 117 deletions(-)
delete mode 100644 docs/cowork_mount_permission_troubleshooting_prompt.md
delete mode 100644 docs/windows-installer-regression-checklist.md
diff --git a/docs/cowork_mount_permission_troubleshooting_prompt.md b/docs/cowork_mount_permission_troubleshooting_prompt.md
deleted file mode 100644
index f1b0d652..00000000
--- a/docs/cowork_mount_permission_troubleshooting_prompt.md
+++ /dev/null
@@ -1,44 +0,0 @@
-# Cowork 目录权限异常排障提示词(复用模板)
-
-你是本项目的排障助手,请按“先复现、再定位、后修复、最后验证”的顺序,排查 `cowork` 模式下目录写权限异常问题。
-
-## 背景
-- 项目:`openagent`
-- 典型场景:用户在 `cowork` 模式选择 Windows 工作目录后,第一次创建目录成功;继续进入该目录再创建子目录失败,报 `Permission denied`。
-- 目标:确认是挂载状态丢失/误清理导致,还是用户目录本身无权限,并给出可验证修复。
-
-## 重点怀疑点(优先检查)
-1. WSL session 挂载点是否真实挂载(不是空目录占位)。
-2. `PATCH /api/sessions/{id}` 同路径重挂载时,是否发生“恢复后又被清理”的逻辑回归。
-3. `mount_working_dir()` 的同路径分支是否错误执行了旧挂载点清理。
-
-## 执行步骤
-1. 检查后端健康:`GET /health` 必须 `ok`。
-2. 创建 cowork warm session(带 `working_dir`)。
-3. 在 session 用户下执行两级目录创建,确认首次成功。
-4. 人为卸载该 session 的挂载点(模拟异常),复现 `Permission denied`。
-5. 调用 `PATCH /api/sessions/{id}` 传入同 `working_dir` 触发自愈。
-6. 用 `findmnt` 校验挂载是否恢复,再次执行两级目录创建。
-7. 给出结论:恢复成功/失败,并附关键证据(命令输出与日志片段)。
-
-## 关键判定标准
-- **异常态**:挂载点权限显示 `drwxr-xr-x root root` 且 `findmnt` 无结果,session 用户写入失败。
-- **恢复态**:`findmnt` 命中目标路径,目录权限回到可写(常见 `drwxrwxrwx`),session 用户可连续创建父/子目录。
-
-## 本次问题已验证的根因线索
-- 同路径自愈重挂载后,末尾“清理旧挂载点”逻辑可能把当前刚恢复的挂载再次 `umount/rmdir`,导致后续二级目录创建失败。
-- 修复方向:仅在“切换到不同 target”时清理旧挂载点;同 target 自愈时禁止清理当前挂载路径。
-
-## 修复后回归要求
-1. 正常路径:首次创建目录成功。
-2. 异常注入:强制卸载后创建失败(证明复现有效)。
-3. 自愈路径:`PATCH` 后挂载恢复成功。
-4. 结果验证:恢复后再次创建父/子目录成功。
-5. 前端体验:挂载进行中显示明显 loading,不是仅按钮置灰。
-
-## 输出格式要求(给排障者)
-- 先给“结论一句话”。
-- 再给“证据三条”(健康、挂载、写入结果)。
-- 再给“修复点与文件路径”。
-- 最后给“可复用命令清单”。
-
diff --git a/docs/windows-installer-regression-checklist.md b/docs/windows-installer-regression-checklist.md
deleted file mode 100644
index c72c92a2..00000000
--- a/docs/windows-installer-regression-checklist.md
+++ /dev/null
@@ -1,73 +0,0 @@
-# Windows Installer Regression Checklist (No-WSL Machine)
-
-## 0. Test Environment
-- Fresh Windows 10/11 x64 machine (no OpenAgent, no WSL distro).
-- Verify:
- - `wsl --status` shows not installed or unavailable.
- - `wsl -l -v` has no `openagent` distro.
-
-## 1. Install App
-- Run `OpenAgent-0.0.1-win-x64.exe`.
-- Open OpenAgent -> Settings -> Sandbox.
-- Expected:
- - App launches normally.
- - No crash on Sandbox page.
-
-## 2. Assisted WSL Install (First-time)
-- Click VM setup / Retry on `VM Engine`.
-- Expected:
- - If WSL missing: clear guided message appears.
- - App attempts assisted install (with clear status text).
- - If system needs reboot, UI explicitly asks reboot.
-
-## 3. Reboot Required Path
-- If prompted, reboot Windows.
-- Re-open OpenAgent -> Sandbox.
-- Click Retry again.
-- Expected:
- - `VM Instance` eventually becomes `Ready`.
- - No `exit 4294967295` generic toast without guidance.
-
-## 4. VM Dependencies Install
-- Click install for `VM System Dependencies`.
-- Expected:
- - Progress steps update continuously.
- - Failure (if any) includes actionable reason.
- - Success ends with green/ready state.
-
-## 5. Cowork Functional Smoke Test
-- Set cowork folder to a writable path, e.g. `D:\code\agentTest`.
-- In chat:
- - Create folder `sport`.
- - Then create `sport\basketball`.
-- Expected:
- - Both operations succeed.
- - No false "current directory not writable" error.
-
-## 6. Non-Technical User UX Check
-- Trigger BIOS/virtualization-disabled scenario (or validate copy via mocked error).
-- Expected:
- - Error includes clear next steps:
- - Enable virtualization in BIOS (Intel VT-x / AMD SVM).
- - Save BIOS and reboot.
- - Retry in app.
- - Language is understandable for non-technical users.
-
-## 7. Log Collection (On Failure)
-- Collect:
- - OpenAgent backend logs.
- - Sandbox setup UI log panel output.
- - `wsl --status`
- - `wsl -l -v`
-- Record exact toast error text and timestamp.
-
-## 8. Release Gate (Pass Criteria)
-- Must pass:
- - App install + launch.
- - WSL guided install path.
- - Reboot path.
- - VM Instance ready.
- - VM dependencies ready.
- - Cowork nested directory creation.
-- Block release if any of above fails.
-
From 82b81e6efd3e0075bfab973821d945afb658d9ce Mon Sep 17 00:00:00 2001
From: "Anqi (Anthony) Tang"
Date: Fri, 27 Mar 2026 23:26:52 +0800
Subject: [PATCH 2/9] feat(ui): rebrand HexAgent to ClawWork in all user-facing
text
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Rename the display brand name across the frontend UI — page title,
sidebar, welcome screens, onboarding wizard, and Electron error dialog.
Internal package names, storage keys, and code identifiers unchanged.
---
libs/hexagent_demo/electron/main.js | 2 +-
libs/hexagent_demo/frontend/index.html | 2 +-
.../frontend/src/components/OnboardingWizard.tsx | 14 +++++++-------
.../frontend/src/components/Sidebar.tsx | 2 +-
.../frontend/src/components/WelcomeScreen.tsx | 4 ++--
5 files changed, 12 insertions(+), 12 deletions(-)
diff --git a/libs/hexagent_demo/electron/main.js b/libs/hexagent_demo/electron/main.js
index b65a9061..f7a5cf5e 100644
--- a/libs/hexagent_demo/electron/main.js
+++ b/libs/hexagent_demo/electron/main.js
@@ -454,7 +454,7 @@ app.whenReady().then(async () => {
} catch (err) {
console.error("Failed to start backend:", err);
dialog.showErrorBox(
- "HexAgent - Failed to Start",
+ "ClawWork - Failed to Start",
`The backend server could not be started.\n\n${err.message}`
);
app.quit();
diff --git a/libs/hexagent_demo/frontend/index.html b/libs/hexagent_demo/frontend/index.html
index 6b14c1ce..82bb44df 100644
--- a/libs/hexagent_demo/frontend/index.html
+++ b/libs/hexagent_demo/frontend/index.html
@@ -4,7 +4,7 @@
- HexAgent
+ ClawWork
diff --git a/libs/hexagent_demo/frontend/src/components/OnboardingWizard.tsx b/libs/hexagent_demo/frontend/src/components/OnboardingWizard.tsx
index e7aeebd8..3fe832f0 100644
--- a/libs/hexagent_demo/frontend/src/components/OnboardingWizard.tsx
+++ b/libs/hexagent_demo/frontend/src/components/OnboardingWizard.tsx
@@ -345,13 +345,13 @@ export default function OnboardingWizard({ open, onComplete, settings, onSetting
-
HexAgent
+
ClawWork
-
Powered by HexAgent harness
+
Powered by ClawWork harness
-
+
Compute environments
- HexAgent uses sandboxed environments to run code safely. E2B is required for Chat mode.
+ ClawWork uses sandboxed environments to run code safely. E2B is required for Chat mode.
- System dependencies install in the background — you can continue using HexAgent while it runs.
+ System dependencies install in the background — you can continue using ClawWork while it runs.
)}
@@ -1054,7 +1054,7 @@ export default function OnboardingWizard({ open, onComplete, settings, onSetting
to tools like Python, Node.js, LaTeX, LibreOffice, and more.
- The installation runs in the background — you can start using HexAgent immediately.
+ The installation runs in the background — you can start using ClawWork immediately.