# 使用 Vetta Claw

> 启用 Claw，绑定飞书或微信，在 IM 与桌面之间连续使用助手会话。

Canonical page: /product/claw



Vetta Claw 是随桌面客户端运行的 IM 旁路助手：外部消息进入本机 Agent，代码与工具仍在本机执行。入口：**设置 → Claw**。

Claw 会话数据落在 im-gateway 自有目录（如 `~/.vetta/im-gateway/conversation`），与桌面默认「对话」项目物理分家；侧栏可筛选 **Claw** 记录查看。

## 开始使用 [#开始使用]

<Steps>
  <Step>
    ### 启用 Claw [#启用-claw]

    打开 **设置 → Claw**，打开总开关。启用前需已配置当前活动渠道（飞书 App 凭证或微信已绑定），否则会提示无法启用。
  </Step>

  <Step>
    ### 选择对话模型 [#选择对话模型]

    在同一页为 Claw 选择 **对话模型**（可设推理档位），并 **测试连接**。
  </Step>

  <Step>
    ### 配置消息渠道 [#配置消息渠道]

    配置飞书或微信，并切换 **活动渠道**。详见 [IM 渠道](/product/im/)。
  </Step>

  <Step>
    ### 保持桌面运行 [#保持桌面运行]

    状态应为运行中。完全退出 Vetta 会停止 sidecar，无法继续收消息。可在状态区查看进程信息、**查看日志** 与 **重启**。
  </Step>
</Steps>

## 会话命令 [#会话命令]

在已绑定的 IM 私聊中发送（以当前 `im-gateway` 命令集为准）：

| 命令        | 作用                                    |
| --------- | ------------------------------------- |
| `/help`   | 显示可用命令                                |
| `/new`    | 在当前对话中开启新会话（清空上下文）；开启前会尽量把可保留事实写入长期记忆 |
| `/whoami` | 查看当前用户、会话目录与连接池等诊断信息                  |

已移除按项目切换的命令（如旧版 `/projects`、`/use`）。IM 侧统一在 Claw 会话目录中工作，不在渠道内切换桌面项目。

## 使用边界 [#使用边界]

* 复杂改动、敏感权限或严格验收时，回到桌面客户端确认工作目录、执行模式与工具调用。
* Claw 会做会话记忆整理，但不要当作唯一事实来源；关键约束仍应放在项目文档、知识库或明确任务说明中。
* 一次只有一个活动传输渠道（飞书或微信）。