Add Windows PowerShell installation script

- Add install/hiclaw-install.ps1 for Windows installation support
  - PowerShell 7+ required
  - Supports Quick Start and Manual modes
  - Windows timezone detection with IANA conversion
  - LAN IP detection for mobile access instructions
  - Docker Desktop integration via named pipe
- Update install/README.md with cross-platform installation guide
- Update .github/workflows/release.yml with Windows quick start commands
- Update README.md and README.zh-CN.md with Windows installation instructions

Change-Id: I1229a94f32808959a00f6a01a336dc7ad3b3a65a
Co-developed-by: Claude <noreply@anthropic.com>

Author: johnlanni

.github/workflows/release.yml

@@ -38,6 +38,28 @@ jobs:
 
             ## Quick Start
 
+            ### macOS / Linux
+
             ```bash
             bash <(curl -fsSL https://raw.githubusercontent.com/${{ github.repository }}/main/install/hiclaw-install.sh)
             ```
+
+            ### Windows (PowerShell 7+)
+
+            ```powershell
+            Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/${{ github.repository }}/main/install/hiclaw-install.ps1" -UseBasicParsing).Content
+            ```
+
+            Or download and run:
+
+            ```powershell
+            # Download
+            Invoke-WebRequest -Uri "https://raw.githubusercontent.com/${{ github.repository }}/main/install/hiclaw-install.ps1" -OutFile "hiclaw-install.ps1"
+
+            # Run
+            .\hiclaw-install.ps1
+            ```
+
+            ## Documentation
+
+            For more details, see the [installation guide](https://github.com/${{ github.repository }}/blob/main/install/README.md).

README.md

@@ -23,21 +23,35 @@ See **[docs/quickstart.md](docs/quickstart.md)** for a step-by-step guide from z
 
 ### Prerequisites
 
-- Docker installed on your machine
+- **Docker Desktop** (Windows/macOS) or **Docker Engine** (Linux) installed and running
+- **PowerShell 7+** (Windows only)
 - An LLM API key (e.g., Qwen, OpenAI)
 - (Optional) A GitHub Personal Access Token for GitHub collaboration features
 
 ### Installation
 
+#### macOS / Linux
+
 ```bash
 # Quick install (interactive)
-bash <(curl -sSL https://higress.ai/hiclaw/install.sh)
+bash <(curl -fsSL https://higress.ai/hiclaw/install.sh)
 
 # Or clone and install
 git clone https://github.com/higress-group/hiclaw.git && cd hiclaw
 HICLAW_LLM_API_KEY="sk-xxx" make install
 ```
 
+#### Windows (PowerShell 7+)
+
+```powershell
+# Quick install (interactive)
+Invoke-Expression (Invoke-WebRequest -Uri "https://higress.ai/hiclaw/install.ps1" -UseBasicParsing).Content
+
+# Or download and run
+Invoke-WebRequest -Uri "https://higress.ai/hiclaw/install.ps1" -OutFile "hiclaw-install.ps1"
+.\hiclaw-install.ps1
+```
+
 The installation script will:
 1. **Detect your timezone** (supports Linux and macOS) for optimal registry selection
 2. **Prompt for configuration** (LLM provider, API key, ports, etc.) - all can be pre-set via environment variables
@@ -46,6 +60,8 @@ The installation script will:
 
 #### Installation Options
 
+**macOS / Linux:**
+
 ```bash
 # Non-interactive mode (use all defaults)
 HICLAW_NON_INTERACTIVE=1 HICLAW_LLM_API_KEY="sk-xxx" make install
@@ -66,6 +82,23 @@ HICLAW_TIMEZONE=Asia/Shanghai \
 make install
 ```
 
+**Windows (PowerShell):**
+
+```powershell
+# Non-interactive mode (use all defaults)
+$env:HICLAW_NON_INTERACTIVE = "1"
+$env:HICLAW_LLM_API_KEY = "sk-xxx"
+.\hiclaw-install.ps1
+
+# Pre-configure all settings
+$env:HICLAW_LLM_PROVIDER = "qwen"
+$env:HICLAW_DEFAULT_MODEL = "qwen3.5-plus"
+$env:HICLAW_LLM_API_KEY = "sk-xxx"
+$env:HICLAW_ADMIN_USER = "admin"
+$env:HICLAW_ADMIN_PASSWORD = "yourpassword"
+.\hiclaw-install.ps1
+```
+
 #### Upgrade or Reinstall
 
 When running the install script on an existing installation, you'll be prompted:

README.zh-CN.md

@@ -23,21 +23,35 @@ HiClaw 让你部署一支 AI Agent 团队，通过即时通讯（Matrix 协议
 
 ### 前置条件
 
-- 已安装 Docker
+- **Docker Desktop**（Windows/macOS）或 **Docker Engine**（Linux）已安装并运行
+- **PowerShell 7+**（仅 Windows）
 - LLM API Key（如通义千问、OpenAI 等）
 - （可选）GitHub Personal Access Token，用于 GitHub 协作功能
 
 ### 安装
 
+#### macOS / Linux
+
 ```bash
 # 一键安装（交互式）
-bash <(curl -sSL https://higress.ai/hiclaw/install.sh)
+bash <(curl -fsSL https://higress.ai/hiclaw/install.sh)
 
 # 或克隆后安装
 git clone https://github.com/higress-group/hiclaw.git && cd hiclaw
 HICLAW_LLM_API_KEY="sk-xxx" make install
 ```
 
+#### Windows（PowerShell 7+）
+
+```powershell
+# 一键安装（交互式）
+Invoke-Expression (Invoke-WebRequest -Uri "https://higress.ai/hiclaw/install.ps1" -UseBasicParsing).Content
+
+# 或下载后运行
+Invoke-WebRequest -Uri "https://higress.ai/hiclaw/install.ps1" -OutFile "hiclaw-install.ps1"
+.\hiclaw-install.ps1
+```
+
 安装脚本会自动：
 1. **检测时区**（支持 Linux 和 macOS），选择最优镜像源
 2. **交互式配置**（LLM 提供商、API Key、端口等）——也可通过环境变量预设
@@ -46,6 +60,8 @@ HICLAW_LLM_API_KEY="sk-xxx" make install
 
 #### 安装选项
 
+**macOS / Linux:**
+
 ```bash
 # 非交互模式（使用全部默认值）
 HICLAW_NON_INTERACTIVE=1 HICLAW_LLM_API_KEY="sk-xxx" make install
@@ -66,6 +82,23 @@ HICLAW_TIMEZONE=Asia/Shanghai \
 make install
 ```
 
+**Windows（PowerShell）:**
+
+```powershell
+# 非交互模式（使用全部默认值）
+$env:HICLAW_NON_INTERACTIVE = "1"
+$env:HICLAW_LLM_API_KEY = "sk-xxx"
+.\hiclaw-install.ps1
+
+# 预设所有配置
+$env:HICLAW_LLM_PROVIDER = "qwen"
+$env:HICLAW_DEFAULT_MODEL = "qwen3.5-plus"
+$env:HICLAW_LLM_API_KEY = "sk-xxx"
+$env:HICLAW_ADMIN_USER = "admin"
+$env:HICLAW_ADMIN_PASSWORD = "yourpassword"
+.\hiclaw-install.ps1
+```
+
 #### 升级或重装
 
 在已有安装上再次运行安装脚本时，会提示选择操作：

install/README.md

@@ -2,12 +2,67 @@
 
 One-click installation script for HiClaw Manager and Worker Agents.
 
+## Requirements
+
+- **Docker Desktop** (Windows/macOS) or **Docker Engine** (Linux) must be installed and running
+- **PowerShell 7+** (Windows only)
+
+## Quick Start
+
+### macOS / Linux
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.sh)
+```
+
+### Windows (PowerShell 7+)
+
+```powershell
+Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.ps1" -UseBasicParsing).Content
+```
+
+Or download and run:
+
+```powershell
+# Download
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.ps1" -OutFile "hiclaw-install.ps1"
+
+# Run
+.\hiclaw-install.ps1
+```
+
+## Installation Modes
+
+### Quick Start (Recommended)
+
+Fast installation with Alibaba Cloud Bailian as the default LLM provider. Just provide your API key and go!
+
+### Manual
+
+Customize each option:
+- LLM Provider (Alibaba Cloud Bailian or OpenAI-compatible)
+- Admin credentials
+- Port configuration
+- Domain names
+- GitHub PAT (optional)
+- Data persistence options
+
 ## Usage
 
 ### Install Manager
 
+**macOS / Linux:**
 ```bash
 ./hiclaw-install.sh manager
