OpenClaw 故障排查

常见问题快速解决。

安装问题

Node 版本过低

bash

检查版本

node -v

需要 18+

升级方法

brew upgrade node # macOS

权限错误

bash

修复 npm 权限

sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

网络超时

bash

使用国内镜像

npm config set registry https://registry.npmmirror.com

连接问题

Telegram 连接失败

检查清单：

1. Bot Token 是否正确
Bot 是否已启动（/start）
网络是否需要代理

bash

测试连接

curl https://api.telegram.org/bot/getMe

Discord 连接失败

检查清单：

1. Bot Token 是否正确
Bot 是否已加入服务器
intents 是否开启

钉钉连接失败

检查清单：

1. Client ID/Secret 是否正确
机器人是否已创建
回调地址是否配置

模型问题

API Key 无效

bash

验证 DeepSeek Key

curl -H Authorization: Bearer YOUR_KEY \
https://api.deepseek.com/v1/models

余额不足

- DeepSeek：platform.deepseek.com 充值
Claude：console.anthropic.com 充值
OpenAI：platform.openai.com 充值

响应超时

bash

增加超时时间

openclaw config set timeout 60000

运行问题

内存不足

bash

增加 Node 内存

export NODE_OPTIONS=--max-old-space-size=4096

端口被占用

bash

查找占用进程

lsof -i :3000

终止进程

kill -9

日志查看

bash

实时日志

openclaw logs -f

日志位置

~/.openclaw/logs/

高级问题

数据库损坏

bash

备份数据

cp -r ~/.openclaw/data ~/.openclaw/data.bak

重建数据库

openclaw db reset

配置丢失

bash

查看当前配置

openclaw config list

重置配置

openclaw config reset

需要帮助？

如果以上方案都无法解决：

- 📖 文档：https://docs.openclaw.ai
💬 社区：https://discord.gg/clawd
🔧 远程支持：

- 基础诊断：¥99 - 深度排查：¥299 - 企业支持：¥999

联系：微信 yang1002378395 或 Telegram @yangster151

OpenClaw故障排查