Claw 部署

一句话总结：Claw 是真正干活的执行引擎。日常新增主机请直接在 Client 里点「添加 Claw」按钮；脚本方式留给批量部署、自动化或不方便打开桌面端的场景。

什么时候需要再装一台 Claw

• 想把某个任务放到办公室电脑、家里 Mac Mini、云主机或内网服务器。
• 给团队搭多机器 AI 运维池。
• 在不同主机间挑选执行环境（GPU、内网访问、特定工具链）。

推荐：在 Client 里添加 Claw

这是最适合大多数人的方式：

1. 打开 Client，进入「Claw 管理」。
2. 点「添加 Claw」按钮。
3. 选择目标平台（macOS / Linux / Windows），界面会按你 Admin 的实际域名生成完整命令。
4. 按引导一步步执行；几秒后新 Claw 会出现在列表并显示在线。
5. 重命名一下，便于在对话页里识别。

整个过程在桌面端进行，不需要你手工拼接 URL 或猜测安装参数。

进阶：脚本 / 自动化方式

用脚本的典型场景：批量铺到多台主机、CI/CD 流水线里自动装、远程服务器上没法跑桌面端。命令统一从 Admin 同源分发：

bash复制
curl -fsSL https://myclaws.weid.fun/install/claw.sh | bash

powershell复制
irm https://myclaws.weid.fun/install/claw.ps1 | iex

脚本会下载 runtime、安装到 ~/.myclaws/claw/、注册后台服务、自动连 Admin。注意：URL 中的域名必须与你访问 Admin 的域名一致，跨域名安装会失败。

安装目录与服务身份

• 所有 Claw 统一安装到 ~/.myclaws/claw/。
• 服务身份统一使用 generic identity：io.myclaws.claw / myclaws-claw / MyClawsClaw。
• 这意味着同一台主机只能有一个生效 Claw（启动仲裁单活约束）。

控制语义四桶

• client-managed：由当前桌面端直接控制（启停、重启、恢复）。
• service-managed：由所在主机的常驻机制持续维持，不依赖桌面端。
• legacy_unmanaged：历史接入但未纳入统一控制体验。
• unknown_shared：能看到但无法判定控制权。

四桶互斥，平台按规则归桶。

自更新与版本切换

Claw 启动后会定期向 Admin 上报版本；新版本可用时管理页提供「更新」按钮。 更新过程自动下载新 runtime、停旧、起新、保持身份不变。

直连地址与跨 Admin

Admin 中转之外，Claw 也支持直连模式。 桌面端可查看、设置、修改、清空直连地址；新会话立即使用新地址，既有会话提示用户手动重连。

卸载与日志

• 在 Claw 管理页选择目标 Claw → 卸载。
• 系统会停止服务、清理 runtime 目录，并撤销 Admin 注册。
• ~/.myclaws/claw/data/ 中的对话与 Skill 不会被自动删除（防误删）。
• 每台 Claw 提供最新日志入口（按服务身份采集，含进程 stderr/stdout）。

单活约束与跨主机迁移

相关

• 快速开始
• 子代理编排
• 桌面端高级