OpenClaw 故障排查
常见问题快速解决。
安装问题
Node 版本过低
CODEBLOCK0
权限错误
CODEBLOCK1
网络超时
CODEBLOCK2
连接问题
Telegram 连接失败
检查清单：
- 1. Bot Token 是否正确
- Bot 是否已启动（/start）
- 网络是否需要代理
CODEBLOCK3
Discord 连接失败
检查清单：
- 1. Bot Token 是否正确
- Bot 是否已加入服务器
- intents 是否开启
钉钉连接失败
检查清单：
- 1. Client ID/Secret 是否正确
- 机器人是否已创建
- 回调地址是否配置
模型问题
API Key 无效
CODEBLOCK4
余额不足
- - DeepSeek：platform.deepseek.com 充值
- Claude：console.anthropic.com 充值
- OpenAI：platform.openai.com 充值
响应超时
CODEBLOCK5
运行问题
内存不足
CODEBLOCK6
端口被占用
CODEBLOCK7
日志查看
CODEBLOCK8
高级问题
数据库损坏
CODEBLOCK9
配置丢失
CODEBLOCK10
需要帮助？
如果以上方案都无法解决：
- - 📖 文档：https://docs.openclaw.ai
- 💬 社区：https://discord.gg/clawd
- 🔧 远程支持：
- 基础诊断：¥99
- 深度排查：¥299
- 企业支持：¥999
联系：微信 yang1002378395 或 Telegram @yangster151
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
