OpenClaw(俗称"小龙虾")在运行过程中可能会遇到各种问题导致"罢工"。今天就来讲讲常见故障及自救方法,让你的小龙虾重新活过来!
一、常见"死亡"原因
1. 服务未启动
最常见的问题就是 Gateway 服务没有运行。表现为无法访问 Web UI、消息发不出去。
2. 端口被占用
8080 端口被其他程序占用,导致启动失败,报错 "Port already in use"。
3. 配置错误
config.yaml 配置错误,如 API Key 格式不对、channel 配置缺失等。
4. 网络问题
无法连接到 Ollama、OpenAI 等后端服务,可能是网络不通或防火墙拦截。
二、急救方案
急救一:检查服务状态
openclaw status 查看当前状态,如果显示 "stopped",用 openclaw gateway start 启动。
急救二:端口排查
lsof -i:8080 查看端口占用情况。如果被占用,修改 config.yaml 中的端口或关闭占用程序。
急救三:检查配置
openclaw config edit 检查 API Key、model、channel 等配置是否正确。确保 key 没有过期。
急救四:网络连通性
测试 curl http://localhost:11434(Ollama)是否正常。如果连不上,检查防火墙或 VPN 设置。
三、预防措施
1. 定期检查状态:使用 openclaw status 定时检查服务运行状态。
2. 配置备份:定期备份 config.yaml,防止误操作导致配置丢失。
3. 日志监控:查看 openclaw logs 及时发现异常。
4. 自动启动:设置开机自启,避免服务器重启后服务未运行。
四、常用命令汇总
• openclaw status - 查看状态
• openclaw gateway start - 启动服务
• openclaw gateway stop - 停止服务
• openclaw logs - 查看日志
• openclaw config edit - 编辑配置
遇到其他问题可查阅官方文档:https://docs.openclaw.ai
夜雨聆风