计划与路线
卓安Claw 云端接入与本地执行(待开发,2026-11-14)
本页目录
状态:待开发,不排入 11/27 演示,后期单独立项。 目标:让云端只承担消息入口、提醒和任务编排,案件数据与 Agent 执行留在律所本地/私有云。 关联:
卓安Claw-下一步工作计划-2026-11-13.md、ADR-004-数据先存后处理.md、卓安Claw-数据存储与处理架构-v1.0.md
0. 结论
云端可以做,但只能做“通知与路由”,不能做“案件执行”。
企业微信 / 飞书 / H5 / 电话
│
▼
律所私有云 DMZ 接入层(消息入口)
├─ 渠道鉴权、去重、限流
├─ 消息信封 / 任务队列 / 提醒调度
├─ 只发通用通知,不存案卷正文
└─ 不运行 Agent 工具
▲
│ 本地主动外连:mTLS / WSS
│ 云端不能反向执行
律所本地 / 私有云 卓安Claw Node
├─ CaseDB、案卷、C 类材料
├─ Agent、文件/终端/浏览器工具
├─ 模型网关、数据分级
└─ 全量审计
不建议把 CowAgent Cloud / LinkAI 托管云当作纯消息网关:它是完整 Agent 运行时,会在云端跑 Agent、浏览器和终端,消息会进入云端;默认也不能访问本地电脑。若要用,只能作为非敏感通知入口,并做严格工具禁用和内容脱敏。
1. 职责边界
| 能力 | 云端接入层 | 本地/私有云卓安Claw |
|---|---|---|
| 企微/飞书回调 | ✅ | — |
| 消息去重、限流、重试 | ✅ | — |
| 通用提醒推送 | ✅ | 计算提醒时间 |
| 任务队列/状态 | ✅ 只存 id、指派人、截止、状态 | 创建/执行/完成 |
| 案件正文、案卷、C 类文件 | ❌ | ✅ |
| Agent 推理、工具调用 | ❌ | ✅ |
| 文件/终端/浏览器 | ❌ 只操作云主机 | ✅ 操作律所机器 |
| 模型调用与脱敏 | ❌ | ✅ |
| 审计 | 渠道投递审计 | 案件访问/操作审计 |
2. 最小协议
云端只认识三类对象,不存案件详情:
// 消息信封
{
"msg_id": "uuid",
"channel": "wecom",
"from_user": "wecom_userid",
"type": "command",
"text": "打开我的待办",
"created_at": "2026-11-14 10:00:00"
}
// 任务(云端只看路由字段)
{
"task_id": "uuid",
"assignee": "user_id",
"due_at": "2026-11-20 10:00",
"status": "待认领"
}
// 提醒
{
"reminder_id": "uuid",
"target": "user_id",
"due_at": "2026-11-20 10:00",
"template": "generic_todo"
}
案件号、客户姓名、案由、案卷正文、文书内容都不进云端;云端只保存 opaque id。
3. 落地步骤
3.1 部署云端接入层
建议放在律所私有云 DMZ,一台小 ECS 即可:
- Nginx:TLS、IP 白名单、限流;
- FastAPI:企微/飞书回调、任务/提醒 API;
- Redis/DB:队列、幂等键、重试;
- 只开 443,不开放数据库和内部端口;
- 渠道回调验签,按
msg_id去重。
最小接口:
POST /webhook/wecom
POST /webhook/feishu
POST /api/tasks/pull
POST /api/tasks/ack
POST /api/reminders/ack
GET /health
3.2 部署本地节点
- 本地卓安Claw 不开放公网端口,只主动外连;
- 启动后建立 WSS/mTLS 长连接;
- 30 秒心跳;
- 拉取任务/提醒,执行后回传状态;
- 断线时本地继续办案,恢复后补同步。
3.3 接企微/飞书
- 企微自建应用回调指向私有云接入层;
- 用
userid映射员工账号; - 客户侧继续走 H5 手机号会话;
- 消息按钮只放深链,不放案件详情。
3.4 提醒
- 本地节点计算未来 24 小时待办(要读时限/预约/清单);
- 只把
due_at + opaque_id + 用户推到云端; - 云端发通用模板:“您明天有 3 项待办,请打开卓安Claw查看”;
- 用户点开后再由本地/H5 展示详情。
3.5 任务编排
- 任务创建、分派、DRI、复核、完成全部在本地任务链完成;
- 云端只存任务 id、指派人、截止、状态;
- 云端负责提醒,不负责任务内容;
- 本地完成后回传状态,云端更新看板并停止提醒。
4. 安全与数据边界
- C 类材料本地打标,云端永远拿不到;
- 消息正文默认不落云端,最多存加密信封;
- 本地只外连,云端不能主动连入;
- 云端记投递审计,本地记案件访问审计;
- 断网:本地继续办案,云端队列保留,恢复补发;
- 死信队列:重试 3 次转人工,不静默丢消息;
- 模型调用仍由本地策略控制,不能因为上云就默认全量外发。
5. 场景口径
客户预约提醒
本地预约 → 计算明天 10:00 → 云端只收到“明天 10:00 有预约”
→ 云端发:“您明日 10:00 有预约,请打开卓安Claw查看”
→ 客户点 H5 深链 → 本地/私有云展示详情
律师微信问案件
- “打开我的待办”:云端可路由;
- “ZA-2026-0324 上诉期到了吗”:消息含案件号,公共云端会看到;
- 走律所私有云入口;或
- 微信只发通用指令,案件问题回桌面/H5;或
- 端到端加密(成本更高)。
任务编排
律师在本地创建“上诉期复核”任务
→ 本地任务链分派
→ 云端只收到“你有一个任务,截止 11-20”
→ 承办律师点深链回本地任务详情
6. POC 顺序
- 本地节点心跳 + 主动外连;
- 接一个渠道(先企微);
- 通用待办提醒;
- 任务拉取/回执;
- 深链回本地案件页;
- 加密消息信封、跨分所节点(后期)。
7. 验收标准
- 云端数据库中没有案件正文、案卷正文、C 类文件、客户姓名、案号;
- 云端不能主动连接本地节点,不能执行 shell;
- 本地节点离线时云端只排队,不报错、不丢消息;
- 提醒内容只有通用模板,点深链后才见详情;
- 本地任务完成状态能回传,云端看板一致;
- 审计能回答“谁在何时通过哪个渠道收到了什么通知”。
8. 不做什么
- 不做云端 Agent 直接操作本地电脑;
- 不做公共云存案卷;
- 不做云端反向 shell/远程桌面;
- 不做多租户平台化;
- 不排入 11/27 演示。