---
title: 故障排查
description: 常见问题与快速排查——PhysiClaw 自己退出、摄像头预览正常却校准失败、智能体表现突然变差、电磁铁点击时好时坏、运行中快捷指令失效。
---

## PhysiClaw 运行一段时间后自动退出

PhysiClaw 运行一段时间后自行退出，通常是因为长时间无操作，系统关闭了摄像头——PhysiClaw 读不到手机屏幕画面，于是退出。

:::tip[解决办法]
请确保运行 PhysiClaw 的电脑不会锁屏或进入休眠。
:::

## 摄像头预览正常，但校准总是失败

用视频或相机软件查看时，摄像头画面一切正常，可一运行校准就失败。这多半是光线问题：室内光线太暗、有灯光直射手机屏幕形成反光，或是手机屏幕亮度太低。

:::tip[解决办法]
确保室内光线均匀，避免屏幕反光，并把手机屏幕亮度调到合适的水平。
:::

## 智能体表现突然变差

原本稳定运行的任务开始失败——智能体点错位置、迷失方向、或直接放弃——但软件层面什么都没改。原因几乎总在物理环节：摄像头被碰歪，不再正对手机屏幕；或者有灯光直射屏幕，导致画面过曝，智能体几乎看不清屏幕内容。

:::tip[解决办法]
先看模型实际看到了什么：`physiclaw logs` 列出最近的会话，`physiclaw logs <id>` 会打印该会话 `images/` 文件夹的路径——里面是发送给大模型的原始画面。如果画面歪斜、模糊或过曝，就能确认原因。重新对准摄像头（如果移动过则需重新校准），并让屏幕光照均匀、避免直射反光。
:::

## 电磁铁时而能点击，时而没响应

多半是电磁铁线缆挠曲疲劳、断线了。接头如果是焊接的，这一段被焊锡浸透后会变硬变脆，扛不住反复弯折。龙门架伸出时线缆被拉直、归位时被弯折，来回多了，就在弯折处断开。断口时接时离，点击也就时通时断。

:::tip[解决办法]
重新接线，注意两点：接头留在距电磁铁 50 mm 以内，避开线缆弯折最剧烈的区段；引线用扎带固定在导管（拖链）支架上，别让控制板端子处的接线随电磁铁来回晃动，以免端子日久松脱。
:::

## 运行中快捷指令突然失效

服务器一切正常，但快捷指令突然失败。通常是手机或电脑切换了 Wi-Fi，两者不在同一局域网了，快捷指令连不到服务器。

:::tip[解决办法]
检查两台设备的 Wi-Fi，把它们重新连到同一个网络。
:::
