OpenClaw（曾用名 Clawdbot/Moltbot）是 2026年最热门的开源AI智能体框架，被誉为“真正能做事的AI”。它运行在本地，支持文件操作、命令执行、浏览器自动化等全场景任务，并可通过 Telegram、Discord、钉钉、飞书、微信（需配置）等聊天工具或 Web 面板进行交互。
以下是针对 macOS 和 Windows 系统的完整部署指南，包含环境准备、安装、配置及常见问题解决。
1、前置条件（通用）
无论使用 Mac 还是 Windows，请先确保满足以下条件：
1、Node.js 环境：OpenClaw 基于 TypeScript 开发，强依赖 Node.js。
- 版本要求：推荐 Node.js v20.x 或 v22.x (LTS 版本)。低于 v18.x 可能无法运行。
- npm/pnpm：随 Node.js 自动安装，建议使用 pnpm 以获得更快的安装速度（可选）。
2、网络连接：
- 需要能够访问 GitHub 和 npm 仓库（国内用户建议配置镜像源）。
- 需要能够访问你所选的大模型 API（如 DeepSeek, OpenAI, Anthropic 等）。
3、大模型 API Key：OpenClaw 本身不提供模型，需自行准备 API Key（推荐阿里云百炼/DeepSeek，新用户有免费额度）。
MacOS系统部署指南
第一步：安装 Node.js 环境
1.检查是否已安装：
打开终端（Terminal），输入：
node -v
npm -v
如果显示版本号且 Node >= 20，可跳过此步。
2.安装/升级 Node.js（推荐方法）：
方法 A（推荐 - 使用 Homebrew）：
brew install node@22
# 或者安装最新版 LTS
brew install node
方法 B（官网下载）：
访问 nodejs.org 下载 macOS 安装包 (.pkg) 并按向导安装。
第二步：安装 OpenClaw
打开终端，执行以下命令进行全局安装：
# 1. (可选) 配置国内 npm 镜像源，加速下载
npm config set registry https://registry.npmmirror.com
# 2. 安装 OpenClaw 最新稳定版
npm install -g openclaw@latest
注意：如果遇到权限错误（EACCES），请在命令前加 sudo，或在 macOS 上修复 npm 权限（推荐后者）。
第三步：验证与初始化
1.验证安装：
openclaw --version
openclaw --help
若输出版本号和帮助菜单，说明安装成功。
2.运行配置向导（Onboarding）：
首次使用必须运行配置向导，它会引导你设置 API Key 和本地路径。
openclaw onboard
# 或者中文版
# openclaw-zh onboard
- 按提示选择大模型提供商（如 DeepSeek, OpenAI）。
- 输入你的 API Key。
- 确认工作目录（默认 ~/.openclaw）。
第四步：启动服务
配置完成后，启动 OpenClaw 守护进程：
openclaw start
# 或者直接运行交互式模式
openclaw run
启动成功后，通常会在终端显示 Web 面板地址，默认为：http://127.0.0.1:18789
在浏览器打开该地址，即可通过图形化界面与 AI 交互。
Windows系统部署指南
Windows用户需注意 PowerShell 权限和环境变量问题。
第一步：安装 Node.js 环境
1.下载安装包：
访问 nodejs.org，下载 Windows Installer (.msi)，建议选择 LTS (Long Term Support) 版本（v20 或 v22）。
2.安装过程：
- 双击运行安装包。
- 勾选 "Automatically install the necessary tools"（如果需要编译原生模块）。
- 保持默认路径安装。
3.验证安装：
打开 PowerShell 或 CMD（建议以管理员身份运行一次），输入：
node -v
npm -v
第二步：配置 npm 镜像（强烈推荐）
国内网络直接安装容易超时，请配置淘宝镜像：
npm config set registry https://registry.npmmirror.com
第三步：安装 OpenClaw
在 PowerShell 中执行（注意：若遇到执行策略报错，需先运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser）:
# 安装最新版
npm install -g openclaw@latest
# 或者安装中文汉化版
# npm install -g @qingchencloud/openclaw-zh@latest
常见坑点：如果提示 EPERM 或权限不足，请以管理员身份运行 PowerShell 后再执行上述命令。
第四步：配置与启动
1.初始化配置：
openclaw onboard
按向导输入 API Key（推荐使用 DeepSeek 或阿里云百炼，成本低且速度快）。
2.启动服务：
openclaw start
或者直接在后台运行：
openclaw run
3.访问面板：
打开浏览器访问 http://127.0.0.1:18789。
核心配置与技能扩展
安装只是第一步，配置好模型和技能才能发挥威力。
1. 配置文件位置
- Mac/Linux: ~/.openclaw/config.json 或 ~/.openclaw/openclaw.config.ts
- Windows: C:\Users\你的用户名\.openclaw\config.json
2. 推荐模型配置 (以 DeepSeek 为例)
在配置向导中选择 Custom Provider 或直接编辑配置文件：
- Base URL: https://api.deepseek.com (或通过阿里云百炼中转)
- Model Name: deepseek-chat 或 deepseek-reasoner
- API Key: 填入你的密钥
3. 安装技能插件 (Skills)
OpenClaw 的强大在于 Skill 生态。你可以在 Web 面板的 "Skill Store" 中一键安装，或使用命令行：
openclaw skill install
热门技能推荐：
- browser-control: 浏览器自动化控制
- file-manager: 本地文件整理
- github-helper: 代码库管理
- wechat-bot: 微信消息接入（需额外配置）
进阶建议
1.Docker 部署：如果你熟悉 Docker，可以使用容器化部署，避免环境污染。
docker run -d -p 18789:18789 -v ~/.openclaw:/app/data openclaw/openclaw:latest
2.云服务器：对于需要 24 小时运行的场景，建议部署在阿里云/腾讯云 ECS 上，配合内网穿透或公网 IP 使用。
3.隐私安全：OpenClaw 是本地优先架构，数据主要存储在本地，但请妥善保管你的 config.json 文件和 API Key，不要上传到公共代码库。
通过以上步骤，你应该能在 Mac 或 Windows 上成功搭建属于自己的 AI 智能助手。如有具体报错，可查看官方文档或社区 Issue。