安装 Clawuno
macOS
系统要求:Apple Silicon Mac,macOS 13.5 或更高版本。
- 下载 Clawuno 0.8.4 macOS 安装包。
- 打开“终端”,运行
shasum -a 256 ~/Downloads/Clawuno-0.8.4.dmg。与 0.8.4 Mac 发行清单 中 DMG 的 SHA-256 比较,并核对版本和文件名确为 0.8.4;不要使用其他版本的校验值。 - 打开 DMG,将 Clawuno 移入“应用程序”。
- 从“应用程序”启动 Clawuno。如果 macOS 提示签名无效,不要绕过安全检查,应重新下载官方安装包。
- 等待 Engine 启动,然后在 App 中完成首次设置。
macOS App 负责本机 Engine 的生命周期:打开 App 时启动,退出 App 时停止由它管理的 Engine 和 Scheduler。只要 Mac 用户保持登录并让 Clawuno 持续运行,这个完整 Engine 也可以供远程 Desktop 或浏览器客户端访问。对外提供前应设置受保护的 HTTPS/私有网络地址,并使用在 系统设置 → 用户 → 设置远程登录 配置的管理员邮箱和密码验证远程登录。
Windows
系统要求:Windows x64,并且有已登录的桌面用户会话。
0.8.4 安装器采用 Azure Artifact Signing Public Trust,不再使用 0.8.1 的自签名证书。SmartScreen 信誉和组织策略是独立检查,签名有效不代表一定没有提示。请核对签名及准确文件哈希;不一致时停止,不要关闭安全防护来绕过。
- 下载 Clawuno 0.8.4 Windows Setup。
- 在下载目录打开 PowerShell,验证文件:
Get-FileHash .\Clawuno-0.8.4-windows-x64-Setup.exe -Algorithm SHA256
结果必须与 0.8.4 签名发行清单 中 Windows x64 Setup 的 SHA-256 一致,并核对准确版本和文件名。清单不可用或哈希不同,都应停止。
- 确认签名有效、文件哈希与该版本发行清单一致后再运行 Setup;不要关闭安全防护来绕过不一致。
- 从“开始”菜单启动 Clawuno,等待受管 Engine 就绪。
- 在 Desktop App 中完成首次设置。
Clawuno Desktop 和 Engine Host 运行在当前用户的交互式会话中。只要该用户保持登录并让 Clawuno 持续运行,这个完整 Windows Engine 也可以供远程 Desktop 或浏览器客户端访问。对外提供前应设置受保护的 HTTPS/私有网络地址,并使用在 系统设置 → 用户 → 设置远程登录 配置的管理员邮箱和密码验证远程登录。如果 Engine 必须在没有桌面用户登录时无人值守运行,Linux Docker 仍然更合适。
Linux
系统要求:x86-64 或 ARM64 Linux、Docker Engine、Docker Compose v2、Python 3.9 或更高版本、curl 与 openssl。安装和解压期间至少预留 12 GiB 可用空间。安装器会自动选择与宿主架构匹配的签名镜像。
Docker 本身是独立前置条件:Clawuno CDN 分发 Clawuno,不提供 Docker Engine 或 Compose。部署前先准备 Docker,并确认可以访问 daemon。
从 0.8.4 起,Linux 安装和升级在全球统一使用 Clawuno 发布 CDN,不按地区选择来源,也不再新增 GHCR 发行。首次安装和所有现有 0.8.1–0.8.3 安装,无论原来使用哪个下载来源,都运行同一个命令:
curl -fsSL https://releases.clawuno.com/install.sh | bash
已有安装只需执行一次,迁移选定实例并更新宿主管理工具,保留原有数据。先等待正在执行的工作结束;迁移可能中断选中实例。多实例时添加 --instance NAME 或 --dir PATH 指定目标;如需固定版本,添加 --version 0.8.4:
curl -fsSL https://releases.clawuno.com/install.sh | bash -s -- --version 0.8.4 --instance NAME
将 NAME 替换为目标实例名称,或改用 --dir /absolute/deployment/path。无人值守迁移须先明确授权中断正在执行的工作,再添加 --yes:
curl -fsSL https://releases.clawuno.com/install.sh | bash -s -- --instance NAME --yes
完成一次性迁移后,后续升级统一使用宿主命令:
sudo clawuno upgrade
升级命令同样支持 --version VERSION,以及 --instance NAME 或 --dir PATH。自动化升级须以 --yes 授权中断。旧管理工具如提示更新安装器,应运行 install.sh 迁移,而不是反复重试旧命令。
下载内容须匹配签名发布元数据,包括归档大小、SHA-256 和镜像身份。缓存归档及已加载镜像只有验证通过后才可复用,同名 tag 不能作为信任依据。已有下载文件可通过安装器或升级命令的 --archive /absolute/path/image.tar.gz 提供,仍须匹配签名发布元数据,不能绕过验证。同镜像重复升级不会重启 Engine 或改动数据,即使本次更新了宿主管理工具。
install-cn.sh 保留为原样传递参数的兼容别名,不再代表独立地区来源。历史签名文件、归档和已发布镜像保留用于恢复,不删除或改写。恢复必须使用匹配的镜像和数据快照,不能直接用旧代码运行新版数据。
默认只绑定宿主机 loopback。不要把 Engine 直接暴露到公网;远程访问应通过带认证的反向代理或 SSH 隧道。
安装完成后检查:
sudo clawuno list
sudo clawuno status
如需再次显示专属的管理员初始化链接,请在 Linux 服务器运行 sudo clawuno open。如果使用 HTTPS 反向代理,只把链接中的 http://localhost:<端口> 替换为自己的 HTTPS 域名,并完整保留 /sign-in#setup_token=... 后缀。链接中包含创建首位管理员所需的私密安装凭证,请勿转发。
验证安装结果
完成设置后逐项确认:
- 显示的版本号与安装目标一致(
0.8.4); - 重启后仍可正常登录;
- 模型连接可以通过测试;
- 能创建 Workspace、Agent、Chat 和 Work;
- 小文件上传、下载前后的内容一致。
如果 Engine 无法启动,请进入故障排查,不要在同一份数据上反复覆盖安装。