整理并记录我遇到的问题和修复过程，不定期在博客更新。

万能修复命令

遇到任何问题，先跑下面几条命令，90%的问题都能定位到

openclaw doctor：这是内置的诊断命令检测配置文件是否正确，关注红色字体，如果有任何提示选择Yes即可.

正常情况下，该命令仅诊断但不修复，因此还需要执行修复命令： openclaw doctor --fix

对于大版本升级，建议进行一次深度修复： openclaw doctor --deep --repair

龙虾不在线/挂掉

检查龙虾状态

执行命令 openclaw status：查看整体状态，特别要关注红色字体的，一般都是问题所在，可以发给 AI 协助解决

检查网关状态

该问题大概率都是网关出了问题，因为网关是小龙虾和聊天工具建立链接的桥梁。

执行命令：openclaw gateway status：查看网关状态，正常情况会显示Running和ok，如下图：

如果异常，可以尝试重启: openclaw gateway restart

如果重启卡死无响应，可以先 stop 再 start：

openclaw gateway stop 
openclaw gateway start 

如果依旧解决不了，重装gateway，放心，不会影响龙虾的任何配置和记忆：

openclaw gateway install

检查聊天频道配置状态

如果网关没问题，那就要检查聊天频道的配置

执行命令：openclaw channels status --probe 

正常应该显示：Gateway reachable 和 works

龙虾已读不回

如果你是第一次发消息，则系统会生成一个验证码等你配对，没有配对就永远无法回复消息

配对码命令正常是会发回给你的，格式参考如下：

openclaw pairing approve DE49LO3B 

你也可以执行下面命令查看待审批的配对码，把channel改为你配对的平台名，比如discord、feishu等

openclaw pairing list 

自己能用，别人用不了

原因：每个聊天频道都会有 allowFrom 白名单，你的朋友没有在白名单里，就用不了

修复：你可以发消息给龙虾，你朋友的用户 ID 也加到白名单里，或者把 DM 策略改成 pairing 模式让用户自助申请。总之，可以让龙虾帮你解决该问题

私信能用，但群里不回消息

群消息的权限是独立的，也要添加白名单

把群的 ID 发给你的小龙虾，比如告诉它：请将该 ID: 9293.. 加入到 Discord 的群组白名单里。

@提及限制： 默认只有 @ 机器人才会回复，如果想让它回复所有消息，在配置里设置 requireMention: false，你也可以把这个配置让小龙虾去修改

机器人”失忆”/ 忘了上下文

原因：

• 每个频道/群是独立的上下文，互不共享
• 记忆系统没有开启
• historyLimit 默认值太低，对话长了旧内容就被丢弃了

修复：

• 启用记忆系统: openclaw config set plugins.entries.memory-core.enabled true
• 调高每个 session 的历史记录条数，执行命令： openclaw config set channels..historyLimit 50

把name改为实际的频道名，比如discord、feishu等

Invalid Authentication 报错

原因： 网关的 Token 不匹配，可能重新生成过

修复： 执行命令

openclaw config get gateway.auth.token 

确保和客户端填写的 token 是一致的

其它问题

建议可以将以下3个命令中，标红的文字发给 AI，基本上都能解决问题：

openclaw status 
openclaw gateway status 
openclaw logs --follow 

如果还不行，那只能上终极武器了：

彻底重装

如果依旧无法解决的话，基本就只能重装，但放心，配置和角色定义和记忆都可以保留。 重装步骤如下：

1. 先回到主目录

cd ~

1. 备份(如果需要保留角色定义和记忆等)

cp -rf ~/.openclaw ~/Downloads/openclaw 

1. 找到并删除所有 openclaw 相关文件

sudo rm -rf $(pnpm root -g)/openclaw 2>/dev/null 
sudo rm -rf $(npm root -g)/openclaw 2>/dev/null 
sudo rm -rf /usr/local/lib/node_modules/openclaw 
sudo rm -rf /opt/homebrew/lib/node_modules/openclaw 
sudo rm -rf ~/.pnpm-global/lib/node_modules/openclaw 

1. 删除可执行文件

sudo rm -f $(pnpm bin -g)/openclaw 
sudo rm -f $(npm bin -g)/openclaw 
sudo rm -f /usr/local/bin/openclaw 
sudo rm -f /opt/homebrew/bin/openclaw 
sudo rm -f ~/.pnpm-global/bin/openclaw 

1. 删除配置目录 rm -rf ~/.openclaw

2. 清理缓存

pnpm store prune 
npm cache clean --force 

1. 重新安装

curl -fsSL https://openclaw.ai/install.sh | bash