1. OpenClaw WebUI离线问题深度解析
最近在部署OpenClaw时遇到了WebUI显示"健康状态:离线"的问题,经过排查发现90%的情况都是Token配置不当导致的。这个问题看似简单,但涉及Linux权限管理、配置文件编辑和网络端口转发等多个技术点,值得系统梳理一下解决方案。
OpenClaw作为一款开源的自动化运维工具,其WebUI默认监听18789端口。当我们在浏览器访问127.0.0.1:18789却看到离线状态时,本质上是因为后端服务无法验证客户端的身份凭证。这就像拿着过期门禁卡试图进入办公楼——虽然找到了大门(端口连通),但认证系统(Token校验)阻止了访问。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Token配置问题完整解决方案
2.1 定位配置文件的关键步骤
首先需要通过root权限查看OpenClaw的配置文件,这里有个细节需要注意:直接使用sudo vi可能会因为环境变量差异导致找不到文件,更可靠的做法是先切换为root用户:
bash复制sudo su -
vi ~/.openclaw/openclaw.json
注意:使用
sudo su -中的横杠很重要,它会完全加载root的环境变量,避免出现"文件不存在"的报错
配置文件通常包含如下关键字段(具体值因人而异):
json复制{
"gateway": {
"token": "eyJhbGci...很长的一串字符"
}
}
2.2 Vi编辑器的生存指南
对于不熟悉Linux的新手,Vi编辑器可能是第一个"拦路虎"。这里分享几个救命命令:
- 进入编辑模式:看到文件内容后按
i键 - 退出编辑模式:按
ESC键 - 保存并退出:输入
:wq后回车 - 不保存退出:输入
:q!后回车
实用技巧:在Vi中可以用
/token进行关键词搜索,快速定位到目标字段
2.3 Token的复制粘贴陷阱
从终端复制Token时容易带入不可见字符或换行符,这会导致认证失败。建议采用以下方法:
- 在Vi中精确选中:将光标移到token开头,按
v进入可视模式,用方向键选中 - 复制后先粘贴到文本编辑器(如nano)检查
- 在WebUI粘贴时使用
Ctrl+Shift+V确保纯文本粘贴
