github alibaba/hiclaw v1.0.6
on GitHub

latest releases: v1.0.8, v1.0.7
10 days ago

What's Changed

What's New

  • MCP Server Management Skill Enhancement — Manager now has a unified setup-mcp-server.sh script for runtime MCP server creation/update (GitHub as a special case with DNS service source). Manager can use mcporter CLI to list servers, view schemas, and call tools directly. Workers get an independent mcporter skill with MCP tool discovery and automatic SKILL generation — similar to the built-in github MCP tool, all calls are proxied through the AI gateway so Workers never see real credentials but can still use tools via SKILL. Config unified to ./config/mcporter.json (mcporter default path, no --config flag needed).

  • Slash Command Cross-Scenario Control — You can now @claw /reset in DM or group chat to reset context (fixes bugs or misconfig issues). @claw /stop interrupts long-running agent tasks — useful when a claw is stuck, allowing you to ask about progress and provide guidance. Manager can also use /stop to actively intervene Workers.

  • Optimized file sync design principle — unified to "writer pushes and notifies, receiver pulls on demand", with 5-min periodic pull as fallback only. Manager adds on-demand mc mirror pull in task/project completion flows to ensure reading fresh Worker results.

  • Added --no-reasoning flag to model-switch and worker-model-switch scripts to disable reasoning mode, patching the reasoning field in openclaw.json.

Bug Fixes

  • Fixed orphaned session write lock cleanup before OpenClaw startup — prevents "session file locked (timeout)" errors after SIGKILL or crash.

  • Fixed Remote->Local sync logic — only pulls Manager-managed allowlist files to avoid overwriting Worker-generated content (e.g. .openclaw sessions, memory).

  • Fixed Matrix room preset — switched back to trusted_private_chat so Workers auto-join without needing to accept invites.

  • Fixed mcporter config path compatibility — new path config/mcporter.json, old path mcporter-servers.json preserved as symlink for backward compatibility.

  • Fixed CoPaw mcporter config sync — correctly pulls config/mcporter.json from MinIO and copies to .copaw/config/mcporter.json.

  • Fixed *.lock file sync exclusion — Local->Remote sync excludes lock files to prevent stale session locks from being pushed to MinIO.

  • Fixed ELOOP symlink loop in Worker skills directory on container restart.

  • Fixed PowerShell window closing on error when run via double-click.

新增功能

  • MCP Server 管理技能完善 — Manager 新增统一的 setup-mcp-server.sh 脚本，支持运行时创建/更新任意 MCP Server（GitHub 为特殊 case 带 DNS 服务源配置）。Manager 可通过 mcporter CLI 列出服务器、查看 schema、直接调用工具。Worker 获得独立的 mcporter skill，支持 MCP 工具发现和自动生成 SKILL 文件，类似内置的 github MCP 工具：通过 AI 网关代理 MCP 调用，Worker 无法获取真实凭证，但可以基于 SKILL 安全使用。配置统一迁移到 ./config/mcporter.json（mcporter 默认路径）。

  • Slash Command 跨场景操控 — 现在可以在 DM（私聊）或 Group（群聊）中 @claw /reset 重置上下文（解决 bug 或误配置导致的问题），@claw /stop 打断 claw 的 agent 执行流程（当处理时间过长时可干预并追问进展）。Manager 可以利用 /stop 主动打断 Worker 进行指导干预。

  • 优化文件同步设计原则 — 统一为"写入者推送并通知，接收者按需拉取"，5 分钟定时拉取仅作为 fallback。Manager 在 task/project 完成流程中增加按需 mc mirror 拉取，确保读取 Worker 最新结果。

  • 新增 model-switch 和 worker-model-switch 的 --no-reasoning 标志，支持禁用 reasoning 模式。

