🐛 Bug Fixes

Issue #56 - 修复端口检测逻辑错误

修复内容:

• start.bat: 修复 PORT_CONFLICT 条件反转 (0→1)
• start.bat: 修复 errorlevel 检查逻辑错误 (≥0 → not errorlevel 1)
• start.sh: 修复 LLM_BUNDLED_READY 变量提前引用
• start.sh: 添加 LLM 服务启动后端口验证

影响:

• 🔴 Critical: 修复端口正常时被要求确认，有冲突时反而静默通过的严重逻辑错误
• 🟠 High: 修复 LLM 端口永远不会被检测的问题
• 🟠 High: 修复端口检测误报问题

📥 下载文件:

• OpenClaw-Portable-v6.0.2-windows-offline.tar.gz (约 1.2 GB) - 离线版
• OpenClaw-Portable-v6.0.2-windows-online.tar.gz (约 300 MB) - 在线版

📦 v6.0.1 - Bug Fixes & Enhancements

Fixed

• Issue #52 - 禁用本地模型的 tools 参数
  • llama.cpp/Ollama 不支持 OpenAI function calling
  • 添加 capabilities: { tools: false } 到 bundled-local 配置
  • 避免 "500 Unsupported param: tools" 错误

Added

• Issue #43 - 权限和端口检测 + 清理脚本
  • 管理员权限检测（Windows）
  • 端口冲突检测（Gateway + LLM）
  • 敏感文件清理脚本（cleanup.sh / cleanup.bat）
  • 轻度清理：日志、PID 文件
  • 深度清理：配置、令牌、备份

Changed

• 改善错误提示信息
• 增强用户体验

⚠️ 已知问题：此 Release 的 Assets 文件名包含 v6.0.0，但内容是 v6.0.1。请在下载后验证版本号。

📥 下载文件：

• OpenClaw-Portable-v6.0.0-windows-offline.tar.gz (159 MB) - 离线版
• OpenClaw-Portable-v6.0.0-windows-online.tar.gz (159 MB) - 在线版

🎉 OpenClaw Portable v6.0.0 - 内置本地模型支持

发布日期： 2026-03-15
类型： 里程碑版本
新功能： ✅ 内置 CPU 本地 AI 模型（Qwen2.5-1.5B）

🆕 v6.0 核心特性

🤖 内置本地模型

• ✅ Qwen2.5-1.5B-Instruct - CPU 推理，无需 GPU
• ✅ 完全离线 - 无需网络即可使用 AI
• ✅ 零 API 成本 - 本地推理，无费用
• ✅ 零配置 - 自动检测、自动注册
• ✅ 优雅降级 - 模型不可用时仍可使用云端 API

📊 模型规格

📥 如何获取完整离线包

🌟 方式 1: GitHub Actions 自动构建（推荐）

最简单！无需本地操作！

1. 访问 Actions 页面
2. 选择 "Build Offline Package (Windows)"
3. 点击 "Run workflow"
4. 等待约 10 分钟
5. 从 Release 或 Artifacts 下载完整包

或者等待自动构建完成，直接从 Release 下载！

方式 2: 使用构建脚本

# 1. 下载构建脚本
wget https://github.com/SonicBotMan/openclaw-portable/releases/download/v6.0.0/build-offline-package.sh

# 2. 运行
chmod +x build-offline-package.sh
./build-offline-package.sh

# 3. 完整离线包位于: dist/OpenClaw-Portable-v6.0.0-windows-offline.tar.gz

方式 3: 克隆仓库构建

git clone https://github.com/SonicBotMan/openclaw-portable.git
cd openclaw-portable
./build-offline-package.sh

🚀 快速开始

Windows

# 1. 从 Release 下载完整离线包
tar -xzf OpenClaw-Portable-v6.0.0-windows-offline.tar.gz

cd OpenClaw-Portable-v6.0.0-windows

# 2. 启动
double-click start.bat

# 3. 等待 60 秒
# 4. 浏览器自动打开 http://localhost:18789
# 5. 开始使用 AI！

Linux/macOS

# 1. 克隆并构建
git clone https://github.com/SonicBotMan/openclaw-portable.git
cd openclaw-portable
./build-offline-package.sh

