v1.0.4

What's Changed

What's New

• Added CoPaw Worker container support — new copaw/Dockerfile, container lifecycle management (container_create_copaw_worker), random host port assignment with auto-retry on conflict, and on-demand web console toggle (enable-worker-console.sh).
• Added CoPaw Worker runtime package (copaw-worker CLI) that bridges openclaw.json → CoPaw config, implements MatrixChannel for Matrix communication, syncs config/skills from MinIO, and supports bidirectional file sync (remote→local + local→MinIO push loop).
• Added CoPaw remote deployment mode (--runtime copaw --remote) — installs the Worker directly on the user's local machine via pip, enabling tasks that require local environment access (e.g., opening a browser, running desktop apps, accessing local files). Remote copaw installs auto-include --console-port 8088 by default.
• Added worker runtime selection prompt to install scripts — users choose between OpenClaw and CoPaw during installation; default runtime stored in HICLAW_DEFAULT_WORKER_RUNTIME env var and used by create-worker.sh.
• Extracted worker model switch into standalone worker-model-switch skill.
• Added AI identity section to SOUL.md and User-Agent header (HiClaw/<version>) to AI route.

Bug Fixes

• Fixed CoPaw bridge.py path constants causing 401 AuthenticationError on LLM calls, and Podman container detection (/run/.containerenv) causing Matrix connection timeout.
• Fixed CoPaw MatrixChannel not mentioning sender in replies (manager ignored worker replies).
• Unified worker file-sync notification and task/project notification paths to work with both OpenClaw and CoPaw runtimes.
• Fixed model input field to be dynamic based on model vision capability instead of hardcoded.
• Fixed container timezone configuration from TZ env var.

新增功能

• CoPaw Worker 容器化支持 — 新增 copaw/Dockerfile、容器生命周期管理（container_create_copaw_worker）、随机 host port 分配与端口冲突自动重试、按需开关 Web 控制台（enable-worker-console.sh）。
• CoPaw Worker 运行时包（copaw-worker CLI）— 桥接 openclaw.json 到 CoPaw 配置、实现 MatrixChannel 通信、从 MinIO 同步配置和技能、支持双向文件同步（远程→本地 + 本地→MinIO 推送）。
• CoPaw 远程部署模式（--runtime copaw --remote）— 通过 pip 将 Worker 安装在用户本地机器上，支持需要访问本地环境的任务（如打开浏览器、运行桌面应用、访问本地文件）。远程 copaw 安装命令默认自带 --console-port 8088。
• 安装脚本新增 Worker 运行时选择提示 — 用户在安装时选择 OpenClaw 或 CoPaw，默认运行时存入 HICLAW_DEFAULT_WORKER_RUNTIME 环境变量，create-worker.sh 自动使用。
• Worker 模型切换拆分为独立 worker-model-switch skill。
• SOUL.md 新增 AI 身份声明，AI 路由新增 User-Agent 头（HiClaw/<version>）。

Bug 修复

• 修复 CoPaw bridge.py 路径常量导致 LLM 调用 401 认证错误，以及 Podman 容器环境检测（/run/.containerenv）导致 Matrix 连接超时。

• 修复 CoPaw MatrixChannel 回复未携带发送者信息（Manager 忽略 Worker 回复）。

• 统一 Worker 文件同步通知和任务/项目通知路径，兼容 OpenClaw 和 CoPaw 两种运行时。

• 修复模型 input 字段根据视觉能力动态设置，不再硬编码。

• 修复容器时区配置（通过 TZ 环境变量）。

• feat(manager): add AI identity section to Manager and Worker SOUL.md templates, ensuring agents understand they are AI not human and can work continuously (ecca010)

• fix: set container timezone from TZ env var in both Manager and Worker (install tzdata in base image, configure /etc/localtime and /etc/timezone at startup)

• feat(manager): add User-Agent header (HiClaw/) to default AI route via headerControl, and send it in LLM connectivity tests (3242d06)

• feat(openclaw-base): install cron package in base image, start crond in Manager (supervisord) and Worker (entrypoint)

• fix(manager): unify worker file-sync notification — replace runtime-specific hiclaw-sync command with generic "use your file-sync skill" message in lifecycle-worker.sh, push-worker-skills.sh, create-worker.sh, and start-manager-agent.sh; update worker-management/SKILL.md accordingly

