核心用法
Clawvisor 充当 AI 代理与外部服务之间的安全网关，所有操作均需经过其审查。典型工作流程包括：获取服务目录 → 创建任务并声明授权范围 → 执行网关请求 → 完成任务。支持两种任务模式：临时任务（有 TTL 限制）和常驻任务（跨会话持久）。常驻任务必须使用 session_id 进行链式上下文验证，防止跨会话数据污染。
关键特性包括：
- 双重授权层：先应用用户设置的硬限制（Restrictions），再验证任务范围（Tasks）
- 凭证注入：Clawvisor 负责管理 API 密钥，代理永不直接接触
- 人机审批流：写操作需逐次人工确认，读操作可按策略自动执行
- 意图验证：通过 LLM 验证请求理由与任务目的的一致性，防范提示注入攻击
- 链式上下文验证：确保后续操作针对的是之前结果中出现的实体
显著优点
1. 零信任安全架构：代理不持有任何凭证，所有敏感操作经 Clawvisor 中转
2. 精细化权限控制：支持按任务、按操作、按时间的多维授权策略
3. 审计与合规：完整的操作理由记录、数据来源追踪（data_origin）和审批日志
4. 防提示注入：专门的意图验证层识别「用户让我做」等可疑表述
5. 灵活部署：支持本地实例、云中继，可选 E2E 加密
潜在缺点与局限性
- 设置复杂度高：需配置三个环境变量、仪表板注册、服务激活、策略设置
- 审批延迟：非自动执行操作需等待人工确认，可能中断工作流
- 常驻任务管理负担：需自行生成和维护
session_id，遗漏会导致请求被拒 - 链式验证的学习曲线：
$chain占位符、planned_calls预注册等概念需要理解 - 依赖外部基础设施：Clawvisor 服务本身的可用性成为关键路径
适合人群
- 安全意识强的个人用户：希望使用 AI 管理邮件、日历、消息但不愿暴露 API 密钥
- 小型团队/初创公司：需要为 AI 助手建立可控的数据访问边界
- 合规敏感场景：需要审批留痕、数据来源追踪的自动化工作流
- macOS 生态用户：iMessage 集成是少数支持 Apple 原生消息的方案
常规风险
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| 令牌泄露 | `CLAWVISOR_AGENT_TOKEN` 是高权限凭证 | 使用最小权限范围的服务专用令牌，定期轮换 |
| 策略配置错误 | `auto_execute` 设置过宽导致意外写操作 | 仅对可信只读操作启用自动执行 |
| 会话 ID 管理 | 常驻任务遗漏 `session_id` 导致拒绝服务 | 工作流开始时生成 UUID，全程复用 |
| 意图验证误判 | 合理的理由表述被误判为提示注入 | 遵循文档指导，聚焦「做什么」而非「谁说的」|
| 中继依赖 | 云部署时依赖 `relay.clawvisor.com` | 本地实例部署消除外部依赖 |