zheng
3221856d50
不是翻译 —— 多数文档描述的行为已经不存在了。 先修一个更基本的问题：我们不拥有 u-claw.org 域名，那是上游的。所以之前写在 README、诊断包提示、联系方式里的 help@u-claw.org 全都会把用户的问题发给 上游 —— 一个没有理由回复的人。改为指向我们自己的 issue tracker，并加断言 禁止再出现指向该域名的支持入口。 重写（内容过时，不是语言问题）： - install/README.md —— 还写着 10 个中国技能、DeepSeek 优先、国内镜像。 现在按实际流程写：技能读 manifest、模型菜单 Gemini 优先、bundle 有 SHA256 校验。并如实写明 curl|bash 在受管企业电脑上会被 EDR 拦。 - CLAUDE.md 的模型配置整节 —— 还在描述虾盘云首选卡片和 12 个 provider， 那个界面已经换成单框 Key 输入了。 - SECURITY.md —— 安全报告原本指向上游维护者个人邮箱。fork 之后那条路由 是错的：漏洞会发给写不了这份代码、也修不了的人。 - CONTRIBUTING.md —— 补上 fork 关系、pre-push 钩子怎么装、以及 `node --test tests/` 为什么不能用。 翻译并保留： - bootable/README.md、TROUBLESHOOTING.md —— 面向用户，顺带把 「国内镜像」「小米/华为 BIOS 按键」等换成目标市场的实际情况 HANDOFF.md 重写为一份事故复盘：原文一半是过时的一次性交接笔记（引用的 website/guide.html 已不在本仓库），另一半是 persistence.dat 未格式化导致 启动失败的排查记录 —— 后者有长期价值，尤其是「读 offset 1080 的两字节 验证 ext4」这个判断方法，已同时写进 bootable/README.md。 bootable/IMPROVEMENTS_SUMMARY.md 保留中文，加了说明：它是上游 fork 前的 历史改进记录，没人引用，描述的是已完成的工作而非当前行为。翻译它反而会 让人误以为是现行文档。 新增 skills/en/uclaw-help —— 把「怎么用、东西在哪、出问题怎么办」做成 内置知识，每个角色都装。方案 C10.8：能问的产品才是不需要学的产品。
advanced/
Everything here used to sit in the drive's root folder. Twenty-three clickable files greeted anyone who plugged the drive in, and the first thing a non-technical user had to do was work out which of them applied to their computer — before anything had even run.
The root now holds three things: the two START HERE files and a short guide.
Everything else lives here.
| File | What it is |
|---|---|
Windows-Menu.bat · Mac-Menu.command |
Menu of every tool below |
Windows-Diagnose.bat · Mac-Diagnose.command |
Health check, collects logs for a bug report |
OpenClaw-Doctor.bat · Mac-OpenClaw-Doctor.command |
Read-only diagnosis from OpenClaw itself |
OpenClaw-CLI.bat · Mac-OpenClaw-CLI.command |
Drop into the raw openclaw CLI |
Windows-Install.bat · Mac-Install.command |
Copy the drive's contents onto this computer |
Windows-IntranetFix.bat · Mac-IntranetFix.command |
Fix a corporate proxy blocking your model endpoint |
Windows-LocalModel.bat · Mac-LocalModel.command |
Set up an offline local model |
setup.sh · setup.bat · setup.ps1 |
Developer build: fetch Node.js + OpenClaw into ../app/ |
Config.html |
Redirect to Settings, kept for older links |
U-Claw.html · SkillHub.html |
Reference pages |
If you move a script out of here
They all resolve the drive root as "one level up" from wherever they sit. Running
one from somewhere else will not find app/ or data/.
Naming
The entry points are START HERE - Windows.bat and START HERE - Mac.command,
with a hyphen rather than brackets. cmd.exe treats ) as the end of an
IF (...) block, so a filename containing brackets breaks every echo that
mentions it inside a block — which is the flash-exit class of bug that
tests/windows-launchers.test.mjs guards against. The hyphen avoids it entirely.