📥 第一步:下载安装器
🚀 第二步:运行安装器
- 双击下载的
OpenClaw-Installer-Windows-0.3.0.exe 文件
- 如果 Windows SmartScreen 弹出警告:点击"更多信息"→"仍要运行"
- 按照安装向导完成安装
🔑 第三步:输入授权码
- 启动 OpenClaw 安装器,点击"开始安装"
- 点击"微信支付(打开网页)"在浏览器完成支付
- 支付成功后获取授权码返回输入
💡 提示点击"微信支付"按钮会自动打开浏览器到支付页面,完成支付后复制授权码返回安装器输入即可。
🔍 第四步:硬件检测
授权验证通过后,安装器会自动检测您的硬件配置:CPU、内存、显卡
📦 第五步:安装 Ollama
安装器会自动检测 Ollama 是否已安装:
- 如果已安装:直接进入模型选择步骤
- 如果未安装:
- 安装器会自动下载 Ollama 安装程序
- 弹出安装向导,按提示完成安装
- 安装完成后,点击 「重新检测 Ollama」 按钮
- 检测通过后继续下一步
⚠️ 如果自动安装失败
Windows 上 Ollama 安装程序需要用户交互,无法静默安装。如果自动安装卡住或失败:
- 点击 「打开 Ollama 官网」 按钮手动下载
- 或直接访问:https://ollama.com/download
- 下载 Windows 版本并安装
- 安装完成后,回到安装器点击 「重新检测 Ollama」
💡 按钮说明
- 重新检测 Ollama:安装完成后点击此按钮验证是否安装成功
- 打开 Ollama 官网:在浏览器打开官方下载页面
- 重试安装:重新尝试自动下载和安装
🤖 第六步:选择并安装模型
根据硬件检测结果选择推荐模型,点击安装即可。模型下载可能需要几分钟到十几分钟,取决于模型大小和网络速度。
✅ 第七步:安装完成
🎉 恭喜!您已成功安装 OpenClaw 本地版。现在可以享受零 API 费用的 AI 体验了!
🎉 推荐使用 AppImage无需安装依赖,无需 root 权限,下载即可运行!支持所有 Linux 发行版(Ubuntu、Debian、Fedora、CentOS、Arch 等)。
📥 方式一:AppImage(强烈推荐)
AppImage 是一种通用的 Linux 应用格式,无需安装,直接运行即可。
第一步:下载
wget https://shiping.ku1818.com.cn/openclaw/OpenClaw-Installer-Linux-0.3.0.AppImage
第二步:添加执行权限
chmod +x OpenClaw-Installer-Linux-0.3.0.AppImage
第三步:运行
./OpenClaw-Installer-Linux-0.3.0.AppImage
💡 提示
- 双击 AppImage 文件即可运行(需要在文件管理器中设置"允许执行")
- 或右键 → 属性 → 权限 → 勾选"允许作为程序执行"
- 首次运行可能需要几秒钟解压,请耐心等待
常见问题
无法运行?
如果提示权限不足,请确保已添加执行权限:
chmod +x OpenClaw-Installer-Linux-0.3.0.AppImage
FUSE 错误?
某些系统可能需要安装 FUSE:
Ubuntu/Debian:
sudo apt install fuse libfuse2
Fedora:
sudo dnf install fuse
Arch Linux:
sudo pacman -S fuse2
⚠️ 运行后闪退/崩溃?
如果运行 AppImage 后立即崩溃或闪退,请按以下步骤操作:
- 确保使用的是 v0.3.0 或更高版本(v0.2.8 及以下存在已知 bug)
- 从终端运行查看错误信息:
./OpenClaw-Installer-Linux-0.3.0.AppImage
- 如仍有问题,请提交工单反馈
第四步:安装 Ollama(⚠️ 必需步骤!)
⚠️ 重要!Linux 必须手动安装 Ollama
与 Windows 不同,Linux 上安装器 无法自动安装 Ollama,必须手动安装!
安装命令:
curl -fsSL https://ollama.com/install.sh | sh
验证安装:
ollama --version
如果显示版本号(如 ollama version is 0.1.xx),说明安装成功。
第五步:启动 Ollama 服务
ollama serve &
此命令在后台启动 Ollama 服务。如果不运行此命令,模型下载会失败。
第六步:回到安装器继续
- 返回 OpenClaw 安装器窗口
- 点击 「重新检测 Ollama」 按钮
- 检测通过后,选择模型并安装
💡 按钮说明
- 重新检测 Ollama:手动安装完成后点击此按钮验证
- 打开 Ollama 官网:查看官方文档和安装说明
- 重试安装:在 Linux 上无效,必须手动安装
📦 方式二:DEB/RPM 安装
💡 选择适合您系统的安装包- DEB 格式:Ubuntu、Debian、Linux Mint
- RPM 格式:Fedora、RHEL、CentOS、openSUSE
第一步:安装依赖
Debian/Ubuntu:
sudo apt update && sudo apt install -y libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev patchelf
Fedora:
sudo dnf install -y webkit2gtk4.1-devel gtk3-devel libappindicator-gtk3-devel librsvg2-devel patchelf
第二步:下载安装包
Debian/Ubuntu 系统:
wget https://shiping.ku1818.com.cn/openclaw/OpenClaw-Installer-Linux-0.3.0.deb
Fedora/RHEL/CentOS 系统:
wget https://shiping.ku1818.com.cn/openclaw/OpenClaw-Installer-Linux-0.3.0.rpm
第三步:安装
Debian/Ubuntu:
sudo apt install ./OpenClaw-Installer-Linux-0.3.0.deb
Fedora:
sudo dnf install ./OpenClaw-Installer-Linux-0.3.0.rpm
RHEL/CentOS:
sudo yum localinstall ./OpenClaw-Installer-Linux-0.3.0.rpm
运行
openclaw-local-installer
🎉 恭喜!您已成功安装 OpenClaw 本地版!
📥 第一步:下载安装器
💡 Universal 版本同时支持 Intel 和 Apple Silicon (M1/M2/M3)
🚀 第二步:安装应用
- 双击 DMG 文件
- 将 OpenClaw Installer 拖到 Applications
- 打开应用程序
⚠️ macOS 安全提示如果提示"无法验证开发者",请在系统设置 → 隐私与安全性中点击"仍要打开"
🔑 第三步:输入授权码
点击"微信支付"在浏览器完成支付,获取授权码返回输入。
📦 第四步:安装 Ollama
安装器会自动检测 Ollama:
- 如果已安装:直接进入模型选择
- 如果未安装:点击「打开 Ollama 官网」下载 macOS 版本安装
brew install ollama
安装完成后,点击「重新检测 Ollama」继续。
🤖 第五步:选择并安装模型
根据硬件检测结果选择推荐模型。Apple Silicon (M1/M2/M3) 推荐使用 Qwen2.5-7B 或更大模型。
🎉 恭喜!您已成功安装 OpenClaw 本地版!