- Replace $INSTALL_NPM (npm.cmd) with $NPM_CLI (npm-cli.js) + $INSTALL_NODE
- Use --prefix instead of Push-Location to avoid CWD issues in irm|iex pipe
- Restore PATH for downloaded Node (npm-cli.js internally needs node in PATH)
- Use [IO.File]::WriteAllText with BOM-free UTF8 for package.json/config/skills
- Add debug output before npm install for easier troubleshooting
On Windows, npm.cmd is a batch wrapper, not a JS file. Calling
`node.exe npm.cmd install` causes loader errors. Fix:
- Add downloaded Node dir to PATH so npm.cmd can find node.exe
- Call `npm.cmd install` directly instead of `node.exe npm.cmd install`
- Add error handling for OpenClaw install failure
The bootable USB works on ANY x86 PC (Windows desktops, Mac Intel,
bare metal), not just Linux machines. Old name was misleading —
users thought it was a Linux-only feature.
New install/ module for network-based installation without USB:
- install.sh: Mac/Linux 7-step installer (Node.js + OpenClaw + QQ plugin + 10 CN skills + interactive model config + launcher)
- install.ps1: Windows PowerShell equivalent
- All downloads via npmmirror.com China mirrors
- 10 AI model choices with Chinese interactive menu (default DeepSeek)
- Scripts copied to website/ for Vercel hosting at u-claw.org/install.sh
Updated guide.html with dedicated "一键在线安装" page section and quickstart integration.
- Add bootable/ as third distribution form
- Add bootable Linux USB build commands (4-step PowerShell)
- Add bootable/ to architecture diagram with key details
- Add Bootable Linux Key Details section (persistence, mirrors, env vars)
- Note bootable/ independence and u-claw-linux repo sync requirement
Document the gotcha: unformatted persistence.dat causes Ventoy mount
failure and Ubuntu dropping to initramfs. Added verification method
(ext4 magic number at offset 1080) and troubleshooting entry.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Previously, when no standard WSL distro was available, Method B only created
an empty sparse file without ext4 formatting. This caused Ventoy to fail
mounting persistence.dat on boot, dropping to initramfs.
Now Method B tries docker-desktop WSL (/sbin/mkfs.ext4) before falling back
to raw file. Also added ext4 magic number (0xEF53) verification step.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Complete first-time setup guide (6 steps, all verified on live USB)
- Official install + China mirror install options
- Correct gateway command: `openclaw gateway run --bind lan` (not `start`)
- Use `openclaw dashboard` to open console with auth token
- Fix OpenClaw commands section with tested commands
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Covers OpenClaw ops, system info, network, files, processes, SSH,
apt, disk, user management, and rescue commands. All with one-click
copy buttons for easy use on Linux without Claude Code.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Complete step-by-step instructions for enabling SSH on Ubuntu Live USB,
including manual method (3 commands), connecting from another computer,
Claude Code integration tips, and Tailscale for remote access.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Simple one-page guide at u-claw.org/ssh.html with copy-paste commands
for enabling SSH on Ubuntu Live USB.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Add copy-paste command reference card to guide.html Linux section
- Add enable-ssh.sh standalone script for remote access on Live USB
- Add optional SSH install prompt to setup-openclaw.sh
- Add HANDOFF.md for Mac mini Claude Code remote takeover
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Update all 24.04.2 references to 24.04.4 (ISO name, URLs, SHA256, docs)
- Add format-persistence.sh to bootable/linux-setup/ (from working E: drive)
- Rewrite website guide.html Linux tutorial: Linux Mint + Rufus → Ventoy + Ubuntu
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Windows-Start.bat:
- Fix duplicate browser tab opening (was opening 3 tabs)
- Read gateway token from config instead of hardcoding
- Add config sync from legacy location
- Use delayed browser open for gateway startup time
Windows-Menu.bat:
- Fix Node version display bug (double %% issue)
- System info: add Windows version, architecture, memory, disk size
- Check updates: auto-fetch latest version from npmmirror, one-click upgrade
- Disk cleanup: show directory sizes, clean old backups/logs/npm cache
- Log management: add export to desktop, clean logs older than 7 days
- Restore backup: numbered list selection instead of typing folder name
- Kill processes: add confirmation prompt before killing
- Chat platforms: individual setup guidance per platform
Windows-Install.bat:
- Add Node.js online download fallback (was exit-only when missing)
- Add system Node.js version check (require v20+)
- Generated start.bat now has port detection loop
- Show install size on completion
Windows-Diagnose.bat:
- Add system info logging (Windows version, architecture)
- Add config file and model configuration check
- Expand port scan to full 18789-18799 range
- Show OpenClaw version in test output
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add bilingual "Looking for Partners" section in README (Chinese + English)
and a new "合作招募" page in guide.html sidebar, plus a recruitment card
in the existing "联系我们" contact page.
Add bootable/ directory with complete toolkit to create a bootable
Ubuntu USB drive with OpenClaw AI:
- 4-step PowerShell scripts for USB preparation on Windows
- Ventoy 1.0.99 boot manager with casper-rw persistence
- Self-contained Linux setup and startup scripts
- Detailed README with architecture, usage guide, and troubleshooting
bootable/ is fully independent - does not reference any files from
portable/, u-claw-app/, or website/. Also maintained as standalone
repo at u-claw-linux for convenience.
Update main README to reference both bootable/ and u-claw-linux repo.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add links to u-claw-linux repo in README (both CN and EN sections)
- Add Linux x64 to platform support table
- Update CLAUDE.md platform status
- Move bootable/ to .gitignore (now independent repo)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Mac-Menu, Mac-Diagnose, and Windows-Diagnose were missing the
core-mac/core-win → core migration shim, causing them to fail
on existing USB drives that still have the old directory name.
Keep Linux live USB page as reference tutorial.
Remove Linux script names, directory entries, and install steps
from all other pages (quickstart, USB run, install, maintain, FAQ).
- Delete usb-scripts/, Linux-*.sh, setup-linux-usb.sh, migrate.js
- Rename core-mac/core-win → core (with migration shims for existing USBs)
- Fix Mac-Menu.command ARM64 hardcode — now detects Intel/Apple Silicon
- setup.sh: remove Linux branch, Windows download only with --all-platforms
- Update README.md and CLAUDE.md to reflect Mac + Windows only
Replaces the problematic file:// protocol Config.html with a stable
Node.js HTTP server following industry standard patterns (n8n, Langflow).
Changes:
- Add portable/config-server/ with REST API (GET/POST /api/config)
- Add simplified Chinese/English web UI for AI model and QQ Bot config
- Update Windows-Start.bat to launch both services simultaneously
- Config Center on port 18788
- OpenClaw Gateway on port 18789
- Remove Config.html file:// protocol issues
- Use zero-dependency pure Node.js standard library
Benefits:
- No file:// CORS or WebSocket issues
- Industry-standard localhost HTTP pattern
- Simplified configuration interface for Chinese users
- Unified startup experience
🤖 Generated with Claude Code
- Windows-Start.bat: Always open dashboard instead of Config.html
The dashboard can guide first-time setup, avoiding file:// protocol issues
- Windows-Diagnose.bat: Add Chinese output for better user experience
Error counting and friendly suggestions included
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major fixes for Windows portable version:
1. **Fixed critical bugs:**
- Replace Unix /dev/null with Windows nul in all .bat files
- Unified config path to data/.openclaw/openclaw.json
- Fixed cross-platform node_modules compatibility issue
2. **Implemented separated core directories:**
- app/core-mac/ for Mac dependencies
- app/core-win/ for Windows dependencies
- Prevents cross-platform file system conflicts
- Shared data/ directory for configs and memory
3. **Enhanced setup.sh:**
- Now downloads both Mac and Windows Node.js runtimes
- Ensures U-Claw works on both platforms after setup
4. **Added diagnostic tools:**
- Windows-Diagnose.bat for troubleshooting
- Mac-Diagnose.command for troubleshooting
- Auto-generates diagnostic-log.txt
5. **Improved user experience:**
- Added Welcome.html - Simple 3-step guide in Chinese
- All scripts updated to use platform-specific core directories
- Better error messages and user guidance
Files modified:
- portable/Windows-Start.bat: Use core-win, fix syntax
- portable/Windows-Menu.bat: Use core-win, fix syntax
- portable/Mac-Start.command: Use core-mac
- portable/Mac-Menu.command: Use core-mac
- portable/setup.sh: Download both platforms, use core-mac
Files added:
- portable/Windows-Diagnose.bat: Diagnostic tool
- portable/Mac-Diagnose.command: Diagnostic tool
- portable/Welcome.html: User-friendly welcome page
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Skills (40KB total, in portable/skills-cn/):
- deepseek-helper: DeepSeek API usage and model selection
- china-weather: Chinese city weather via wttr.in
- xiaohongshu-writer: 小红书爆款笔记写作
- wechat-article: 微信公众号文章写作
- douyin-script: 抖音/快手短视频脚本
- bilibili-helper: B站内容优化
- china-search: 百度/搜狗/Bing国内搜索
- zhihu-writer: 知乎回答写作
- weibo-poster: 微博内容创作
- china-translate: 中英互译+本地化
setup.sh auto-copies skills-cn/ into OpenClaw skills directory.
No external dependency on ClawHub for these skills.
- build-usb.sh: one-click USB drive builder (downloads Node.js + OpenClaw
from China mirrors, packages into USB-ready directory)
- Mac-Install.command: install from USB to Mac (~/.uclaw/), offline-first
with China mirror fallback
- Windows-Install.bat: same for Windows
- README.md rewritten to position project as "USB drive builder toolkit"
- Add "开发者搭建指南" page with full clone-to-run instructions
- Add "国内镜像源" page with npm/Node.js/Electron/Git mirrors
- Update quickstart to show 3 ways: USB, desktop app, developer build
- Update USB run page with actual file names (Mac-Start.command etc)
- Update install-pc page with setup.sh one-click workflow
- Add portable vs desktop comparison table
- setup.sh: auto-downloads Node.js + npm deps + runtime from China mirrors
- setup.bat: same for Windows, guides to install Node.js if missing
- Both set Electron mirror to npmmirror.com for China users
- Updated README with new setup instructions
- openclaw.mjs is at node_modules/openclaw/openclaw.mjs, not core root
- Remove npm run build (openclaw doesn't need a build step via npm)
- Fix both Mac-Start.command and Mac-Menu.command
- CLAUDE.md: architecture, dev setup, branding rules for AI agents
- llms.txt: update version to 2.0, fix platform support, add developer
quick start, env vars, config format, correct script names
- Replace all openclaw-cn commands with openclaw (official)
- Remove OpenClaw-CN community fork links (jiulingyun)
- Remove clawd.org.cn, skillhub.tencent.com references
- Remove clawdbot-ai/awesome-openclaw-skills-zh links
- Update guide.html, llms.txt, skills.html, SkillHub.html, tutorial
- All links now point to U-Claw (u-claw.org) or OpenClaw official
