#故障排除指南

遇到问题？按照以下步骤诊断和解决。

#快速诊断

#查看日志

日志文件位置：

• Windows: %APPDATA%/OpenGPTClaw/logs/main.log
• macOS: ~/Library/Logs/OpenGPTClaw/main.log
• Linux: ~/.config/OpenGPTClaw/logs/main.log

快捷键打开：Ctrl/Cmd + Shift + L

#启动问题

#应用无法启动

排查步骤:

1. 检查日志文件是否存在错误
2. 尝试以管理员身份运行（Windows）
3. 检查系统要求

解决方案:

# 清除缓存后重启
rmdir /s /q %APPDATA%\OpenGPTClaw\Cache

#连接问题

#Gateway 连接失败

症状: 状态栏显示"Gateway 未连接"

排查:

1. 检查端口 18789 是否被占用
2. 检查防火墙设置

#AI 响应问题

#无响应或空白回复

1. 点击"新建对话"清空上下文
2. 切换其他模型测试
3. 检查日志中的错误信息

#响应缓慢

1. 使用更快的模型
2. 减少 max_tokens 设置
3. 检查网络延迟

#平台集成故障

#Telegram 机器人不响应

1. 检查 Bot Token 正确性
2. 确认 Bot 没有被群组禁言
3. 查看日志中的错误信息

#Discord 机器人离线

1. 在 Discord Developer Portal 重置 token
2. 检查 intents 设置
3. 重新邀请 bot 到服务器

#获取帮助

如果以上方法无法解决问题：

1. 收集信息:

   • 操作系统版本
   • OpenGPTClaw 版本
   • 错误截图
   • 日志文件

2. 联系支持:

   • 🐛 GitHub Issues
   • 💬 Discord 社区