Work Intelligence / Client Setup

客户端安装中心

为员工设备安装 ActivityWatch 与同步客户端。同步客户端会在设备本地生成 Canonical Snapshot，再上传工作状态事实汇总；不上传窗口标题、文件名、完整网页 URL 或输入内容。

安装前请由管理员分配设备编号、员工编号、设备 Token 与 HMAC Secret。请通过安全渠道单独发送凭据，不要将它们保存在聊天记录、截图或命令行历史中。安装器会校验同步组件和指定版本的 ActivityWatch 安装包。基础安装不包含 OpenClaw。

macOS 安装

适用于 Apple 芯片与 Intel Mac，以当前员工账户运行。

MAC
  1. 确认已安装 Python 3.10 或更高版本，并可访问公司服务地址。
  2. 下载并运行安装器，按提示输入管理员分配的设备信息。
  3. 首次启动后，在系统设置中授予 ActivityWatch“辅助功能”权限。
  4. 等待首次同步完成后，由管理员在后台确认设备状态。
curl -fsSLO https://cc.jiejingyun.org:10443/admin/client/install-macos.sh chmod 700 install-macos.sh ./install-macos.sh下载 macOS 安装器

日志位置

~/Library/Application Support/JiejingyunUsageCollector/

Windows 安装

适用于 Windows 10/11，以员工当前账户运行。

WIN
  1. 确认已安装 Python 3.10 或更高版本，并可访问公司服务地址。
  2. 以普通 PowerShell 运行安装器，按提示输入管理员分配的设备信息。
  3. 安装器会启动 ActivityWatch，并创建登录自启与每 5 分钟运行一次的同步计划任务。
  4. 等待首次同步完成后，由管理员在后台确认设备状态。
$file = "$env:TEMP\install-windows.ps1" iwr https://cc.jiejingyun.org:10443/admin/client/install-windows.ps1 -OutFile $file powershell -ExecutionPolicy Bypass -File $file下载 Windows 安装器

日志与配置位置

%LOCALAPPDATA%\JiejingyunUsageCollector\

Three steps

统一接入流程

01后台创建成员和设备

管理员记录设备编号，并通过安全渠道发送该设备的专属凭据。

02员工运行对应安装器

安装器下载同步组件、安装或启动 ActivityWatch，并配置后台同步。

03后台确认事实链路

等待首次同步后，在“设置 - 已登记设备”确认设备已出现、最后上报时间已更新。

Verification

安装后确认

A员工设备

ActivityWatch 已启动；macOS 已授予辅助功能权限；同步日志没有持续报错。

B管理员后台

设备显示为已登记，且最后上报时间在 5 至 10 分钟内更新。

C试点设备

如管理员额外启用 OpenClaw，确认其状态为 Shadow Read Only；它不参与事实采集，也不修改事实数据。

Troubleshooting

常见问题

安装后没有数据

确认 ActivityWatch 已启动并保持本地地址 127.0.0.1:5600 可用；macOS 还需确认辅助功能权限已授予。等待一个同步周期后，再由管理员查看最后上报时间。

脚本提示校验失败

请重新从本页面下载最新版安装器。安装器会验证同步组件文件，校验失败时不会继续安装。

OpenClaw

基础安装包只部署 ActivityWatch 与 Sync Agent。OpenClaw 仅由管理员为已授权试点设备单独启用，当前只读本地脱敏快照并以 Shadow 模式运行；员工无需配置模型、Agent Token 或任何 AI 密钥。

请勿把设备 Token、HMAC Secret 或管理员 Token 发到公共群聊。后续如启用注册码接入，将不再要求员工手动处理长期设备凭据。