• fix(manager): fix create-worker.sh to push runtime-specific AGENTS.md for copaw workers instead of always using openclaw's worker-agent/AGENTS.md

• feat(manager): add copaw-worker-agent/AGENTS.md describing copaw worker workspace layout and MinIO-based file access (no ~/hiclaw-fs/ mount)

• fix(manager): update task/project notification messages in task-management/SKILL.md and project-management/SKILL.md to use MinIO paths (hiclaw/hiclaw-storage/...) instead of local ~/hiclaw-fs/ paths, compatible with both openclaw and copaw workers

• fix(worker): update file-sync/SKILL.md to document MinIO→local path mapping so worker knows where to find files after hiclaw-sync

• fix(copaw): patch copaw module-level path constants (WORKING_DIR, SECRET_DIR, _PROVIDERS_JSON) at runtime in bridge.py so providers.json is written to and read from the correct worker-specific directory (fixes 401 AuthenticationError on LLM calls)

• feat(copaw): add copaw/ package — HiClaw's CoPaw Worker runtime (copaw-worker CLI) that bridges openclaw.json → CoPaw config, implements MatrixChannel, and syncs config from MinIO

• fix(manager): copaw install command now uses HICLAW_PORT_GATEWAY (external port) instead of internal :8080 so the command works on the host machine

• feat(copaw): add optional --console-port to copaw-worker; headless mode saves ~500MB RAM; startup prints memory tip in both cases; SKILL.md and create-worker.sh updated accordingly

• fix(copaw): fix MatrixChannel not mentioning sender in replies (missing sender_id in meta payload caused manager to ignore worker replies)

• feat(copaw): sync skills from MinIO on startup (_sync_skills)

• feat(copaw): rewrite sync.py to use mc CLI for all MinIO operations (mc cat, mc ls, mc alias set); remove httpx + AWS Signature V4 implementation

• feat(copaw): add CoPaw-specific file-sync skill (manager/agent/copaw-worker-agent/skills/file-sync/) with copaw-sync.py script for manual sync trigger; create-worker.sh selects runtime-specific file-sync skill from /opt/hiclaw/agent/copaw-worker-agent/ for copaw runtime

• feat(copaw): add local→MinIO change-triggered push loop (push_loop / push_local in sync.py); started alongside the existing remote→local sync loop in worker.py; mirrors openclaw worker entrypoint behavior (5s poll, excludes .copaw/ internals)

• fix(manager): add explicit runtime determination step (Step 0) to worker-management/SKILL.md so Manager auto-detects --runtime copaw from keywords like "copaw", "Python worker", "pip worker" in admin requests, preventing accidental openclaw container creation

• feat(manager): extract worker model switch into standalone worker-model-switch skill (SKILL.md + update-worker-model.sh); remove update-model action from lifecycle-worker.sh and model-related docs from worker-management/SKILL.md

• feat(copaw): seed CoPaw built-in skills (pdf, xlsx, docx, etc.) as base layer before overlaying Manager-pushed skills from MinIO in _sync_skills

• fix(manager): make model input field dynamic instead of hardcoded ["text", "image"] — deepseek, glm-5, MiniMax-M2.5, kimi-k2.5 and default models now correctly get ["text"] only; affects both json templates, model-switch scripts, and worker config generation

• feat(copaw): add copaw/Dockerfile and entrypoint for building hiclaw/copaw-worker container image; add container_create_copaw_worker in container-api.sh with random host port (10000-20000) and auto-retry on port conflict (810d21a)

• feat(manager): add enable-worker-console.sh to enable/disable CoPaw web console on demand by recreating the container (~500MB RAM saved when disabled) (810d21a)

• feat(manager): create-worker.sh defaults to HICLAW_DEFAULT_WORKER_RUNTIME env var; remote copaw installs auto-include --console-port 8088 (810d21a)

• feat(install): add worker runtime selection prompt (OpenClaw ~500MB vs CoPaw ~100MB) to both bash and PowerShell install scripts; write HICLAW_DEFAULT_WORKER_RUNTIME to env file (810d21a)

• fix(copaw): detect Podman containers via /run/.containerenv in bridge.py (fixes Matrix connection timeout in Podman deployments) (810d21a)

Docker Images

Multi-architecture images (amd64 + arm64):

# Manager
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-manager:v1.0.4

# Worker
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-worker:v1.0.4