Bug 修复

  • 修复 OpenClaw 启动前的孤立 session write lock 清理 — 防止 SIGKILL 或崩溃后出现 "session file locked (timeout)" 错误。

  • 修复 Remote->Local 同步逻辑 — 只拉取 Manager 管理的白名单文件，避免覆盖 Worker 生成的内容（如 .openclaw sessions、memory）。

  • 修复 Matrix room preset — 改回 trusted_private_chat，让 Worker 自动加入无需手动接受邀请。

  • 修复 mcporter 配置路径兼容性 — 新路径 config/mcporter.json，旧路径 mcporter-servers.json 保留软链接向后兼容。

  • 修复 CoPaw mcporter 配置同步 — 正确从 MinIO 拉取 config/mcporter.json 并复制到 .copaw/config/mcporter.json。

  • 修复 *.lock 文件同步排除 — Local->Remote 同步排除 lock 文件，防止过期 session lock 被推送到 MinIO。

  • 修复 Worker 容器重启时 skills 目录的 ELOOP 符号链接循环问题。

  • 修复 PowerShell 双击运行时出错窗口直接关闭的问题。

  • fix(worker): fix ELOOP symlink loop in skills directory on container restart (#262) (340bbce)
  • fix(install): persist HICLAW_LOCAL_ONLY and fix HOST_SHARE_DIR ordering in env file (#261) (1ced4dd)
  • fix(install): fix PS1 quickstart skipping network access mode prompt (#265) (9fba9cb)
  • fix(copaw_worker): render newlines as in Matrix HTML messages (#263) (ea25fbf)
  • fix(worker,copaw): Remote->Local sync allowlist for Manager-managed files only (#266) (05c5d05)
  • fix(manager): clean orphaned session write locks before starting OpenClaw (#267) (6a516c1)
  • feat(manager): add worker unresponsiveness policy and agent doc updates (#268) (5cc5929)
  • fix(manager): switch Matrix room preset back to trusted_private_chat for auto-join (da92852)
  • feat(manager): add --no-reasoning flag to model switch scripts (80073a7)
  • feat(manager): add unified setup-mcp-server.sh and rewrite mcp-server-management SKILL.md (7bf6883)
  • feat(manager): setup-mcp-server.sh generates Manager/Worker mcporter configs and notifies Workers (4060d04)
  • fix(manager,worker): push Worker mcporter config to MinIO; always set MCPORTER_CONFIG (3d0787d)
  • refactor: replace background Local->Remote sync with explicit push, unify file sync design principle (8732eaa)
  • docs(manager): add MinIO file pull guidance to TOOLS.md (60fb968)
  • docs(manager): add mcporter usage section to mcp-server-management SKILL.md (1792716)
  • feat(manager): extract mcporter into standalone skill for Manager and Worker (9bbf15d)
  • feat(worker,copaw): add mcporter skill as default built-in for OpenClaw and CoPaw workers (b3336b6)
  • refactor(manager,worker): move mcporter config to ./config/mcporter.json (default path) (e778e7f)
  • fix(copaw): pull config/mcporter.json from MinIO and copy into COPAW_WORKING_DIR (cde877d)
  • fix(copaw): add backward-compat fallback in pull_all for legacy mcporter-servers.json path (68632ee)
  • feat(manager): add mcporter to default Worker skills in create-worker.sh (11a5ed2)
  • feat(manager): add mcporter as builtin skill for both worker runtimes; use runtime-specific agent source in upgrade-builtins (9f38b88)
  • feat: support @mention + slash commands in group rooms (6185b50)
  • fix(worker,copaw): clean stale session locks on startup and exclude .lock from sync (c1728cf)
  • fix(copaw): fix mention-strip for slash commands in group rooms and DM (be855ee)
  • fix(manager): remove gemini-cli, claude-code, qodercli dependencies from image build (2ce7d72)

Docker Images

Multi-architecture images (amd64 + arm64): 

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

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

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.

Check out latest releases or
releases around alibaba/hiclaw v1.0.6

Don't miss a new hiclaw release

NewReleases is sending notifications on new releases.

Get notifications