alibaba/hiclaw v1.0.1 on GitHub

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.