Clawdbot汉化版问题解决：常见连接故障排查指南

Clawdbot汉化版问题解决：常见连接故障排查指南

1. 为什么需要这份指南

Clawdbot汉化版是一个可以在微信、WhatsApp、Telegram等平台直接使用的AI助手，它最大的特点是：

• 完全免费：使用你自己的AI模型
• 数据隐私：所有聊天记录都在本地
• 24小时在线：开机自动启动

但在实际使用中，很多用户会遇到连接问题。本文将帮你快速定位和解决最常见的连接故障。

2. 基础检查：服务是否正常运行

2.1 检查服务状态

首先确认Clawdbot服务是否正在运行：

ps aux | grep clawdbot-gateway

如果看到类似输出，说明服务正常：

root 133175 0.8 4.2 2145678 345678 ? Ssl 10:23 0:12 /usr/bin/node /root/clawdbot/dist/index.js gateway

如果没有输出，需要手动启动服务：

bash /root/start-clawdbot.sh

2.2 测试AI核心功能

确认AI能正常响应：

cd /root/clawdbot node dist/index.js agent --agent main --message "你好"

如果超过30秒没有响应，可能是模型加载问题。

3. 微信连接问题排查

3.1 二维码无法显示

症状：执行node dist/index.js wechat pair后终端没有显示二维码

解决方法：

1. 检查终端是否支持图形显示
2. 尝试使用Web控制台绑定：

   node dist/index.js wechat pair --web

   然后在浏览器访问http://你的IP:18789/qrcode查看二维码

3.2 扫码后无法登录

症状：手机扫码后提示"登录失败"或长时间无响应

解决方法：

1. 检查服务器时间是否准确：

   date

   如果时间不准，同步时间：

   ntpdate pool.ntp.org

2. 重新生成二维码：

   node dist/index.js wechat pair --force

3. 如果多次失败，尝试更换IP或等待1小时再试

4. 企业微信连接问题

4.1 应用配置问题

症状：企业微信扫码后提示"应用未配置"

解决方法：

1. 确认企业微信管理后台已创建应用
2. 检查应用可见范围是否包含你的账号
3. 确保应用已开启"接收消息"权限

4.2 消息无法接收

症状：企业微信能发送消息但没有回复

解决方法：

1. 检查网关日志：

   tail -f /tmp/clawdbot-gateway.log

   查看是否有WeCom message received日志

2. 确认企业微信应用配置的Token和EncodingAESKey与Clawdbot配置一致：

   cat /root/.clawdbot/clawdbot.json | grep -A 3 wecom

5. WhatsApp/Telegram连接问题

5.1 WhatsApp配对失败

症状：扫描二维码后提示"配对失败"

解决方法：

1. 确保手机WhatsApp是最新版本
2. 尝试在手机WhatsApp设置中先"注销设备"再重新扫描
3. 检查服务器是否能访问WhatsApp服务器：

   ping web.whatsapp.com

5.2 Telegram机器人无响应

症状：发送消息给机器人但没有回复

解决方法：

1. 确认机器人token正确：

   cat /root/.clawdbot/clawdbot.json | grep telegram -A 2

2. 检查机器人是否被禁用：

   • 在Telegram中搜索@BotFather
   • 发送/mybots
   • 选择你的机器人，查看状态

6. 网络问题排查

6.1 检查端口开放

Clawdbot使用以下端口：

• 18789: Web控制台
• 18790: 企业微信网关
• 443: 外网通信

检查端口是否开放：

netstat -tulnp | grep 18789

如果没有输出，可能是防火墙阻止了端口。

6.2 解决DNS问题

症状：连接外部服务(如WhatsApp/Telegram API)超时

解决方法：

1. 测试DNS解析：

   nslookup api.telegram.org

2. 临时修改DNS：

   echo "nameserver 8.8.8.8" > /etc/resolv.conf

7. 日志分析技巧

7.1 查看实时日志

tail -f /tmp/clawdbot-gateway.log

重点关注以下关键词：

• ERROR: 严重错误
• WARN: 警告信息
• connected: 连接成功
• message received: 收到消息

7.2 常见错误代码

8. 高级故障排查

8.1 重置所有配置

如果问题无法解决，可以重置配置：

rm -rf /root/.clawdbot bash /root/start-clawdbot.sh

注意：这会删除所有聊天记录和配置。

8.2 检查模型状态

AI无响应可能是模型问题：

ollama list

如果列表为空，需要重新下载模型：

ollama pull qwen2:1.5b

9. 总结与下一步

9.1 问题排查流程图

1. 服务是否运行？→ps aux | grep clawdbot
2. AI能否响应？→ 测试对话命令
3. 网关是否正常？→ 检查日志
4. 网络是否通畅？→ 测试端口和DNS

9.2 推荐操作

• 定期备份配置：

  tar -czf clawdbot-backup.tar.gz /root/.clawdbot

• 加入社区获取帮助：

  • GitHub: https://github.com/clawdbot/clawdbot
  • Discord: https://discord.gg/clawd

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。