@coocarecloud/openclaw 0.0.1

package/.fastRequest/config/fastRequestCurrentProjectConfig.json

@@ -0,0 +1,34 @@
+{
+	"apiDocTemplate":"#if (${namingPolicy}=='byDoc')\n$H1 ${methodDescription}\n#else\n$H1 $!{methodName}\n\n$H3 Method description\n\n```\n$!{methodDescription}\n```\n#end\n\n> URL: $!{url}\n>\n> Origin Url: $!{originUrl}\n>\n> Type: $!{methodType}\n\n\n$H3 Request headers\n\n|Header Name| Header Value|\n|---------|------|\n#foreach( $h in ${headerList})\n|$h.type|$h.value|\n#end\n\n$H3 Parameters\n\n$H5 Path parameters\n\n| Parameter | Type | Value | Description |\n|---------|------|------|------------|\n#foreach( $node in ${pathKeyValueList})\n|$node.key|$!{node.type}|$!{node.value}|$!{node.comment}|\n#end\n\n\n$H5 URL parameters\n\n|Required| Parameter | Type | Value | Description |\n|---------|---------|------|------|------------|\n#foreach( $node in ${urlParamsKeyValueList})\n|$!{node.enabled}|$!{node.key}|$!{node.type}|$!{node.value}|$!{node.comment}|\n#end\n\n\n$H5 Body parameters\n\n$H6 JSON\n\n```\n${jsonParam}\n```\n\n$H6 JSON document\n\n```\n${jsonParamDocument}\n```\n\n\n$H5 Form URL-Encoded\n|Required| Parameter | Type | Value | Description |\n|---------|---------|------|------|------------|\n#foreach( $node in ${urlEncodedKeyValueList})\n|$!{node.enabled}|$!{node.key}|$!{node.type}|$!{node.value}|$!{node.comment}|\n#end\n\n\n$H5 Multipart\n|Required | Parameter | Type | Value | Description |\n|---------|---------|------|------|------------|\n#foreach( $node in ${multipartKeyValueList})\n|$!{node.enabled}|$!{node.key}|$!{node.type}|$!{node.value}|$!{node.comment}|\n#end\n\n\n$H3 Response\n\n$H5 Response example\n\n```\n$!{responseExample}\n```\n\n$H5 Response document\n```\n$!{returnDocument}\n```\n\n\n",
+	"apifoxSetting":{
+		"domain":"https://api.apifox.com",
+		"syncAfterSave":false
+	},
+	"dataList":[],
+	"envList":[],
+	"headerList":[],
+	"ignoreParseFieldList":[],
+	"maxDescriptionLength":-1,
+	"pmCollectionId":"",
+	"postScript":"",
+	"preScript":"",
+	"projectList":[],
+	"searchTruncatedCode":"",
+	"syncModel":{
+		"branch":"master",
+		"domain":"https://github.com",
+		"enabled":false,
+		"gitToken":"",
+		"namingPolicy":"byDoc",
+		"owner":"",
+		"repo":"",
+		"repoUrl":"",
+		"syncAfterRun":false,
+		"type":"github"
+	},
+	"syncPmAfterSave":false,
+	"urlEncodedKeyValueList":[],
+	"urlParamsKeyValueList":[],
+	"urlSuffix":"",
+	"workspaceId":""
+}

package/.gitattributes

@@ -0,0 +1,14 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Shell scripts must use LF
+*.sh text eol=lf
+shims/openclaw text eol=lf
+
+# Windows scripts use CRLF
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+*.iss text eol=crlf
+
+# Binary
+*.ico binary

package/.github/workflows/build.yml

