Windows 安装教程
以下步骤适用于 Windows 10/11 系统。
第一步：下载安装包
- 打开浏览器访问 GitHub 发布页面：
https://github.com/death1818/openclaw-local-installer/releases
- 找到最新版本，点击 Assets 展开下载列表
- 下载
OpenClaw-*-x64.exe 文件（约 60MB）
- 或者复制下载链接，用命令下载：
# 方法一：直接下载 exe 文件
# 访问以上链接，点击 exe 文件下载
# 方法二：使用 PowerShell 下载
# 打开 PowerShell，执行：
Invoke-WebRequest -Uri "https://github.com/death1818/openclaw-local-installer/releases/latest/download/OpenClaw-2.2.1-x64.exe" -OutFile "OpenClaw.exe"
第二步：运行安装程序
- 找到下载的
OpenClaw.exe 文件（通常在下载文件夹）
- 右键点击 → 选择"以管理员身份运行"
- 如果弹出"用户账户控制"窗口，点击"是"
- 安装程序界面会启动
第三步：安装 Ollama（如未安装）
- 安装程序会自动检测系统是否已安装 Ollama
- 如果没有安装，会提示："未检测到 Ollama"
- 点击 "自动安装 Ollama" 按钮
- 等待 Ollama 安装完成（约 2-3 分钟）
💡 手动安装 Ollama
如果自动安装失败，可以手动安装：
# 方法一：使用 PowerShell（推荐）
# 以管理员身份打开 PowerShell，执行：
irm https://ollama.com/install.ps1 | iex
# 方法二：下载安装包
# 访问 https://github.com/ollama/ollama/releases 下载 ollama-setup.exe
第四步：输入授权码
- 安装程序会提示输入授权码
- 输入购买后获得的授权码（如
OPENCLAW-XXXX-XXXX-XXXX）
- 点击"确认"或按回车
- 授权码正确后会显示"激活成功"
第五步：等待模型下载
- 激活成功后，安装程序会自动开始下载默认模型
- 推荐下载
phi3.5（约 2GB）
- 下载进度条会显示下载进度
- 下载完成后会自动启动服务
⚠️ 模型下载失败？
如果下载失败，可能是网络问题：
- 国内用户需要开启 VPN/代理
- 或手动下载：打开 CMD 执行
ollama pull phi3.5
- 可尝试更小的模型：
ollama pull qwen2.5:0.5b
第六步：开始使用
- 打开浏览器访问：
http://localhost:18789
- 如果打不开，见下方常见问题
常见问题
⚠️ 安装后打不开？
如果安装后无法打开：
- 检查 Ollama 是否正常运行：
# 打开 CMD 或 PowerShell，执行：
ollama --version
# 如果显示版本号，说明 Ollama 正常
# 如果显示"不是内部或外部命令"，需要添加环境变量
- 尝试手动启动 Ollama：
# 打开 CMD，执行：
ollama serve
⚠️ 页面是白的/空白？
如果打开 http://localhost:18789 是空白：
- 清除浏览器缓存：Ctrl + Shift + Delete
- 尝试其他浏览器（Chrome/Edge/Firefox）
- 重启 Ollama 服务：
ollama serve
- 重启电脑后重试
⚠️ 杀毒软件拦截？
如果被杀毒软件阻止：
- 添加信任区：杀毒软件 → 设置 → 信任区
- 临时关闭实时保护
- 允许所有 OpenClaw 相关程序运行
💡 常用命令
- 查看 Ollama 版本：
ollama --version
- 查看已安装模型：
ollama list
- 手动下载模型：
ollama pull phi3.5
- 删除模型：
ollama rm 模型名
- 查看运行状态：
ollama ps
💡 性能优化建议
- 关闭 Windows Defender 实时保护可以提升性能
- 建议使用 Chrome 或 Edge 浏览器
- 确保磁盘至少有 5GB 可用空间
- 推荐 16GB+ 内存体验更佳
macOS 手动安装
以下步骤适用于 macOS 11 (Big Sur) 及以上版本，支持 Intel 和 Apple Silicon (M1/M2/M3/M4) 芯片。
第一步：确定你的芯片类型
- 点击屏幕左上角苹果图标 → 关于本机
- 查看"芯片"一栏：
- Apple Silicon（M1/M2/M3/M4）：下载
-arm64.dmg 文件
- Intel：下载
-x86_64.dmg 文件
第二步：下载安装包
- 打开浏览器访问 GitHub 发布页面：
https://github.com/death1818/openclaw-local-installer/releases
- 找到最新版本，点击 Assets 展开下载列表
- 根据你的芯片下载对应版本：
- Apple Silicon (M1-M4)：
OpenClaw-*-arm64.dmg
- Intel Mac：
OpenClaw-*-x86_64.dmg
- 或者在终端用命令下载：
# Apple Silicon (M1-M4) 下载命令
curl -L -o OpenClaw.dmg "https://github.com/death1818/openclaw-local-installer/releases/latest/download/OpenClaw-2.2.1-arm64.dmg"
# Intel Mac 下载命令
# curl -L -o OpenClaw.dmg "https://github.com/death1818/openclaw-local-installer/releases/latest/download/OpenClaw-2.2.1-x86_64.dmg"
第三步：安装应用
- 双击下载的
.dmg 文件
- 在打开的窗口中，将 OpenClaw 图标拖拽到"应用程序"文件夹
- 等待复制完成（约需 1-2 分钟）
- 复制完成后，可以关闭该窗口
第四步：允许运行（关键步骤）
- 首次运行 OpenClaw 时，系统会阻止运行
- 打开 系统设置 → 隐私与安全性
- 找到"已阻止使用"的 OpenClaw
- 点击"仍要打开"
- 在弹出的确认对话框中点击"打开"
⚠️ 如果找不到选项
也可以右键点击应用程序中的 OpenClaw → 选择"打开" → 点击"打开"按钮
第五步：安装 Ollama（如未安装）
- OpenClaw 安装程序会自动检测 Ollama 是否已安装
- 如果没有安装，会提示安装 Ollama
- 点击"自动安装 Ollama"或手动安装：
# 打开终端（Command + Space，输入 terminal）
# 执行以下命令安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh
第六步：输入授权码激活
- 安装程序会提示输入授权码
- 输入购买后获得的授权码（如
OPENCLAW-XXXX-XXXX-XXXX）
- 按回车确认激活
第七步：等待模型下载
- 激活成功后，安装程序会自动下载默认模型
- 推荐下载
phi3.5（约 2GB）
- 下载完成后会自动启动服务
第八步：开始使用
- 打开浏览器访问：
http://localhost:18789
- 如果打不开，尝试重启 Ollama：
# 在终端中执行
ollama serve
# 查看已安装的模型
ollama list
常见问题
⚠️ 无法打开应用程序
如果提示"无法打开"或"已损坏"：
# 在终端执行以下命令（需要管理员密码）
xattr -cr /Applications/OpenClaw.app
💡 Apple Silicon 优化建议
- 推荐使用
qwen2.5:0.5b 或 phi3.5 模型
- M 系列芯片运行这些模型非常流畅
- 内存占用比 Intel 版本更低
💡 常用命令汇总
- 查看 Ollama 版本：
ollama --version
- 查看已安装模型：
ollama list
- 手动下载模型：
ollama pull phi3.5
- 删除模型：
ollama rm 模型名