# 2. 解压
tar -xzf dist/OpenClaw-Portable-v6.0.0-windows-offline.tar.gz

# 3. 启动
cd OpenClaw-Portable-v6.0.0-windows
./start.sh

# 4. 浏览器自动打开

✨ 新功能详解

1. 自动模型检测

启动时自动：

• ✅ 检测 llama-server 和模型文件
• ✅ 启动 llama-server（端口 18080）
• ✅ 注册 bundled-local 提供者
• ✅ 设置为默认模型（如未配置）

2. 优雅降级

如果模型不可用：

• ✅ OpenClaw 仍正常启动
• ✅ 云端 API 模型可用
• ℹ️ 显示友好提示

3. 智能配置

• ✅ 自动检测线程数（nproc - 1）
• ✅ 端口冲突检查
• ✅ PID 文件管理
• ✅ 进度反馈

📊 性能参考

内存需求：

• 最小：2 GB
• 推荐：4 GB

🆚 版本对比

📚 文档

• README.md - 完整说明
• BUNDLED_MODEL.md - 内置模型详解
• README_CN.md - 中文文档
• README_JP.md - 日本語ドキュメント

🔧 技术细节

目录结构

OpenClaw-Portable-v6.0.0-windows/
├── node/                          # Node.js 22.16.0
├── openclaw-pkg/                   # OpenClaw latest
├── llm/                            # 内置模型
│   ├── bin/
│   │   └── llama-server-win32-avx2.exe
│   └── models/
│       └── qwen2.5-1.5b-instruct-q4_k_m.gguf
├── start.bat                       # 启动脚本
├── stop.bat                        # 停止脚本
├── config/                         # 配置
├── data/                           # 数据
└── workspace/                      # 工作区

启动流程

[1/6] 检测 U盘
[2/6] 设置环境
[3/6] 启动内置本地模型 ← NEW!
[4/6] 初始化工作目录
[5/6] 保存路径记录
[6/6] 启动 OpenClaw Gateway

❓ 常见问题

Q: 如何获取完整离线包？

A: 最简单的方式：等待 GitHub Actions 自动构建完成，直接从 Release 下载。或手动触发 Actions 构建。

Q: 构建需要多久？

A: GitHub Actions 约 10-15 分钟，本地构建约 5-10 分钟。

Q: 可以使用其他模型吗？

