龙虾也会生病。但别担心,许多问题并非致命,可以在家自行处理。养OpenClaw一年多,我总结了五种常见故障,并分享我的“土方子”,希望对你有帮助。
症状一:不进食(完全不执行任何任务)
表现:你发出指令,它没有反应,似乎处于休眠状态,碰它也无动于衷。
原因:通常是进程卡住,或者依赖的服务未启动。
解决方法:先使用Ctrl+C终止进程,然后重启OpenClaw服务。如果仍然无效,检查Python环境或Docker容器是否出现问题。曾遇到过两次,都是因为系统自动更新后某些底层库不兼容。解决办法是重新运行安装脚本中的“环境检测”部分,它会指明缺失的内容。
症状二:乱执行(执行错误指令)
表现:你让它“整理下载文件夹”,结果把桌面文件全删了。
原因:大多数情况下是指令模糊或上下文污染。也就是说,之前教过它的内容干扰了新的任务。
解决方法:第一步,清空当前会话上下文(重启会话或使用/clear命令)。第二步,指令要更具体,例如“将桌面上所有后缀为.pdf的文件移动到D:pdf_backup文件夹”。第三步,在指令前加一句“忽略之前所有规则”,强制重新理解。
症状三:运行缓慢(响应时间增加)
表现:最初执行任务只需2秒,现在却要20秒,CPU占用率始终偏高。
原因:日志文件或临时缓存过大。OpenClaw会保存每次执行的中间结果,时间久了就像龙虾塘里淤泥过多,水流不畅。
解决方法:定期清理缓存。找到OpenClaw的工作目录,删除temp和cache文件夹(不会影响配置)。还可以设置自动清理策略,让AI龙虾每周自动执行“删除7天前的日志”的任务。这种方式可以让它自我维护。
症状四:升级困难(版本更新后不兼容)
表现:升级OpenClaw后,配置文件出错,许多功能无法使用。
原因:新版本可能更改了配置格式或API接口,旧规则不再适用。
解决方法:升级前务必备份整个配置文件夹。如果升级后出现问题,不必慌张,通常会提供“迁移工具”或“兼容模式”。我习惯保留上一个稳定版本的安装包,新版本先在另一台测试机上运行两天,确认无误后再正式迁移。这就像给龙虾分塘,避免老虾和新虾混在一起。
症状五:连接失败(无法连接外部服务)
表现:OpenClaw需要调用某个API(例如发送邮件、查询天气),但总是提示“连接超时”或“认证失败”。
原因:可能是API密钥过期,或者网络代理设置不正确。
解决方法:逐一排查。先确认密钥是否正确,再在命令行中PING一下API的域名。如果使用了代理,确保在OpenClaw的配置文件中设置http_Proxy变量。如果仍然无法解决,尝试更换网络环境。这个问题最令人烦恼,但解决后通常会很稳定。
记住,AI龙虾生病并不可怕,最怕的是慌乱而误操作。冷静下来,查看日志,大多数故障原因通常在最后几行中有所提示。

