一个WebSocket配置错误,让我差点卸载OpenClaw,直到我用这条命令解决了…


🚨 你的OpenClaw是不是也这样?

  • 问一句话,等了半天没反应,最后显示 connected | error
  • 明明网关在跑,健康检查正常,可就是发不出消息?
  • 换了模型、清了会话,还是卡得像蜗牛?

如果这些你都经历过,别急着卸载,你可能遇到了和我一样的问题——WebSocket 连接认证失败


🔍 真相大白:卡顿的元凶不是模型,而是“传话筒”没对上暗号

OpenClaw 由两部分组成:

  • Gateway:负责和AI模型通信,相当于“传话筒”。
  • TUI:你看到的聊天界面,负责把你的话传给Gateway,再把回答展示给你。

如果 TUI 和 Gateway 之间的 WebSocket 连接 出了问题,就像两个人打电话时信号中断,你说的话对方听不见,对方的话你也收不到,看起来就是“卡顿”“不回消息”。

我的问题就出在这里:TUI 启动时没有带上正确的 认证 token,导致 Gateway 拒绝连接,但 TUI 只显示一个模糊的 connected | error,让我误以为是模型慢。


🛠️ 三步解决,让OpenClaw秒回消息

第一步:确认Gateway是否正常运行

在终端输入:

curl -i http://127.0.0.1:18789/health

如果返回 {"ok":true,"status":"live"},说明 Gateway 在跑。如果没反应,先启动 Gateway(通常用 systemctl --user start openclaw-gateway)。

第二步:找出你的认证Token

找到 OpenClaw 的配置文件 ~/.config/openclaw/openclaw.json,搜索 "token",你会看到类似:

"auth": {
  "mode": "token",
  "token": "这里是一长串字符"
}

把这一长串字符复制下来,这就是你的认证密码。

第三步:用正确的命令启动TUI

这是最关键的一步! 关闭所有 TUI 窗口,打开终端,输入以下命令(注意替换 <你的token> 为刚才复制的字符):

OPENCLAW_DEBUG=1 openclaw tui --url ws://127.0.0.1:18789 --token <你的token>

按下回车,你会看到 TUI 启动,并且下方的状态栏会变成绿色 connected。现在发一条消息,是不是秒回了?

如果你每次都要这样启动很麻烦,可以把这个命令做成别名,或者检查为什么 TUI 没有自动读取配置。但至少现在,你找到了一个立竿见影的解决方法!


💡 为什么这条命令有效?

  • --url ws://127.0.0.1:18789 明确告诉 TUI 去哪里找 Gateway。
  • --token <你的token> 则提供了认证凭证,让 Gateway 认识你。
  • OPENCLAW_DEBUG=1 开启调试模式,如果还有问题,终端会输出详细错误,方便定位。

这相当于告诉 TUI:“别自己瞎猜,直接去这个地址,用这个密码登录!”


🧹 后续优化(可选)

连接正常后,如果你还觉得慢,可以:

  1. 换一个更快的模型:在 TUI 输入 /model nvidia/moonshotai/kimi-k2.5 试试。
  2. 清理历史会话:左侧那些 tui-xxx 记录多了也影响性能,按 Ctrl+O 打开侧边栏,选中后按 Ctrl+D 删除。
  3. 关闭推理模式:输入 /think off,减少思考时间。

但这些都建立在 WebSocket 连接正常的基础上。先把连接问题解决,其他的都是锦上添花。


🎉 效果实测

执行上述命令后,我的 OpenClaw 从“发消息就转圈”变成了“秒回消息”,连写小说都能流畅输出。最开心的是,再也没看到过那个讨厌的 connected | error 了。


最后的话:
如果你也遇到了 OpenClaw 卡顿或连接问题,不妨试试这条命令。技术问题往往就差一个参数,别让它浇灭你折腾的热情。欢迎在评论区分享你的解决经历!

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