OpenClaw部署安装指南 Mac/Windows/Linux三大平台全流程详解

前提条件与推荐配置

为了获得最佳体验，推荐：

操作系统：

• Mac（强烈推荐）：原生支持最完善，可操作日历、备忘附录、截图等系统功能
•  Windows：完全可用，但部分系统集成功能受限
•  Linux：适合开发布者，配置灵活

IM工具选择：

• 国外用户：推荐 Telegram（适配度最好，功能最完整）
• 国内用户：推荐 飞书（现代化、开发布友好、功能丰富）
• 备选：企业微信、钉钉、QQ

部署方式：

• 有Mac电脑：推荐本地部署（体验最好，功能最全）
• 无Mac或想24小时运行：推荐云端部署（成本低，稳定可靠）

Mac本地部署

最佳体验：如果你有Mac电脑，强烈推荐本地部署，体验最好、功能最全！

为什么选择Mac本地部署？

优势：

• 系统集成：可操作日历、备忘附录、文件系统
• 隐私安全：数据完全本地，不上传云端
• 响应速度快：本地运行，无网络延迟
• 功能最全：支持所有高级功能
• 成本低：无需购买云服务器
• 开发布友好：方便调试和自定义

适合人群：

• 有Mac电脑的用户
• 注重隐私的用户
• 需要系统集成功能的用户
• 开发布者和技术爱好者

硬件要求：

• CPU：M系列芯片或Intel i5以上
• 内存：8GB以上（推荐16GB）
• 硬盘：10GB以上空闲空间

系统版本：

• macOS 12 Monterey 或更高版本
• 推荐 macOS 14 Sonoma 或 macOS 15 Sequoia

前置软件：

• Node.js 22.0.0+（会自动安装）
• Homebrew（可选，用于安装依赖）

安装步骤

第一步：打开终端

1. 按 Command + 空格 打开 Spotlight
2. 输入 Terminal或终端
3. 按回车打开终端

第二步：安装 OpenClaw

在终端中执行以下命令：

curl -fsSL https://openclaw.ai/install.sh | bash

安装过程会自动：

• 检测系统环境
• 安装Node.js（如果未安装）
• 下载OpenClaw
• 配置环境变量

预计时间：2-5分钟

第三步：验证安装

安装完成后，执行以下命令验证：

openclaw --version

如果显示版本号（如 2026.3.10），说明安装成功！

第四步：初始化配置

运行配置向导：

openclaw onboard

配置流程：

1. 接受风险提示：

选择 Yes继续

2. 选择启动模式：

推荐选择 QuickStart快速启动：

3. 选择AI模型：

选择你的AI供应商（支持国内外主流模型）：

国内推荐：

• Kimi（Moonshot AI）：长文本专家，200万字上下文
• DeepSeek：性价比之王，推理能力强
• 智谱GLM：中文理解好，多模态支持

4. 输入API Key：

根据选择的模型，输入对应的API Key

5. 选择聊天工具：

• 如果要接入飞书/Telegram，选择对应选项
• 如果暂时不接入，选择 None（后续可配置）

6. Gateway端口设置：

默认 18789即可：

7. 选择Skills：

使用空格键选择你需要的技能，也可以直接跳过：

8. API Key配置：

没有的可以选择 no跳过：

9. 启用Hooks：

推荐启用这三个钩子（用于内内容引导、日志和会话记附录）：

10. 完成配置：

配置完成后，会自动启动Gateway服务并打开Web UI（http://127.0.0.1:18789/chat）

第五步：验证安装

# 检查Gateway状态openclaw channels status# 应该显示：# Gateway reachable.

日常使用

启动OpenClaw：

# 启动Gateway服务openclaw gateway start# 或使用systemd（推荐，开机自启）openclaw gateway enable

访问Web UI：

打开浏览器访问：http://127.0.0.1:18789/chat

停止服务：

openclaw gateway stop

常见访问题

Q1：安装时提示权限不足？

# 使用sudo安装curl -fsSL https://openclaw.ai/install.sh | sudo bash

Q2：如何更新OpenClaw？

openclaw update

Q3：如何卸载？

openclaw uninstall

Windows本地部署

硬件要求：

• CPU：2核以上
• 内存：4GB以上（推荐8GB）
• 硬盘：10GB以上空闲空间

操作系统：

• Windows 10 或 Windows 11

前置软件：

• Node.js 22.0.0+

PowerShell原生部署

第一步：安装Node.js 22+

方法一：官网下载安装

1. 访问 https://nodejs.org/zh-cn
2. 下载Windows安装包（LTS版本22.x）
3. 运行安装程序，勾选「自动安装必要的工具」

第二步：验证Node.js安装

# 打开PowerShellnode -vnpm -v

第三步：以管理员身份安装 OpenClaw

重要：必须以管理员身份运行PowerShell。

# 安装最新稳定版npm install -g openclaw@latest# 或安装汉化版npm install -g @qingchencloud/openclaw-zh@latest

第四步：解决安装权限访问题

如果遇到权限错误：

# 方法A：启用PowerShell脚本执行Set-ExecutionPolicy-ExecutionPolicy RemoteSigned -Scope CurrentUser# 方法B：修改npm安装目附录npm config set prefix "C:\npm"npm config set cache "C:\npm-cache"# 将目附录添加到PATH[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\npm", "User")

第五步：验证安装

openclaw --versionopenclaw --help

第六步：解决常见访问题

访问题：sharp模块加载失败

# 清理npm缓存npm cache clean --force# 重新安装npm install -g openclaw@latest --force

访问题：Windows Defender阻止

将OpenClaw安装目附录添加到Windows Defender排除项：

C:\Users\你的用户名\AppData\Roaming\npmC:\Users\你的用户名\.openclaw

初始化配置

安装完成后，需要运行初始化向导。

启动初始化向导

openclaw onboard --install-daemon

配置AI模型提供商

OpenClaw需要对接AI模型才能工作。

以配置Anthropic Claude（推荐）为例：

# WSL2或PowerShellopenclaw models auth add# 按提示选择 anthropic# 输入 API Key: sk-ant-xxx

Windows常用命令速查

系统管理：

配置管理：

Linux本地部署

Linux用户：适合开发者发布，配置灵活。

推荐发布行版：

• Ubuntu 20.04+
• Debian 11+
• CentOS 8+

安装步骤

第一步：安装Node.js

# Ubuntu/Debiancurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt-get install -y nodejs# 验证安装node --version

第二步：安装 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash

第三步：验证安装

openclaw --version

第四步：初始化配置

openclaw onboard

最后测试连接

1. 访问WebUI：打开访问地址
2. 发布送测试聊天消息，得到龙虾的回复：

恭喜你，你的专属小龙虾安装成功啦！

本期Leo带来的是本地安装的全流程，接下来给大家带来更为简单的云服务部署方案和飞书、微信等详细的接入方法。关注我不迷路。

关注公众号：Leo的AI分享与思考，不定期免费送AI干货资料，从入门到进阶，帮你深度了解AI。