A: 可以！替换 llm/models/*.gguf 文件即可。

Q: CPU 不支持 AVX2 怎么办？

A: Windows 版需要 AVX2，Linux/macOS 版本更兼容。

Q: 模型太慢怎么办？

A: 使用更多核心的 CPU，或使用云端 API。

🙏 致谢

• OpenClaw Team - 核心框架
• Qwen Team - Qwen2.5 模型
• llama.cpp - 高效推理引擎
• Issue #51 - 内置模型功能建议

v6.0.0 - 真正的离线 AI 助手！ 🎉

OpenClaw Portable - Your AI, Your Data, Everywhere, Even Offline! 🚀

📦 Release Assets:

• build-offline-package.sh - 本地构建脚本
• OpenClaw-Portable-v6.0.0-windows-offline.tar.gz - 完整离线包（由 GitHub Actions 自动构建）

🤖 GitHub Actions:

• 自动构建已触发！查看进度：https://github.com/SonicBotMan/openclaw-portable/actions
• 构建完成后（约 10-15 分钟），完整离线包将自动上传到此 Release

✨ 新功能

智能配置合并

• ✅ 只更新模型配置，保留其他所有设置
• ✅ 自动备份原配置（时间戳备份）
• ✅ 清晰的进度提示和用户引导

配置流程简化

1. 双击 config.bat 打开配置面板
2. 填写模型信息并下载 models.json
3. 双击 apply-config.bat 应用配置
4. 运行 restart.bat 重启 Gateway

🐛 修复

v5.1.0 热修复

• ✅ 修复 apply-config.bat 无法找到 Node.js（离线版本）
  • 自动检测本地 node/ 目录
  • 支持系统安装的 Node.js
  • 更清晰的错误提示

v5.1.0 核心修复

• 解决配置面板生成的 openclaw.json 覆盖现有配置的问题
• 防止以下数据丢失：
  • authToken（认证令牌）
  • mcp（MCP 服务器配置）
  • crons（定时任务）
  • authorizedSenders（授权发送者）

📝 改进

• 更清晰的配置流程
• 彩色进度提示
• 详细的使用说明
• 完整的测试报告

📊 对比 v5.0 vs v5.1

📥 下载

Windows 离线版（推荐）

• 文件: OpenClaw-Portable-v5.1.0-windows-offline.zip
• 大小: 170 MB
• 特点: 完全离线，无需网络
• 状态: ✅ 已修复 Node.js 路径问题

使用方法

1. 解压到 U 盘或任意目录
2. 双击 start.bat 启动（首次）
3. 浏览器自动打开 http://localhost:18789
4. 配置模型：双击 config.bat → 下载 models.json → 双击 apply-config.bat

📂 文件清单

🔗 相关链接

• 完整更新日志
• 使用说明
• 提交记录

🦞 OpenClaw Portable - 让 AI 触手可及

Release v5.0.5

发布日期： 2026-03-15
类型： Bug 修复版本

🐛 Bug 修复

Gateway 启动超时问题

问题：

1. 首次启动超时太短 - 10秒超时对于首次启动不够
2. 超时后脚本退出 - 即使 Gateway 还在启动，脚本也会退出
3. Token 未提取 - 配置文件可能在端口就绪后才创建，导致 token 未提取
4. 无进度反馈 - 用户不知道启动进度

解决方案：

• ✅ 增加超时时间从 10秒 到 60秒
• ✅ 超时后不退出，继续等待和轮询
• ✅ 每 5 秒显示进度反馈
• ✅ Token 提取失败后 5 秒重试
• ✅ 更好的错误处理和用户反馈

📊 改进对比

v5.0.4（改进前）

[5/5] Starting OpenClaw Gateway...
[INFO] Waiting for Gateway to start...
[ERROR] Gateway failed to start within 10 seconds

# 脚本退出，用户看不到 token，浏览器也不打开

v5.0.5（改进后）

[5/5] Starting OpenClaw Gateway...
[INFO] Waiting for Gateway to start...
[INFO] This may take up to 60 seconds on first run...
[INFO] Still waiting... (5/60 seconds)
[INFO] Still waiting... (10/60 seconds)
[INFO] Still waiting... (15/60 seconds)
...
[OK]  Gateway is running on port 18789

==========================================
  Gateway is ready!
==========================================

  Access URL: http://localhost:18789
  Token: abc123def456...

  [OK] Token copied to clipboard

  Direct link with token:
  http://localhost:18789?token=abc123def456...

  [浏览器自动打开]

🔧 技术细节

超时处理

改进前：

if %WAIT_COUNT% GEQ 10 (
    echo [ERROR] Gateway failed to start
    exit /b 1
)

改进后：

if %WAIT_COUNT% LSS 60 goto :wait_loop
echo [WARN] Gateway startup timeout
echo [INFO] Gateway may still be starting in the background
# 继续执行，不退出

Token 提取

改进前：

• 只尝试一次提取
• 如果配置文件还未创建，直接失败

改进后：

# 首次尝试
if defined GATEWAY_TOKEN goto :gateway_ready

# 等待 5 秒后重试
timeout /t 5 /nobreak >nul
# 再次尝试提取

进度反馈

set /a MOD=!WAIT_COUNT! %% 5
if !MOD! EQU 0 (
    echo [INFO] Still waiting... (!WAIT_COUNT!/60 seconds)
)

📦 修改内容

改动： 2 个文件，+168 -82 行

🚀 升级指南

从 v5.0.4 升级

1. 下载新版本
2. 迁移配置（可选）

   cp -r 旧版本/data 新版本/data

3. 启动新版本

   start.bat

✅ 验证

首次启动应该看到：

[5/5] Starting OpenClaw Gateway...
[INFO] Waiting for Gateway to start...
[INFO] This may take up to 60 seconds on first run...
[INFO] Still waiting... (5/60 seconds)
[INFO] Still waiting... (10/60 seconds)
...
[OK]  Gateway is running on port 18789

==========================================
  Gateway is ready!
==========================================

  Access URL: http://localhost:18789
  Token: xxx

  [OK] Token copied to clipboard

  [浏览器自动打开]

感谢使用 OpenClaw Portable！ 🎉

Release v5.0.4

发布日期： 2026-03-15
类型： Bug 修复版本

🐛 Bug 修复

Windows 批处理脚本语法错误

问题：

此时不应有 :。

启动 start.bat 时出现语法错误，导致脚本无法正常执行。

原因：

1. echo 语句中包含 : 的特定语法在 Windows 批处理中会导致解析错误
2. echo | clip 管道操作在某些 Windows 版本中不可靠

解决方案：

• ✅ 使用 PowerShell Set-Clipboard 代替 echo | clip（更可靠）
• ✅ 移除有问题的语法（括号中的冒号等）
• ✅ 改进错误处理和用户反馈

📦 修改内容

改动： 2 个文件，+14 -14 行

🚀 升级指南

从 v5.0.3 升级

如果您使用的是 v5.0.3，强烈建议升级到 v5.0.4。

1. 下载新版本
2. 迁移配置

   cp -r 旧版本/data 新版本/data

3. 启动新版本

   start.bat

✅ 验证

升级后，应该看到：

==========================================
  Gateway is ready!
==========================================

  Access URL: http://localhost:18789
  Token: abc123def456...

  [OK] Token copied to clipboard

  Direct link with token:
  http://localhost:18789?token=abc123def456...

不应再出现 此时不应有 :。 错误。

感谢使用 OpenClaw Portable！ 🎉

Release v5.0.3

发布日期： 2026-03-15
类型： 用户体验改进版本

✨ 重大改进

自动提取和显示 Token

问题：

• 用户需要手动在 data\.openclaw\openclaw.json 中查找 token
• 对小白用户来说太复杂

解决方案：

• ✅ 启动后自动从配置文件提取 gateway token
• ✅ Token 显示在控制台窗口
• ✅ 自动复制到剪贴板
• ✅ 浏览器自动带 token 打开（完全自动化）

🎯 用户体验对比

v5.0.2（改进前）

1. 运行 start.bat
2. 打开浏览器访问 http://localhost:18789
3. 提示输入 token
4. 打开文件管理器
5. 导航到 data\.openclaw\openclaw.json
6. 用记事本打开
7. 复制 token
8. 粘贴到浏览器

步骤：8 步
难度：⭐⭐⭐⭐

v5.0.3（改进后）

1. 运行 start.bat
2. 等待浏览器自动打开（已带 token）

步骤：1 步
难度：⭐

📦 功能列表

🚀 升级指南

从 v5.0.2 升级

1. 下载新版本

   • Windows: 等待离线包上传
   • Linux/macOS: git pull

2. 迁移配置（可选）

   cp -r 旧版本/data 新版本/data

3. 启动新版本

   # Windows
   start.bat
   
   # Linux/macOS
   ./start.sh

4. 享受自动化

   • 无需手动查找 token
   • 浏览器自动打开（已带 token）

🎬 启动后效果

Windows

==========================================
  Gateway is ready!
==========================================

  Access URL: http://localhost:18789
  Token:      abc123def456...

  [OK] Token copied to clipboard

  Direct link (with token):
  http://localhost:18789?token=abc123def456...

  [浏览器自动打开]
==========================================

Linux/macOS

╔════════════════════════════════════════╗
║          ✅ 启动成功！                 ║
╚════════════════════════════════════════╝

  访问地址: http://localhost:18789
  Token:      abc123def456...

  ✅ Token 已复制到剪贴板

  直接访问链接（含 Token）:
  http://localhost:18789?token=abc123def456...

  [浏览器自动打开]

📊 改动统计

• 5 个文件修改
• +464 行
• -42 行
• 净增 422 行

感谢使用 OpenClaw Portable！让 AI 更简单！ 🎉

Release v5.0.2

发布日期： 2026-03-15
类型： Bug 修复版本

🐛 重要修复

端口传递问题（PR #50）

问题描述：
启动脚本没有正确传递端口号给 OpenClaw，导致用户无法访问正确的端口。

影响：

• 用户访问 http://localhost:18789 无法打开
• 浏览器自动打开地址错误
• 端口检测逻辑失效

修复内容：

改动量： 6 个文件，+26 -7 行

🔧 改进

健康检查更健壮

先检查 curl/wget 是否存在，再执行健康检查，避免命令不存在时静默失败。

配置目录正确性

stop.sh 现在会设置 OPENCLAW_CONFIG_DIR 环境变量，确保能找到运行中的 OpenClaw 实例。

📦 离线版本

Windows 离线包

文件： OpenClaw-Portable-v5.0.2-windows-offline.tar.gz
大小： ~150MB
包含：

• Node.js 22.16.0（预置）
• OpenClaw latest（预置）
• 启动脚本（start.bat, stop.bat, check.bat）
• 配置文件（config/）

特点：

• ✅ 完全离线运行
• ✅ 无需网络连接
• ✅ 解压即用

Linux/macOS 在线包

文件： 源代码 + install.sh
特点：

• 首次运行需要网络下载依赖
• 后续完全离线运行

🚀 升级指南

从 v5.0.1 升级

1. 下载新版本
2. 迁移配置

   cp -r 旧版本/data 新版本/data
   cp -r 旧版本/workspace 新版本/workspace

3. 启动新版本

   # Windows
   start.bat
   
   # Linux/macOS
   ./start.sh

🔗 链接

• PR #50: #50
• Commit: f2b55e0

感谢使用 OpenClaw Portable！ 🎉

🚀 v5.0.0 - 完全离线版本（Bootstrap）

🎯 核心改进

解决 Issues #40-#43：

📥 下载

Bootstrap 版本（当前 Release）

• 文件: OpenClaw-Portable-v5.0.0-windows-bootstrap.zip (8.8 KB)
• 特点: 只包含脚本，首次运行自动下载依赖 (~60MB)
• 适合: 网络环境良好的用户

完全离线版本（自动构建中）

• 文件: OpenClaw-Portable-v5.0.0-windows-offline.zip (~200MB)
• 特点: 预置 Node.js + OpenClaw，完全离线
• 适合: 企业内网、离线环境
• 获取: 等待 CI 构建完成（约 10 分钟）或查看后续 Releases

🆕 新特性

📁 文件说明

🚀 使用方法

Bootstrap 版本

1. 下载并解压
2. 双击 start-online.bat（首次需联网）
3. 访问 http://localhost:18789

完全离线版本（CI 构建）

1. 下载 OpenClaw-Portable-v5.0.0-windows-offline.zip
2. 解压到 U 盘
3. 双击 start.bat
4. 无需任何网络连接！ ✅

🔧 CI 自动化

此版本新增 GitHub Actions 自动构建：

# .github/workflows/release.yml
- 自动下载 Node.js 22.16.0
- 自动安装 OpenClaw
- 打包完整离线包
- 发布到 GitHub Releases

🛡️ 安全改进

• ✅ 移除所有 Base64 内嵌代码
• ✅ 使用 Windows 10+ 内置 curl.exe
• ✅ 无注册表写入
• ✅ 无系统目录安装
• ✅ 所有数据存储在 U 盘

⚠️ Breaking Changes

• start.bat 改为离线版本，需要预置 node/ 和 openclaw-pkg/ 目录
• 如需首次下载，请使用 start-online.bat

推荐等待 CI 构建的完全离线版本！ 🎉

🐛 修复 PowerShell 5.1 兼容性

问题

v4.2.2 的 -Args 参数只在 PowerShell 7+ 可用

Windows 10 自带的 PowerShell 5.1 不支持 -Args，会报错：
cannot process command because -Command and -EncodedCommand

修复

改用环境变量传递参数

rem 旧版本（PS 7+ only）
powershell -EncodedCommand %B64% -Args "%SCRIPT_DIR%"

rem 新版本（PS 3.0+，包括 Windows 10 PS 5.1）
set "OPENCLAW_SCRIPT_DIR=%SCRIPT_DIR%"
powershell -EncodedCommand %B64%

兼容性

文件清单

下载

• Windows: openclaw-portable-v4.2.3-windows-bootstrap.zip

Commit: ecf41bd