Quick Start

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/alibaba/hiclaw/main/install/hiclaw-install.sh)

Windows (PowerShell 7+)

Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://higress.ai/hiclaw/install.ps1'))

Documentation

For more details, see the installation guide.

v1.0.3

What's Changed

• fix(manager): propagate Manager TZ env to Worker containers — container-api.sh (local socket mode), create-worker.sh (remote install command), and install_worker in hiclaw-install.sh all now pass TZ so Worker timezone matches Manager

Docker Images

Multi-architecture images (amd64 + arm64):

# Manager
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-manager:v1.0.3

# Worker
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-worker:v1.0.3

Quick Start

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.sh)

Windows (PowerShell 7+)

Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://higress.ai/hiclaw/install.ps1'))

Documentation

For more details, see the installation guide.

v1.0.2

What's Changed

• fix(manager): wait for Tuwunel via /_tuwunel/server_version in start-manager-agent.sh; add explicit Matrix ready check in install scripts before sending welcome message
• feat(manager): add "Sending Files to Admin" constraint to TOOLS.md — upload to Matrix media server and reply with MEDIA: <mxc://...> format
• feat(manager): add "Upload a File (Media Upload)" section to matrix-server-management SKILL.md with full curl examples

Docker Images

Multi-architecture images (amd64 + arm64):

# Manager
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-manager:v1.0.2

# Worker
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-worker:v1.0.2

Quick Start

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.sh)

Windows (PowerShell 7+)

Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://higress.ai/hiclaw/install.ps1'))

Documentation

For more details, see the installation guide.

v1.0.1

What's Changed

What's New

• Added model-switch and task-management skills to the Manager Agent, enabling runtime LLM model switching and structured task workflow management.
• Added TOOLS.md quick-reference cheat sheets for both Manager and Worker, consolidating tool trigger rules, multi-worker collaboration requirements, and post-worker-creation onboarding guidance.
• Release workflow now opens a PR instead of pushing directly to main, and supports manual trigger via workflow_dispatch with a version input.

Bug Fixes

• Fixed multiple shell traps in builtin-merge.sh: empty user content causing set -e exit, silent write/move failures now emit ERROR logs.
• Fixed Podman compatibility (replaced hardcoded docker with runtime detection), jq unavailability inside container, and Tuwunel API readiness race condition on startup.
• Fixed worker openclaw.json missing admin in dm.allowFrom, preventing admin from DMing workers directly.

新增功能

• Manager Agent 新增 model-switch（运行时切换 LLM 模型）和 task-management（任务工作流与状态文件规范）两个 skill。
• Manager 和 Worker 各新增 TOOLS.md 快速参考手册，集中整理工具触发规则、多 Worker 协作强制走 project-management 的规定，以及 Worker 创建后的 onboarding 提示。
• Release workflow 改为开 PR 而非直接 push main，并支持通过 workflow_dispatch 手动输入版本号触发发布。

Bug 修复

• 修复 builtin-merge.sh 多处 shell 陷阱：空 user content 触发 set -e 退出、写文件/移动文件失败静默吞错，现在均会打出 ERROR 日志。

• 修复 Podman 兼容性（硬编码 docker 改为运行时检测）、容器内 jq 不可用、Tuwunel API 就绪前 Manager 提前初始化的竞态问题。

• 修复 worker openclaw.json 的 dm.allowFrom 未包含 admin 账号，导致 admin 无法直接 DM worker 的问题。

• feat(manager): add model-switch skill with update-manager-model.sh script for runtime model switching (00cbaa5)

• feat(manager): add task-management skill (extracted from AGENTS.md) covering task workflow and state file spec (00cbaa5)

• feat(manager): add manager/scripts/lib/builtin-merge.sh — shared library for idempotent builtin section merging (00cbaa5)

• fix(manager): fix upgrade-builtins.sh duplicate-insertion bug — awk now uses exact line match, preventing repeated marker injection on re-run (00cbaa5)

• fix(manager): detect and auto-repair corrupted AGENTS.md when marker count != 1 or heading is duplicated (47c5578, c28f82d, 078f3f8)

• feat(manager): expand worker-management skill and lifecycle-worker.sh with improved worker lifecycle handling (00cbaa5)

• fix(manager): setup-higress.sh — multiple route/consumer/MCP init fixes (d259177)

• fix(manager): start-manager-agent.sh — wait for Tuwunel Matrix API ready before proceeding, add detailed logging for token acquisition (d259177, 1a9e1d8)

