安装与更新

本页帮助你选择安装包、完成首次启动，并在更新后确认资料可用。安装前结束正在执行的任务。

选择安装包

打开官方下载页，在下载按钮上展开版本列表。电脑类型不确定时不要仅凭文件名猜测。

电脑	如何确认	选择
Windows	设置 → 系统 → 系统信息，查看系统类型	Windows x64；其他架构先核对下载页的支持说明
Mac，Apple 芯片	苹果菜单 → 关于本机，显示 Apple M 系列芯片	Mac · Apple Silicon
Mac，Intel 处理器	苹果菜单 → 关于本机，显示 Intel	Mac · Intel

Windows 安装

1. 下载 Windows 安装程序，核对版本与文件名；需要时展开“安装与版本信息”核对 SHA-256。
2. 运行安装程序，按向导完成安装。系统提示风险时，先核对官网展示的签名状态与来源；来源不明或校验不符时停止安装。
3. 打开 ClawPi，等待工作台启动，按页面提示登录。
4. 完成一个简单任务，确认能收到回答并重新打开会话。

macOS 安装

1. 下载与芯片匹配的 DMG 文件并打开。
2. 按安装窗口提示将 ClawPI-H 拖入“应用程序”，从那里启动。
3. 如果 macOS 拦截首次打开，按下方步骤核对安装包并处理。
4. 遇到权限提示时按当前任务需要授权；安装完成不等于每种电脑操作都已获准。

不同平台的版本与能力可能不同。Windows 远程电脑控制的说明不代表 macOS 已提供同等功能。

首次打开被拦截

浏览器下载的应用可能带有 macOS 隔离标记。官网标为“未公证内部测试版”的 Mac 安装包没有 Apple 公证，首次打开可能被系统拦截。只对从官网下载、版本与 SHA-256 校验值一致的安装包执行以下操作；来源不明或校验不符时停止安装。

1. 在官网下载区选择对应的 Mac 版本，展开“安装与版本信息”查看 SHA-256。在终端输入 shasum -a 256 （末尾保留空格），将下载的 DMG 拖入终端以填入路径，按回车；确认输出的校验值与官网一致。

2. 确认 ClawPI-H.app 已放在“应用程序”中，并尝试打开一次。若出现拦截提示，打开“系统设置 → 隐私与安全性”，在底部选择“仍要打开”，按系统提示确认。

3. 如果仍无法打开且官网标为“未公证内部测试版”，打开“终端”，逐行运行以下命令；第一行报错时不要执行第二行：

   /usr/bin/xattr -dr com.apple.quarantine "/Applications/ClawPI-H.app"
   open "/Applications/ClawPI-H.app"

这些命令只移除该应用的隔离标记并尝试启动，不会为应用补上签名或公证。若命令报错或应用仍无法打开，记录错误并按排障指南处理；不要关闭系统整体安全保护。

更新后检查

先保存输出文件并结束任务，再通过客户端提示或官网下载更新。保留原有用户数据，不要通过清空应用数据“修复”更新。

检查项	应看到的结果
登录	原账号可正常进入工作台，或按提示重新登录
工作区	能打开原项目目录与历史会话
员工	原有部署可查看，任务可选择员工
消息渠道	账号状态正常，配对与工作区绑定仍可查看

如检查失败，记录版本、系统和错误提示，按排障指南处理，避免反复覆盖安装或删除资料。