Vetta Claw 是随桌面客户端运行的 IM 旁路助手：外部消息进入本机 Agent，代码与工具仍在本机执行。入口：设置 → Claw。
Claw 会话数据落在 im-gateway 自有目录（如 ~/.vetta/im-gateway/conversation），与桌面默认「对话」项目物理分家；侧栏可筛选 Claw 记录查看。
开始使用
启用 Claw
打开 设置 → Claw，打开总开关。启用前需已配置当前活动渠道（飞书 App 凭证或微信已绑定），否则会提示无法启用。
选择对话模型
在同一页为 Claw 选择 对话模型（可设推理档位），并 测试连接。
保持桌面运行
状态应为运行中。完全退出 Vetta 会停止 sidecar，无法继续收消息。可在状态区查看进程信息、查看日志 与 重启。
会话命令
在已绑定的 IM 私聊中发送（以当前 im-gateway 命令集为准）：
| 命令 | 作用 |
|---|---|
/help | 显示可用命令 |
/new | 在当前对话中开启新会话（清空上下文）；开启前会尽量把可保留事实写入长期记忆 |
/whoami | 查看当前用户、会话目录与连接池等诊断信息 |
已移除按项目切换的命令（如旧版 /projects、/use）。IM 侧统一在 Claw 会话目录中工作，不在渠道内切换桌面项目。
使用边界
- 复杂改动、敏感权限或严格验收时，回到桌面客户端确认工作目录、执行模式与工具调用。
- Claw 会做会话记忆整理，但不要当作唯一事实来源；关键约束仍应放在项目文档、知识库或明确任务说明中。
- 一次只有一个活动传输渠道（飞书或微信）。