一、什么是龙虾医院?
| 能力 | 适用问题 | 工作方式 | 资源消耗 |
| 一键修复 | Agent 配置文件中 API Key、插件、通道等配置异常导致启动失败 | 在当前 Agent 内自动检测并修复,修复前备份配置 | 不创建新资源,不产生额外资源费用 |
| 龙虾医生 | 复杂运行问题、行为异常、需多步排查的问题 | 平台代拉起一台临时诊断 Agent,由 AI 主导对话式排查与修复 | 云服务器按量计费 + 大模型 Token 消耗 |
二、前提条件
·Agent 类型为 OpenClaw。
·使用龙虾医生前,管理员已在管控端开启允许用户使用龙虾医生。
如你的龙虾医院未显示龙虾医生能力,请联系管理员开启,具体操作请参见 开启龙虾医生功能。
四、进入龙虾医院
1. 在用户端选择我的 Agent,单击目标 Agent 进入详情页。
2. 选择龙虾医院页签,提供一键修复与龙虾医生两个区域。
六、工作原理
在被排障 Agent 内部直接执行 agent doctor –fix 命令完成自检,不创建新节点、不占用实例配额、不产生底层资源费用。修复前会自动备份当前配置文件。
适用于 Agent 配置文件中的常见异常:API Key 失效或格式错误、插件加载异常或版本不匹配、通道配置错乱(如企业微信/飞书/钉钉/QQ 接入信息缺失)等。
七、操作步骤
1. 进入龙虾医院,在一键修复区域单击一键修复。
2. 等待执行完成,页面显示正在执行修复。
3. 查看执行结果:
·成功:显示修复成功,并提示 Gateway 已正常启动。请前往 Agent 对话确认问题是否已解决。
·失败:显示修复失败及返回状态。可改用龙虾医生深度诊断(需管理员已开启该功能)。
八、使用龙虾医生诊断问题
龙虾医生适用于一键修复无法覆盖的复杂运行问题。每次启动会由平台代拉起一台临时诊断 Agent(实例名称为 龙虾医生-{序号}),即一台按量计费云服务器,(规格与当前故障 Agent 保持一致),AI 主导从检测到修复的全流程,结束诊断时临时云服务器立即销毁并停止计费。
注意:说明:
注意:临时诊断 Agent 对应云服务器与企业内其他普通云服务器一同显示在云服务器实例列表中,可通过名称搜索。
注意:
九、模型说明
龙虾医生默认使用管控端模型配置中的默认模型,同时支持指定其他模型,保存后生效。若当前所指定模型被删除,将依次尝试:默认模型 → 诊断模型列表中排序最靠前的可用模型。
注意:说明:
注意:若默认模型当前不可用(例如额度耗尽、Provider 限流、API Key 失效等),龙虾医生将显示等待响应或返回限流提示。
十、计费说明
每次启动龙虾医生会产生底层云服务器费用 + 大模型 Token 消耗两类费用。底层云服务器统一按量计费,结束诊断时立即停止计费。建议正常诊断完成后手动单击结束诊断及时释放资源。
| 计费项 | 说明 |
| CVM 云服务器实例 | 智能型 Ai2 机型(规格与当前故障 Agent 保持一致),按量计费 |
| 云硬盘(CBS) | 通用型 SSD 系统盘(规格与当前故障 Agent 保持一致),按量计费 |
| 公网带宽 | 5Mbps 公网带宽,按流量计费 |
| 大模型 Token 消耗 | 诊断对话调用大模型产生的 Token,计入触发诊断的用户名下,管理员可在管控端按用户维度查看 |
| 实例配额 | 不占用用户实例配额。例如用户实例上限是 3 台时,开启诊断不会变成 3+1 触发"配额满" |
十一、启动诊断
1. 在用户端页面中,单击目标 Agent 进入详情页。
2. 选择左侧导航栏中的龙虾医院,单击开始诊断。
3. 在开始诊断弹窗内,勾选以下配置,单击确认开始后进入节点初始化阶段。
| 配置项 | 默认 | 说明 |
| 启用龙虾医生功能 | 已勾选 | 必选,阅读并了解龙虾医生将在当前 Agent 上创建临时诊断节点,诊断结束后自动销毁 |
| 创建本次诊断的配置快照 | 已勾选 | 推荐保留,结束诊断时可一键回滚至开始前的状态 |
十二、节点初始化
平台开始创建临时诊断 Agent,整个过程约需 3-5 分钟。初始化经历两个子阶段:正在为你创建龙虾医生 Agent 和等待龙虾医生 Agent 就绪。
十三、对话式排查
诊断云服务器就绪后进入对话界面,输入框中已预填一条诊断指令模板,可按需更新后发送。
发送后龙虾医生开始全面检测,实时输出每一项的进度和结果,异常项附简短说明。
检测完成后,龙虾医生会汇总问题列表并逐项给出原因和修复方案,等待你回复确认后再执行修复动作。你也可以追问具体问题,AI 会基于检测数据给出技术解释。
十四、结束诊断
排查完成后单击结束诊断,在结束诊断弹窗中,如启动诊断时勾选为本次诊断创建配置快照,弹窗中会显示回滚到诊断前快照勾选项。
·已解决:保留诊断过程中龙虾医生已执行的所有修复,仅销毁诊断云服务器。
·未解决或不符合预期:单击确认结束后系统将 Agent 配置还原至诊断前状态,再销毁诊断云服务器。
注意:警告:
注意:正常诊断完成后请手动单击结束诊断及时销毁临时云服务器。如忘记主动结束,临时云服务器最长保留12小时后由平台自动清理,期间会持续产生按量计费费用。
十六、开启龙虾医生功能
龙虾医生默认关闭,需管理员开启后,用户才能在 Agent 详情页使用。
十七、模型配置建议
由于龙虾医生使用管控端模型配置中的默认模型,建议管理员:
·使用能力较强的通用大模型为默认配置,保证龙虾医生具备良好的诊断能力。
·为可能高频触发龙虾医生的用户分组预留充足的 Token 配额,避免诊断过程中触发限流。
·如启用自定义模型作为默认配置,请确认其稳定性满足排障对话场景需求(推理能力、上下文长度、响应速度)。
十八、操作步骤
1. 在 ClawPro 企业 AI 智能体管控台页面,选择左侧菜单栏中的平台策略。
2. 找到允许用户使用龙虾医生策略,单击右侧。
3. 选择开启,并单击右侧保存。
4. (可选)允许用户使用龙虾医生支持添加分组策略:
·预设策略:站点全局默认。
·添加分组策略:针对特定用户分组单独开启或关闭。
20、一键修复和龙虾医生有什么区别?
一键修复是系统自动执行的轻量自检(执行 agent doctor –fix 命令),针对常见配置异常。龙虾医生是 AI 主导的对话式深度排查,启动需 3-5 分钟,处理复杂问题。建议先尝试一键修复,无效再用龙虾医生。
21、龙虾医生用的是哪个模型?
龙虾医生默认使用管控端模型配置中的默认模型,同时支持指定其他模型,保存后生效。若当前所指定模型被删除,将依次尝试:默认模型 > 诊断模型列表中排序最靠前的可用模型。
22、诊断会占用用户的 Agent 实例配额吗?
不占用。诊断云服务器是平台代拉起的临时资源,与用户配额隔离。
23、诊断对话的 Token 消耗如何归属?
诊断对话调用大模型产生的 Token 计入触发诊断的用户名下,管理员可在管控端按用户维度查看;底层节点的按量计费则计入企业账户。
24、同一个用户能并发多台 Agent 诊断吗?
不能。每个用户同时只能针对一台 Agent 进行诊断。