Openclaw Troubleshoot Cn

---
name: openclaw-troubleshoot-cn
version: 1.0.0
description: OpenClaw 故障排查 - 常见问题解决方案。适合：遇到问题的用户、运维人员。
metadata:
  openclaw:
    emoji: "🔧"
    requires:
      bins: []
---

# 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 是否正确
2. Bot 是否已启动（/start）
3. 网络是否需要代理

```bash
# 测试连接
curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe
```

### Discord 连接失败

检查清单：
1. Bot Token 是否正确
2. Bot 是否已加入服务器
3. intents 是否开启

### 钉钉连接失败

检查清单：
1. Client ID/Secret 是否正确
2. 机器人是否已创建
3. 回调地址是否配置

## 模型问题

### 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 <PID>
```

### 日志查看

```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