+# or simply
+./hiclaw-install.sh
+```
+
+**Windows:**
+```powershell
+.\hiclaw-install.ps1 manager
+# or simply
+.\hiclaw-install.ps1
 ```
 
 Interactive prompts will ask for:
@@ -20,23 +75,121 @@ Interactive prompts will ask for:
 
 Workers are created by the Manager Agent through conversation. The Manager provides the exact command to run:
 
+**macOS / Linux:**
 ```bash
 ./hiclaw-install.sh worker \
   --name alice \
-  --matrix-server http://matrix-local.hiclaw.io:8080 \
-  --gateway http://aigw-local.hiclaw.io:8080 \
-  --fs http://fs-local.hiclaw.io:8080 \
+  --fs http://fs-local.hiclaw.io:18080 \
   --fs-key <ACCESS_KEY> \
   --fs-secret <SECRET_KEY>
 ```
 
+**Windows:**
+```powershell
+.\hiclaw-install.ps1 worker `
+  -Name alice `
+  -Fs http://fs-local.hiclaw.io:18080 `
+  -FsKey <ACCESS_KEY> `
+  -FsSecret <SECRET_KEY>
+```
+
 ### Reset Worker
 
+**macOS / Linux:**
 ```bash
 ./hiclaw-install.sh worker --reset --name alice \
-  --matrix-server http://matrix-local.hiclaw.io:8080 \
-  --gateway http://aigw-local.hiclaw.io:8080 \
-  --fs http://fs-local.hiclaw.io:8080 \
+  --fs http://fs-local.hiclaw.io:18080 \
   --fs-key <ACCESS_KEY> \
   --fs-secret <SECRET_KEY>
 ```
