核心用法
Clawsy 作为 OpenClaw Agent 的 macOS 原生伴侣应用，通过 WebSocket（支持 SSH 隧道回退）建立安全连接，赋予 AI 代理真实的系统交互能力。首次配对时，通过 clawsy://pair?code= 链接完成设备绑定，后续所有操作通过 nodes 工具调用。
主要功能调用方式：
- 截屏/相机：
nodes(action="invoke", invokeCommand="screen.capture"/"camera.snap") - 剪贴板读写：
clipboard.read/clipboard.write，支持文本双向同步 - 文件系统：
file.list/get/set/mkdir/delete操作共享文件夹（默认~/Documents/Clawsy） - 任务可视化：通过
agent.status事件在 Clawsy UI 实时展示进度条（Mission Control） - 快捷输入：用户通过
⌘⇧K发送的文本及遥测数据（电量、热状态、活跃应用等）进入clawsy-service会话
显著优点
1. 原生级系统集成：作为 macOS 菜单栏应用，深度整合 FinderSync、Share Extension、全局热键，用户体验接近第一方工具
2. 实时双向通道：WebSocket 低延迟推送（截图、剪贴板变化、用户快捷输入），告别轮询模式
3. 智能遥测：moodScore、isUnusualHour 等信号帮助 Agent 感知用户状态，实现上下文感知响应
4. 多主机支持：单 Mac 可同时连接多个 OpenClaw 网关，每个主机隔离配置与共享文件夹
5. 开源可审计：代码完全公开，社区可审查安全实现
潜在缺点与局限性
1. 平台锁定：仅支持 macOS 14+，Windows/Linux 用户无法使用
2. 权限门槛高：需用户手动开启屏幕录制、辅助功能、Finder 扩展等多项系统权限，首次设置流程较长
3. 文件传输限制：JSON 参数限制约 50KB，大文件需回退到 CLI 直接调用，增加使用复杂度
4. 网络依赖：直接 WebSocket 连接要求网关可被公网或 Tailscale/LAN 访问，复杂网络环境需配置 SSH 隧道
5. 单点信任：设备配对码及 token 管理完全依赖 OpenClaw 网关，若网关被攻破，Mac 面临远程控制风险
适合人群
- 重度 macOS 用户，希望 AI Agent 能直接操作本地文件、截屏协助排查问题
- 远程工作者，需要 Agent 实时感知设备状态（电量、热状态、活跃应用）并调整任务策略
- 开发者/技术爱好者，愿意配置权限、排查网络，换取更深度的系统集成
常规风险
- 隐私暴露：截屏、相机、剪贴板、文件系统访问涉及敏感数据，需确保 OpenClaw 网关及传输通道可信
- 权限维持：系统升级或安全更新可能重置权限，导致功能中断
- 会话隔离：
clawsy-service会话与主聊天分离，Agent 需主动查询，存在信息遗漏风险