← 返回教程列表

🦞 OpenClaw 本地安装教程

版本:v2026.4.26 · 更新于:2026年4月

💡 什么是 OpenClaw? OpenClaw 是最流行的开源 AI Agent 客户端,支持 MCP Server 与 SKILL.md,可接入多种 LLM。运行在你自己的电脑上,数据完全私有。

📋 系统要求

操作系统支持版本备注
macOSmacOS 12 (Monterey) 及以上Intel 和 Apple Silicon 均支持
WindowsWindows 10/11 (64-bit)需安装 Git
LinuxUbuntu 20.04+, Debian 11+, Fedora 36+需安装 Git 和 curl

🍎 macOS 安装

1
下载安装包

从官方 GitHub 下载最新版 DMG:

curl -LO https://github.com/openclaw/openclaw/releases/download/v2026.4.26/OpenClaw-2026.4.26.dmg

或直接浏览器打开:github.com/openclaw/openclaw/releases

2
安装应用

双击 DMG 文件,将 OpenClaw 拖入 Applications 文件夹。

3
首次启动

打开 Applications → OpenClaw。首次启动会提示安全设置,按提示前往系统设置 → 隐私与安全性允许运行。

4
配置 LLM 模型

启动后进入设置界面,添加你的 LLM Provider:

  • OpenAI API Key
  • Anthropic Claude API Key
  • 或本地运行 Ollama(参见下方 Homebrew 方式)

🍺 可选:通过 Homebrew 安装(推荐开发者)

brew install openclaw/tap/openclaw

安装后通过命令行启动:

openclaw

🪟 Windows 安装

1
下载安装包

访问 Releases 页面下载最新版 OpenClaw-Setup-*.exe

https://github.com/openclaw/openclaw/releases

2
运行安装程序

双击运行安装程序,一路点"下一步"即可。

3
启动 OpenClaw

从开始菜单打开 OpenClaw,首次启动会自动检查环境。

如果系统提示缺少 Git,请先安装 Git for Windows

🐧 Linux 安装

1
下载并解压
wget https://github.com/openclaw/openclaw/releases/download/v2026.4.26/OpenClaw-2026.4.26.zip
unzip OpenClaw-2026.4.26.zip -d ~/openclaw
2
安装依赖
# Ubuntu/Debian
sudo apt install -y git curl libgtk-3-0 libwebkit2gtk-4.1-0

# Fedora
sudo dnf install -y git curl gtk3 webkit2gtk4.1
3
启动 OpenClaw
cd ~/openclaw
./openclaw

🔧 常见问题

启动后提示"找不到模型"

进入 Settings → Models,添加至少一个 LLM Provider 的 API Key。

macOS 提示"无法验证开发者"

前往 系统设置 → 隐私与安全性 → 安全性,点击"仍要打开"。

如何卸载?

macOS:将 OpenClaw 从 Applications 移到废纸篓即可。
Windows:控制面板 → 程序和功能 → 卸载 OpenClaw。
Linux:直接删除解压目录。

📖 下一步

安装完成后,建议:


xia007 · 养虾人的导航站