一次升级引发的连环问题，记录从版本冲突到模块导入错误的完整排查过程。

问题版本

• OpenClaw: 2026.4.12 → 2026.4.14 → 2026.4.15
• 环境: Linux (Ubuntu/Debian)
• 安装方式: npm global install
• 关键词: npm prefix, global install, PATH priority, 模块丢失，安装冲突

问题现象

第一阶段：版本不一致

执行 openclaw update 从 2026.4.12 升级到 2026.4.14 后，出现以下异常：

openclaw dashboard访问提示1008报错

现象1：disconnected (1008): control ui requires HTTPS or localhost (secure context)

报错截图：

原因：

OpenClaw官方对于dashboard的配置默认是没有开启局域网或公网访问，即使初始化的时候设置了侦听地址为Lan，也会有这个报错，根据官方文档描述： 通过 HTTP 访问控制 UI

大模型配置-千问免费版

对于openclaw支持的模型列表可以参考：

OpenClaw支持的主流大模型包括：

• OpenAI系列：GPT-3.5、GPT-4、Codex等
• Anthropic：Claude系列模型
• 阿里云：通义千问(Qwen)系列
• 百度：文心一言(ERNIE Bot)
• 腾讯：混元(HunYuan)系列
• MiniMax：ABAB系列模型
• 智谱AI：GLM系列模型

通义千问模型优势

技术特点

通义千问系列模型具有以下显著优势：

初始化OpenClaw

该文档是纯初始化操作，不包含skills、插件、通信渠道、大模型等设置

在安装完成OpenClaw之后，会自动启动一个初始化页面（如果误操作选择了No可以使用命令openclaw onboard，命令调出初始化，如下图。

安装openclaw记录

官方文档参考：https://docs.molt.bot/start/getting-started

官方开源仓库：https://github.com/moltbot/moltbot

CheckSSL.sh - SSL 证书到期监控脚本

脚本功能

CheckSSL.sh 是一个用于批量监控多个网站 SSL 证书到期时间的 Shell 脚本。它通过 OpenSSL工具获取SSL证书的有效期信息，计算剩余有效天数，并在证书即将过期时通过 Bark推送告警通知。

g.sh - Go 语言环境管理工具安装脚本

脚本功能

g.sh 是一个用于安装 g 工具的自动化脚本。g是一个轻量级的 Go语言版本管理工具，类似 Node.js的 nvm或 Ruby的 rbenv。它支持快速下载、安装、切换和管理多个 Go版本，自动配置环境变量，简化 Go开发环境的搭建和维护。

install-cri-docker.sh - cri-dockerd 安装脚本

脚本功能

install-cri-docker.sh 是一个自动化安装 cri-dockerd的Shell脚本。cri-dockerd 是 Kubernetes v1.24+版本移除 Docker 支持后的兼容性解决方案，它实现了 Kubernetes 的容器运行时接口（CRI），允许 Kubernetes 集群继续使用 Docker 作为底层容器运行时。

install-docker.sh - Docker Engine 快速安装脚本

脚本功能

install-docker.sh 是一个一键式 Docker Engine 安装脚本，支持 Debian、Ubuntu、RHEL、CentOS、Alibaba Cloud Linux、Anolis OS等主流Linux发行版。脚本自动添加官方软件源、安装最新稳定版 Docker Engine及Docker Compose插件，并配置国内镜像加速器，极大简化 Docker的安装和部署流程。

install-docker2.sh - Docker 交互式安装脚本

脚本功能

install-docker2.sh 是一个功能增强的 Docker 安装脚本，提供交互式版本选择界面，支持从 Docker 官方静态二进制包安装。脚本自动获取最新 40个可用版本供用户选择，支持一键安装最新版或手动选择特定版本，并自动配置 systemd服务、Docker Compose插件和镜像加速器。