夜雨聆风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