+
+**Windows:**
+```powershell
+.\hiclaw-install.ps1 worker -Reset `
+  -Name alice `
+  -Fs http://fs-local.hiclaw.io:18080 `
+  -FsKey <ACCESS_KEY> `
+  -FsSecret <SECRET_KEY>
+```
+
+### Uninstall
+
+**macOS / Linux:**
+```bash
+./hiclaw-install.sh uninstall
+```
+
+**Windows:**
+```powershell
+.\hiclaw-install.ps1 uninstall
+```
+
+## Non-Interactive Mode (Automation)
+
+Set environment variables to skip prompts:
+
+**macOS / Linux:**
+```bash
+export HICLAW_NON_INTERACTIVE=1
+export HICLAW_LLM_API_KEY="your-api-key"
+./hiclaw-install.sh
+```
+
+**Windows:**
+```powershell
+$env:HICLAW_NON_INTERACTIVE = "1"
+$env:HICLAW_LLM_API_KEY = "your-api-key"
+.\hiclaw-install.ps1
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HICLAW_NON_INTERACTIVE` | Skip all prompts | `0` |
+| `HICLAW_LLM_PROVIDER` | LLM provider (`qwen` or `openai-compat`) | `qwen` |
+| `HICLAW_DEFAULT_MODEL` | Default model ID | `qwen3.5-plus` |
+| `HICLAW_LLM_API_KEY` | LLM API key | *(required)* |
+| `HICLAW_ADMIN_USER` | Admin username | `admin` |
+| `HICLAW_ADMIN_PASSWORD` | Admin password | *(auto-generated)* |
+| `HICLAW_PORT_GATEWAY` | Gateway port | `18080` |
+| `HICLAW_PORT_CONSOLE` | Higress console port | `18001` |
+| `HICLAW_MATRIX_DOMAIN` | Matrix domain | `matrix-local.hiclaw.io:18080` |
+| `HICLAW_DATA_DIR` | Data directory | Docker volume |
+| `HICLAW_WORKSPACE_DIR` | Manager workspace | `~/hiclaw-manager` |
+| `HICLAW_VERSION` | Image tag | `latest` |
+| `HICLAW_REGISTRY` | Image registry | *(auto-detected by timezone)* |
+
+## Platform Notes
+
+### Windows
+
+- Requires **PowerShell 7+** (PowerShell Core)
+- Docker Desktop must be running with WSL 2 backend
+- The script uses named pipe (`//var/run/docker.sock`) for Docker socket mount
+
+### macOS
+
+- Docker Desktop must be running
+- Supports both Intel (amd64) and Apple Silicon (arm64)
+
+### Linux
+
+- Docker Engine or Docker Desktop required
+- Supports both amd64 and arm64 architectures
+
+## Post-Installation
+
+After successful installation:
+
+1. Open the Element Web URL in your browser
+2. Login with your admin credentials
+3. Start chatting with the Manager agent
+
+### Mobile Access
+
+You can also access HiClaw from mobile devices using FluffyChat or Element Mobile:
+
+1. Download FluffyChat or Element on your phone
+2. Set homeserver to: `http://<your-lan-ip>:18080`
+3. Login with your admin credentials