安装 UUMit 电脑客户端

你能做到什么

装好客户端后，这台电脑上的应用才能通过你的 Agent 网址被打开。客户端不需要管理员权限，不改系统网络，也不在电脑上开放端口。

系统要求

系统	版本	架构
macOS	13 及以上	Apple 芯片、Intel
Windows	10、11	x64
Linux	Ubuntu 22.04 / 24.04、Debian 12	x64、arm64
Docker	Engine 24 及以上	x64、arm64

安装

下载 macOS 安装包，打开后把 UUMit 拖进「应用程序」。
第一次打开时，UUMit 会自动打开浏览器，进入「连接这台电脑」。
核对确认码，点「是我的电脑，连接」。

下载与系统对应的 .deb 安装包并安装：
Terminal window
```
sudo apt install ./uumit-connector_<版本>_amd64.deb
```
连接这台电脑。终端会打印确认网址和二维码，用手机打开确认：
Terminal window
```
sudo -u uumit UUMIT_CONNECTOR_HOME=/var/lib/uumit-connector uumit-connector connect
```
启动后台运行（开机自动启动）：
Terminal window
```
sudo systemctl enable --now uumit-connector
```

只给当前用户使用时，也可以用用户级后台运行：systemctl --user enable --now uumit-connector。

把客户端和 OpenClaw 写在同一个 compose 文件里，凭证放在挂载卷中（只有容器用户可读）：

services:
  openclaw:
    image: <OpenClaw 镜像>
  uumit:
    image: <UUMit 客户端镜像，以发布页为准>
    command: ["run", "--headless"]
    volumes:
      - uumit-data:/data
    restart: unless-stopped
volumes:
  uumit-data:

第一次启动后查看日志里的确认网址：docker compose logs uumit，用手机打开确认。

校验安装包

发布页为每个安装包提供 SHA-256。下载后对照：

shasum -a 256 <安装包文件>

Get-FileHash <安装包文件> -Algorithm SHA256

sha256sum <安装包文件>

结果和发布页不一致时，不要安装，重新从官网下载。

杀毒软件拦截怎么办

发生了什么：杀毒软件提示拦截或隔离 UUMit。为什么：客户端会建立长期的出站连接，部分杀毒软件会对这类行为提示。怎么修：先按上一节核对 SHA-256；一致后在杀毒软件里把 UUMit 加入信任列表。各主流杀毒软件的处理说明会在验证完成后补充到这里。

国内下载慢

Docker 镜像会提供国内地址，正式发布时在这里补齐。

常用命令

想做什么	命令
查看状态	`uumit-connector status`
暂停全部应用	`uumit-connector pause`
恢复	`uumit-connector resume`
检查更新	`uumit-connector update --check`
生成诊断包（不含凭证）	`uumit-connector diag`

卸载与换电脑

换电脑时，先在网页「我的电脑」里移除旧电脑，再在新电脑上连接，网址不变。
断开这台电脑：uumit-connector unpair --yes，然后按系统常规方式卸载。
Linux 卸载后会保留 /var/lib/uumit-connector，确认不再使用后可手动删除。