@@ -0,0 +1,406 @@
+name: Build OpenClaw Standalone
+
+on:
+  # Manual trigger with version input
+  workflow_dispatch:
+    inputs:
+      openclaw_version:
+        description: 'OpenClaw version to package (leave empty for latest)'
+        required: false
+        default: ''
+      upload_r2:
+        description: 'Upload to Cloudflare R2'
+        required: false
+        type: boolean
+        default: true
+  # Auto-trigger on tag push
+  push:
+    branches:
+      - main
+    tags:
+      - 'v*'
+
+env:
+  NODE_VERSION: '22'
+  OPENCLAW_PKG: '@coocarecloud/openclaw'
+  NPM_REGISTRY: 'https://registry.npmmirror.com'
+
+jobs:
+  # --- Resolve version ---
+  resolve-version:
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+      pkg_spec: ${{ steps.version.outputs.pkg_spec }}
+    steps:
+      - name: Resolve OpenClaw version
+        id: version
+        run: |
+          INPUT_VER="${{ github.event.inputs.openclaw_version }}"
+          if [ -n "$INPUT_VER" ]; then
+            echo "version=$INPUT_VER" >> $GITHUB_OUTPUT
+            echo "pkg_spec=${{ env.OPENCLAW_PKG }}@$INPUT_VER" >> $GITHUB_OUTPUT
+          else
+            # Get latest version from npm
+            VER=$(npm view "${{ env.OPENCLAW_PKG }}" version --registry "${{ env.NPM_REGISTRY }}" 2>/dev/null || echo "")
+            if [ -z "$VER" ]; then
+              echo "Failed to resolve latest version"
+              exit 1
+            fi
+            echo "version=$VER" >> $GITHUB_OUTPUT
+            echo "pkg_spec=${{ env.OPENCLAW_PKG }}@$VER" >> $GITHUB_OUTPUT
+          fi
+          echo "Resolved version: $(cat $GITHUB_OUTPUT | grep version= | head -1)"
+
+  # --- Build matrix ---
+  build:
+    needs: resolve-version
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            platform: win-x64
+            archive_ext: zip
+          - os: macos-15
+            platform: mac-arm64
+            archive_ext: tar.gz
+          - os: ubuntu-latest
+            platform: linux-x64
+            archive_ext: tar.gz
+          - os: ubuntu-24.04-arm
+            platform: linux-arm64
+            archive_ext: tar.gz
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+
+      - name: Show environment
+        run: |
+          node --version
+          npm --version
+          echo "Platform: ${{ matrix.platform }}"
+          echo "Version: ${{ needs.resolve-version.outputs.version }}"
+
+      # ===== Build =====
+      - name: Enable Windows Long Paths
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" `
+            -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force | Out-Null
+          git config --system core.longpaths true
+
+      - name: Create build directory
+        shell: bash
+        run: mkdir -p build/${{ matrix.platform }}
+
+      - name: Install OpenClaw
+        shell: bash
+        working-directory: build/${{ matrix.platform }}
+        run: |
+          echo '{ "name": "openclaw-standalone-build", "private": true }' > package.json
+          npm install "${{ needs.resolve-version.outputs.pkg_spec }}" \
+            --registry "${{ env.NPM_REGISTRY }}" \
+            --include=optional
+          rm -f package.json package-lock.json
+
+      - name: Copy Node.js binary (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          cp "$(which node)" "build/${{ matrix.platform }}/node"
+          chmod +x "build/${{ matrix.platform }}/node"
+
+      - name: Copy Node.js binary (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Copy-Item (Get-Command node).Source "build/${{ matrix.platform }}/node.exe"
+
+      - name: Copy shim (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          cp shims/openclaw "build/${{ matrix.platform }}/openclaw"
+          chmod +x "build/${{ matrix.platform }}/openclaw"
+
+      - name: Copy shim (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Copy-Item "shims/openclaw.cmd" "build/${{ matrix.platform }}/openclaw.cmd"
+
+      - name: Write VERSION file
+        shell: bash
+        run: |
+          cat > "build/${{ matrix.platform }}/VERSION" <<EOF
+          openclaw_version=${{ needs.resolve-version.outputs.version }}
+          node_version=$(node --version)
+          platform=${{ matrix.platform }}
+          build_date=$(date -u '+%Y-%m-%d %H:%M:%S UTC')
+          EOF
+
+      # ===== Cleanup to reduce size =====
+      - name: Cleanup unnecessary files (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          echo "Before: $(du -sm build/${{ matrix.platform }}/node_modules | cut -f1)MB"
+          find "build/${{ matrix.platform }}/node_modules" -type f \( \
+            -name "*.ts" ! -name "*.d.ts" -o \
+            -name "*.map" -o \
+            -name "CHANGELOG*" -o \
+            -name "HISTORY*" -o \
+            -name "AUTHORS*" -o \
+            -name ".npmignore" -o \
+            -name ".eslintrc*" -o \
+            -name ".prettierrc*" -o \
+            -name "Makefile" -o \
+            -name ".editorconfig" -o \
+            -name ".travis.yml" \
+          \) -delete 2>/dev/null || true
+          find "build/${{ matrix.platform }}/node_modules" -type d \( \
+            -name "test" -o -name "tests" -o -name "__tests__" -o \
+            -name "spec" -o -name "example" -o -name "examples" -o \
+            -name ".github" -o -name ".circleci" \
+          \) -exec rm -rf {} + 2>/dev/null || true
+          echo "After: $(du -sm build/${{ matrix.platform }}/node_modules | cut -f1)MB"
+
+      - name: Cleanup unnecessary files (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          $nmDir = "build/${{ matrix.platform }}/node_modules"
+          $patterns = @("*.ts", "*.map", "CHANGELOG*", "HISTORY*", "AUTHORS*",
+                        ".npmignore", ".eslintrc*", ".prettierrc*", "Makefile",
+                        ".editorconfig", ".travis.yml")
+          $dirPatterns = @("test", "tests", "__tests__", "spec", "example", "examples", ".github", ".circleci")
+          foreach ($p in $patterns) {
+            Get-ChildItem -Path $nmDir -Recurse -Filter $p -File -ErrorAction SilentlyContinue |
+              Where-Object { $_.Name -notlike "*.d.ts" } |
+              Remove-Item -Force -ErrorAction SilentlyContinue
+          }
+          foreach ($d in $dirPatterns) {
+            Get-ChildItem -Path $nmDir -Recurse -Directory -Filter $d -ErrorAction SilentlyContinue |
+              Remove-Item -Recurse -Force -ErrorAction SilentlyContinue
+          }
+          # Remove ALL nested node_modules inside openclaw package tree (deeply nested deps like @jimp/plugin-print/zod cause MAX_PATH overflow in Inno Setup)
+          $zhPath = "$nmDir\@coocarecloud\openclaw"
+          if (Test-Path $zhPath) {
+            Get-ChildItem -Path $zhPath -Directory -Filter "node_modules" -Recurse -ErrorAction SilentlyContinue |
+              Remove-Item -Recurse -Force -ErrorAction SilentlyContinue
+          }
+
+      # ===== Package =====
+      - name: Create archive (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          mkdir -p output
+          mv "build/${{ matrix.platform }}" "build/openclaw"
+          tar -czf "output/openclaw-${{ needs.resolve-version.outputs.version }}-${{ matrix.platform }}.tar.gz" \
+            -C build openclaw
+          mv "build/openclaw" "build/${{ matrix.platform }}"
+          # Generate checksum
+          cd output
+          shasum -a 256 *.tar.gz > "openclaw-${{ needs.resolve-version.outputs.version }}-${{ matrix.platform }}.tar.gz.sha256" 2>/dev/null || \
+          sha256sum *.tar.gz > "openclaw-${{ needs.resolve-version.outputs.version }}-${{ matrix.platform }}.tar.gz.sha256" 2>/dev/null || true
+          ls -lh
+
+      - name: Create archive (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          New-Item -ItemType Directory -Force -Path output | Out-Null
+          $version = "${{ needs.resolve-version.outputs.version }}"
+          $zipName = "openclaw-$version-win-x64.zip"
+          Rename-Item "build/${{ matrix.platform }}" "openclaw"
+          Compress-Archive -Path "build/openclaw" -DestinationPath "output/$zipName" -CompressionLevel Optimal
+          Rename-Item "build/openclaw" "${{ matrix.platform }}"
+          # Generate checksum
+          $hash = (Get-FileHash "output/$zipName" -Algorithm SHA256).Hash.ToLower()
+          "$hash  $zipName" | Set-Content "output/$zipName.sha256"
+          Get-ChildItem output
+
+      # ===== Inno Setup installer (Windows only) =====
+      - name: Build Inno Setup installer
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          $version = "${{ needs.resolve-version.outputs.version }}"
+          $sourceDir = "${{ github.workspace }}\build\${{ matrix.platform }}"
+          $outputDir = "${{ github.workspace }}\output"
+          # Inno Setup is pre-installed on windows-latest
+          & "C:\Program Files (x86)\Inno Setup 6\ISCC.exe" `
+            "/DAppVersion=$version" `
+            "/DSourceDir=$sourceDir" `
+            "/DOutputDir=$outputDir" `
+            "installer\setup.iss"
+
+      # ===== Upload artifacts =====
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: openclaw-${{ matrix.platform }}
+          path: output/*
+          retention-days: 30
+
+  # --- Create Release ---
+  release:
+    needs: [resolve-version, build]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v') || github.event_name == 'workflow_dispatch'
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+          merge-multiple: false
+
+      - name: Collect all files
+        run: |
+          mkdir -p release
+          find artifacts -type f \( -name "*.zip" -o -name "*.tar.gz" -o -name "*.exe" -o -name "*.sha256" \) \
+            -exec cp {} release/ \;
+          ls -lh release/
+
+      - name: Generate latest.json manifest
+        run: |
+          VERSION="${{ needs.resolve-version.outputs.version }}"
+          cat > release/latest.json <<EOF
+          {
+            "version": "$VERSION",
+            "date": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+            "downloads": {
+              "win-x64": {
+                "zip": "openclaw-$VERSION-win-x64.zip",
+                "installer": "openclaw-$VERSION-win-x64-setup.exe"
+              },
+              "mac-arm64": {
+                "archive": "openclaw-$VERSION-mac-arm64.tar.gz"
+              },
+              "linux-x64": {
+                "archive": "openclaw-$VERSION-linux-x64.tar.gz"
+              },
+              "linux-arm64": {
+                "archive": "openclaw-$VERSION-linux-arm64.tar.gz"
+              }
+            }
+          }
+          EOF
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ needs.resolve-version.outputs.version }}
+          name: OpenClaw ${{ needs.resolve-version.outputs.version }}
+          body: |
+            ## OpenClaw ${{ needs.resolve-version.outputs.version }} 独立安装包
+
+            **零依赖安装** — 无需 Node.js，无需 npm，下载即用！
+
+            ### 📥 下载
+
+            | 平台 | 文件 | 说明 |
+            |------|------|------|
+            | Windows x64 | `*-win-x64-setup.exe` | **推荐** 引导式安装 |
+            | Windows x64 | `*-win-x64.zip` | 绿色免安装版 |
+            | macOS ARM (Apple Silicon) | `*-mac-arm64.tar.gz` | 解压即用 |
+            | Linux x64 | `*-linux-x64.tar.gz` | 解压即用 |
+            | Linux ARM64 (树莓派等) | `*-linux-arm64.tar.gz` | 解压即用 |
+
+            ### 🚀 安装方法
+
+            **Windows**: 下载 `.exe` 安装包，双击运行安装向导
+
+            **macOS / Linux**:
+            ```bash
+            curl -fsSL https://dl.qrj.ai/openclaw/install.sh | bash
+            ```
+
+            或手动: 下载对应平台的 `.tar.gz` → 解压 → 将目录加入 PATH
+
+            ---
+            由 [晴辰云](https://gpt.qt.cool) 构建 · [ClawPanel 图形管理面板](https://github.com/coocare/clawpanel)
+          files: release/*
+          draft: false
+          prerelease: false
+
+  # --- Upload to R2 ---
+  upload-r2:
+    needs: [resolve-version, build, release]
+    runs-on: ubuntu-latest
+    if: >-
+      (startsWith(github.ref, 'refs/tags/v') || github.event.inputs.upload_r2 == 'true')
+
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+          merge-multiple: false
+
+      - name: Collect files
+        run: |
+          mkdir -p upload
+          find artifacts -type f \( -name "*.zip" -o -name "*.tar.gz" -o -name "*.exe" -o -name "*.sha256" \) \
+            -exec cp {} upload/ \;
+          ls -lh upload/
+
+      - name: Setup Node.js for wrangler
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+
+      - name: Install wrangler
+        run: npm install -g wrangler
+
+      - name: Upload files to R2
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+        run: |
+          VERSION="${{ needs.resolve-version.outputs.version }}"
+          PREFIX="openclaw-standalone/${VERSION}"
+          FAILED=0
+          for file in upload/*; do
+            FILENAME=$(basename "$file")
+            SIZE_MB=$(( $(stat --format=%s "$file") / 1048576 ))
+            echo "Uploading $FILENAME (${SIZE_MB}MB) ..."
+            if [ "$SIZE_MB" -gt 290 ]; then
+              echo "⚠ Skipping $FILENAME (${SIZE_MB}MB > 290MB wrangler limit, available in GitHub Release)"
+              continue
+            fi
+            if wrangler r2 object put "clawpanel-releases/${PREFIX}/${FILENAME}" --file "$file" --remote; then
+              echo "✓ $FILENAME uploaded"
+            else
+              echo "⚠ Failed to upload $FILENAME, continuing..."
+              FAILED=$((FAILED + 1))
+            fi
+          done
+          echo "Upload complete (skipped/failed: $FAILED)"
+
+      - name: Upload latest.json to R2
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+        run: |
+          VERSION="${{ needs.resolve-version.outputs.version }}"
+          cat > /tmp/latest.json <<EOF
+          {
+            "version": "$VERSION",
+            "date": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+            "base_url": "https://dl.qrj.ai/openclaw-standalone/$VERSION"
+          }
+          EOF
+          wrangler r2 object put "clawpanel-releases/openclaw-standalone/latest.json" \
+            --file /tmp/latest.json --content-type application/json --remote
+          echo "latest.json updated to version $VERSION"

package/LICENSE

@@ -0,0 +1,23 @@
+                    GNU AFFERO GENERAL PUBLIC LICENSE
+                       Version 3, 19 November 2007
+
+Copyright (c) 2024-2026 coocare (晴辰云)
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+--- Commercial License ---
+
+For commercial use without AGPL obligations, contact:
+  https://github.com/coocare
+  https://gpt.qt.cool

package/README.md

@@ -0,0 +1,187 @@
+# OpenClaw Standalone
+
+**零依赖安装包** — 无需 Node.js，无需 npm，下载即用！
+
+由 [晴辰云 (coocare)](https://gpt.qt.cool) 构建和维护。
+
+[![Build](https://github.com/coocare/openclaw-standalone/actions/workflows/build.yml/badge.svg)](https://github.com/coocare/openclaw-standalone/actions/workflows/build.yml)
+[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
+
+---
+
+## 为什么需要这个项目？
+
+[OpenClaw](https://github.com/openclaw/openclaw) 是一个强大的 AI 智能体引擎，但官方安装方式依赖 `npm install -g`，存在以下痛点：
+
+- 🐢 **国内网络慢**：npm 默认从境外 registry 下载，大量依赖导致安装耗时 10-30 分钟
+- 🔧 **环境要求高**：需要预装 Node.js 22+、npm、Git，还可能遇到原生模块编译失败
+- 🤯 **新手不友好**：各种权限、PATH、网络报错让非技术用户望而却步
+
+**OpenClaw Standalone** 解决了这一切：
+
+- ✅ **零依赖**：内置 Node.js 运行时和所有预编译依赖
+- ✅ **秒级安装**：下载 → 解压 → 就能用
+- ✅ **全平台**：Windows / macOS / Linux / 树莓派
+- ✅ **Windows 引导安装**：专业的 .exe 安装向导，跟装普通软件一样简单
+
+---
+
+## 📥 安装方法
+
+### Windows（推荐：安装向导）
+
+1. 从 [Releases](https://github.com/coocare/openclaw-standalone/releases) 下载 `openclaw-*-win-x64-setup.exe`
+2. 双击运行安装向导
+3. 打开终端，输入 `openclaw` 即可使用
+
+> 也可以下载 `.zip` 绿色免安装版，解压后手动添加目录到 PATH。
+
+### macOS / Linux（一键安装）
+
+```bash
+curl -fsSL https://dl.qrj.ai/openclaw/install.sh | bash
+```
+
+支持的平台：
+- macOS x64 (Intel)
+- macOS ARM64 (Apple Silicon / M1-M4)
+- Linux x64
+- Linux ARM64 (树莓派 4/5、ARM 服务器)
+
+### 手动安装
+
+1. 从 [Releases](https://github.com/coocare/openclaw-standalone/releases) 下载对应平台的压缩包
+2. 解压到任意目录
+3. 将该目录添加到系统 PATH
+4. 打开终端，输入 `openclaw --version` 验证
+
+---
+
+## 🚀 快速开始
+
+```bash
+# 查看帮助
+openclaw --help
+
+# 初始化配置（首次使用）
+openclaw setup
+
+# 启动 AI Gateway
+openclaw gateway
+
+# 查看状态
+openclaw status
+```
+
+### 搭配图形管理面板
+
+推荐安装 [ClawPanel](https://github.com/coocare/clawpanel) 图形化管理面板，提供：
+- 可视化模型配置
+- 智能体管理
+- 消息渠道（飞书、钉钉、QQ 等）
+- Docker 军团调度
+- 定时任务、技能市场等
+
+### 使用晴辰云 AI 接口
+
+[晴辰云](https://gpt.qt.cool) 提供兼容 OpenAI 的 API 接口：
+- 每天签到送免费额度
+- 支持 GPT-5 全系列模型
+- 端点：`https://gpt.qt.cool/v1`
+
+---
+
+## 📦 下载一览
+
+| 平台 | 架构 | 文件类型 | 说明 |
+|------|------|---------|------|
+| Windows | x64 | `.exe` 安装包 | 引导式安装，自动配置 PATH |
+| Windows | x64 | `.zip` | 绿色免安装，解压即用 |
+| macOS | x64 (Intel) | `.tar.gz` | 解压即用 |
+| macOS | ARM64 (Apple Silicon) | `.tar.gz` | 解压即用 |
+| Linux | x64 | `.tar.gz` | 解压即用 |
+| Linux | ARM64 | `.tar.gz` | 树莓派、ARM 服务器 |
+
+---
+
+## 🏗️ 构建原理
+
+本项目的核心思想：**在 CI 的各平台 runner 上预编译所有原生模块，打包 Node.js 运行时 + 完整 node_modules 成自包含发行包。**
+
+```
+GitHub Actions CI Matrix
+├── windows-latest  → npm install → 原生模块 x64 编译 → zip + Inno Setup .exe
+├── macos-13        → npm install → 原生模块 x64 编译 → tar.gz
+├── macos-14        → npm install → 原生模块 ARM 编译 → tar.gz
+├── ubuntu-latest   → npm install → 原生模块 x64 编译 → tar.gz
+└── ubuntu-arm64    → npm install → 原生模块 ARM 编译 → tar.gz
+```
+
+每个平台的产出包含：
+- `node` / `node.exe` — Node.js 运行时
+- `openclaw` / `openclaw.cmd` — CLI 入口脚本
+- `node_modules/` — 所有依赖（含预编译的原生模块）
+- `VERSION` — 版本信息
+
+### 本地构建
+
+```bash
+# Windows
+powershell -ExecutionPolicy Bypass -File scripts/package-win.ps1
+
+# macOS / Linux
+bash scripts/package-unix.sh
+```
+
+---
+
+## 🔄 更新
+
+### 自动更新
+ClawPanel 会自动检测新版本并提示更新。
+
+### 手动更新
+重新运行安装脚本即可覆盖安装：
+
+```bash
+# macOS / Linux
+curl -fsSL https://dl.qrj.ai/openclaw/install.sh | bash
+
+# Windows
+# 重新下载安装包运行即可
+```
+
+---
+
+## ❓ 常见问题
+
+### Q: 这个跟 `npm install -g openclaw` 有什么区别？
+A: 效果完全一样，但不需要预装 Node.js 和 npm，也不需要网络下载依赖。所有东西都预编译打包好了。
+
+### Q: 支持树莓派吗？
+A: 支持！下载 `linux-arm64` 版本即可。支持树莓派 4/5 及其他 ARM64 设备。
+
+### Q: 安装包为什么这么大（200-300MB）？
+A: 因为包含了完整的 Node.js 运行时和所有预编译的依赖（包括图片处理库 sharp、SQLite 等原生模块）。这是"零依赖"的代价，但相比 npm 安装耗时 30 分钟，一次下载几分钟更划算。
+
+### Q: 能跟 npm 安装的 OpenClaw 共存吗？
+A: 可以，但建议只保留一个。如果两个都在 PATH 中，系统会使用 PATH 中靠前的那个。
+
+---
+
+## 📄 许可证
+
+[AGPL-3.0](LICENSE) + 商业授权
+
+- 个人/学生/非商业：完全自由 ✅
+- 企业商用：需遵守 AGPL 或购买商业授权
+
+---
+
+## 🔗 相关项目
+
+- [OpenClaw](https://github.com/openclaw/openclaw) — AI 智能体引擎（上游）
+- [OpenClaw 汉化版](https://github.com/1186258278/OpenClawChineseTranslation) — 本项目打包的汉化版源码
+- [ClawPanel](https://github.com/coocare/clawpanel) — 图形化管理面板
+- [openclaw-docker](https://github.com/coocare/openclaw-docker) — Docker 部署方案
+- [晴辰云](https://gpt.qt.cool) — AI 接口服务