安装好Nova AI后,打开界面却显示一片空白,无论点击哪里都没有任何反应。在命令行中输入claw status,返回的结果依然是offline——这通常意味着核心服务未能成功启动,或者已经处于僵死状态。实际上,这种情况大多不是配置方面的严重错误,而是守护进程在启动握手阶段卡住,或者被系统资源调度器挂起所致。

终止残留进程并重启网关
我们先排查第一种情况。如果安装后第一次启动就失败,或者多次执行claw restart都毫无反应,通过ps aux能看到claw进程存在,但端口却没有监听,那么请按照以下步骤操作。
1、首先,在终端中执行命令,强制终止所有与claw相关的进程:pkill -f claw
2、确认进程已被彻底清除:ps aux | grep claw | grep -v grep → 如果输出为空,说明清理成功;若仍有残留,再运行一次pkill -f claw即可。
3、接着重新启动核心网关服务:claw gateway start → 这一步会重建HTTP监听端口(默认18789)。这里有一个关键点:必须等待3秒以上再访问Web UI,否则浏览器会直接报错ERR_CONNECTION_REFUSED。
重启OpenClawd守护进程
另一种常见情况是:Nova AI首页虽然可以打开,但所有AI功能按钮都呈现灰色无法点击,侧边栏转圈超过10秒始终没有响应。这通常是因为后台的openclawd守护进程没有正确注册工作区上下文。
方法一:手动清理锁文件后重启
1、先停止当前的守护进程:claw daemon stop
2、删除锁文件,避免启动时被阻塞:rm -f ~/.openclaw/daemon.lock
3、以守护模式重新加载,但不自动打开浏览器(适合调试场景):claw daemon start --no-browser
方法二:直接重置运行时状态
1、同样先执行:claw daemon stop
2、清除工作区缓存:rm -rf ~/.openclaw/workspace/cache
3、启动时强制重建索引:claw daemon start --rebuild-index → 这一步会触发全量代码语义扫描,首次执行比较耗时,但能有效修复因索引损坏导致的功能冻结问题。
系统级服务强制重载(仅限systemd环境)
如果机器是通过sudo systemctl enable claw注册为开机自启服务来部署的,并且执行普通claw restart时返回了“Service not found”错误,说明服务管理层面出现了异常。可以尝试以下操作:
① 立即杀死服务主进程:sudo systemctl kill --signal=SIGKILL claw
② 重载服务定义文件,同步最新配置:sudo systemctl daemon-reload
③ 启动服务并跳过依赖检查:sudo systemctl start --no-block claw → 执行后需要立即运行sudo systemctl status claw确认状态是否为Active: active (running),如果显示failed,说明配置文件可能存在错误。
Web UI硬重启(仅限Web界面仍可访问)
最后一种情况:如果http://localhost:18789可以正常打开,但聊天窗口空白、代码补全失效、作曲器按钮点击无反应,这多半是前端状态与后端不同步导致的。此时可以尝试硬重启:
1、访问系统控制页:http://localhost:18789/#/system/restart
2、点击【强制重启】按钮(图标为红色闪电)
3、在弹出的对话框中输入FORCE-RESTART(注意必须全大写,区分大小写)
4、点击确定 → 页面会显示Restarting (SIGKILL → gateway start),此时千万不要刷新页面,等待15秒,它会自动跳转到登录页。
