用途:面向管理员,通过 hiclaw 命令行手工创建、重置、启停 Worker,管理 Worker 技能、开启同伴 @提及、打开 QwenPaw 控制台,以及切换 Worker 运行时。
主要能力:创建 Worker 前需向管理员确认四项输入——名称(须匹配 ^[a-z0-9][a-z0-9-]*$,且长度大于 3)、运行时(openclaw/Node.js、copaw/Python、hermes/Python、openhuman/Rust,默认值读取 ${HICLAW_DEFAULT_WORKER_RUNTIME},未设置时回退 openclaw)、SOUL 角色描述、技能(通过 ls ~/worker-skills/ 发现,file-sync、task-progress、project-participation 为自动包含且不可移除)。支持用 hiclaw create worker 快速创建,SOUL 内容通过 --soul 内联传入,--no-wait 立即返回后轮询 hiclaw get workers -o json 等待 phase=Running。资源限制需用 YAML Worker 清单配合 hiclaw apply -f。切换运行时用 scripts/update-worker-config.sh --runtime,会删除旧容器并按目标镜像重建。
使用方式:按操作参考表读取对应文档后执行,如创建读 references/create-worker.md,生命周期读 references/lifecycle.md,技能管理读 references/skills-management.md,控制台读 references/console.md,同伴提及读 references/peer-mentions.md。
限制:--remote 仅支持 copaw,含义是相对 Manager 远程、实际在管理员本机;切换运行时为破坏性操作,容器本地状态(缓存、内存会话、当前任务进度)会丢失,Matrix 账号、房间、网关消费者、MinIO 数据与凭据保留;Matrix 账号持久存在于 Tuwunel,无法通过 API 删除,重置时复用同一用户名;Worker 无状态,状态集中在存储中;开启同伴提及后需明确告知 Worker 仅在被阻塞信息时 @同伴,避免循环;写入文件后应通知 Worker 执行 file-sync。其余细节暂未提供。