• fix(manager): support Podman by replacing hardcoded docker commands with runtime detection; fix jq availability inside container; fix provider switch menu text (9d57ef8)

• fix(manager): force rewrite corrupted AGENTS.md without preserving user content (639d0c6)

• feat(manager): add TOOLS.md for Manager — management skills quick-reference cheat sheet, extracted from AGENTS.md (905294f)

• feat(manager): add TOOLS.md for Worker — find-skills priority guidance for unknown problems (905294f)

• feat(manager): add post-worker-creation onboarding tips to TOOLS.md (aa694fc)

• feat(manager): add project-management mandatory rule to TOOLS.md (0c7d437)

• feat(manager): upgrade-builtins.sh deploys Worker TOOLS.md to MinIO and all registered worker workspaces (905294f)

• fix(manager): worker-openclaw.json.tmpl — add admin to dm.allowFrom so admin can DM workers directly (406d249)

• fix(manager): builtin-merge.sh — add || true to grep -v to prevent set -e exit on empty user content (d8b1cf7)

• fix(manager): builtin-merge.sh — add explicit ERROR logging on all write/move failures so startup failures are visible in logs (bf35d5a)

• fix(manager): builtin-merge.sh — replace [ -n ] && printf with if/fi to avoid exit 1 when user_content is empty (df134fd)

• fix(manager): upgrade-builtins.sh — replace silent || true with WARNING log when worker-skill MinIO publish fails (bf35d5a)

• ci: release workflow now opens a PR (chore/archive-changelog-vX.Y.Z) instead of pushing directly to main (f07de3a)

• ci: release workflow supports workflow_dispatch with version input for manual release trigger (64f25cb)

Docker Images

Multi-architecture images (amd64 + arm64):

# Manager
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-manager:v1.0.1

# Worker
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-worker:v1.0.1

Quick Start

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.sh)

Windows (PowerShell 7+)

Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://higress.ai/hiclaw/install.ps1'))

Documentation

For more details, see the installation guide.

v1.0.0

Docker Images

Multi-architecture images (amd64 + arm64):

# Manager
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-manager:v1.0.0

# Worker
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-worker:v1.0.0

Quick Start

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.sh)

Windows (PowerShell 7+)

Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://higress.ai/hiclaw/install.ps1'))

Documentation

For more details, see the installation guide.

v0.9.11

Docker Images

Multi-architecture images (amd64 + arm64):

# Manager
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-manager:v0.9.11

# Worker
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-worker:v0.9.11

Quick Start

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.sh)

Windows (PowerShell 7+)

Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://higress.ai/hiclaw/install.ps1'))

Documentation

For more details, see the installation guide.

v0.9.10

Docker Images

Multi-architecture images (amd64 + arm64):

# Manager
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-manager:v0.9.10

# Worker
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-worker:v0.9.10

Quick Start

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.sh)

Windows (PowerShell 7+)

Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://higress.ai/hiclaw/install.ps1'))

Documentation

For more details, see the installation guide.

v0.9.9

Docker Images

Multi-architecture images (amd64 + arm64):

# Manager
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-manager:v0.9.9

# Worker
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-worker:v0.9.9

Quick Start

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.sh)

Windows (PowerShell 7+)

Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://higress.ai/hiclaw/install.ps1'))

Documentation

For more details, see the installation guide.

v0.9.8

Docker Images

Multi-architecture images (amd64 + arm64):

# Manager
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-manager:v0.9.8

# Worker
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-worker:v0.9.8

Quick Start

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.sh)

Windows (PowerShell 7+)

Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.ps1" -UseBasicParsing).Content

Or download and run:

# Download
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.ps1" -OutFile "hiclaw-install.ps1"

# Run
.\hiclaw-install.ps1

Documentation

For more details, see the installation guide.

v0.9.7

Docker Images

Multi-architecture images (amd64 + arm64):

# Manager
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-manager:v0.9.7

# Worker
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/higress/hiclaw-worker:v0.9.7

Quick Start

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.sh)

Windows (PowerShell 7+)

Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.ps1" -UseBasicParsing).Content

Or download and run:

# Download
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/higress-group/hiclaw/main/install/hiclaw-install.ps1" -OutFile "hiclaw-install.ps1"

# Run
.\hiclaw-install.ps1

Documentation

For more details, see the installation guide.