🦾 OpenClaw 完整部署教程（2026最新版）｜Windows / macOS / Linux 全平台保姆级指南

本文作者： 圣殿骑士
版本适配： OpenClaw 最新版（2026年4月更新）
难度： ⭐⭐☆☆☆ 零基础友好，建议收藏后按步骤操作

---

---

一、OpenClaw 是什么？

OpenClaw 是一款开源的本地 AI 代理框架，核心理念是「本地优先，隐私安全」。

与普通 AI 工具不同，OpenClaw 不只是"聊天"，它可以：

• 📂 访问本地文件，帮你读写文档、整理数据
• ⚙️ 执行系统命令，真正替你"干活"
• 🔌 调用第三方 API，打通各种工具链
• 💬 接入飞书、钉钉、QQ、Telegram 等聊天应用
• 🤖 多模型支持：兼容 OpenAI、Kimi、智谱 GLM、Claude 等主流大模型

💡 简单理解：OpenClaw = 可以在本地运行的"超级 AI 助手"，所有数据不出本机，隐私有保障。

---

二、环境要求

在正式安装前，请确认你的环境满足以下要求：

要求项	最低版本	推荐版本
Node.js	v22.16+	v24 LTS
操作系统	Windows 10 / macOS 12 / Linux	Windows 11 / macOS 14 / Ubuntu 22.04
内存	4GB	8GB+
网络	可访问 npm / GitHub	全球可访问（或配置镜像）

⚠️ Windows 用户特别说明：官方强烈建议在 WSL2（适用于 Linux 的 Windows 子系统） 下运行，以获得最佳体验。若坚持在原生 Windows 下运行，请以管理员身份打开 PowerShell。

---

三、安装 Node.js（已安装可跳过）

3.1 Windows 用户（推荐 NVM 方式）

第一步：安装 NVM for Windows

访问 nvm-windows releases 下载最新版 nvm-setup.exe，双击安装即可。

第二步：安装 Node.js 22

以管理员身份打开 PowerShell，依次执行：

nvm install 22.22.0
nvm use 22.22.0

第三步：验证安装

node -v
# 输出：v22.22.0

npm -v
# 输出：10.x.x

---

3.2 macOS / Linux 用户

方式一：使用 nvm（推荐）

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重载配置
source ~/.bashrc   # 或 source ~/.zshrc

# 安装 Node.js 22
nvm install 22
nvm use 22
nvm alias default 22

方式二：直接下载安装包

访问 Node.js 官网 下载对应平台安装包，按提示安装。

验证：

node -v   # v22.x.x
npm -v    # 10.x.x

---

四、安装 OpenClaw

OpenClaw 提供三种安装方式，根据你的使用场景选择：

方式一：一键脚本安装（⭐ 推荐新手）

macOS / Linux / WSL2：

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

Windows PowerShell（管理员模式）：

# 先放开执行策略
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

# 执行安装
iwr -useb https://openclaw.ai/install.ps1 | iex

💡 安装脚本会自动检测你的环境、安装 CLI 和依赖，并自动启动初始化向导，全程约 2-5 分钟。

---

方式二：npm 手动安装

如果你的网络无法访问安装脚本，可以用 npm 手动安装：

# 全局安装
npm install -g openclaw@latest

# 安装后初始化
openclaw onboard --install-daemon

pnpm 用户：

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

---

方式三：Docker 部署（适合服务器 / 进阶用户）

如果你有云服务器或 VPS，推荐用 Docker 部署，更加稳定且易于管理：

docker run -d \
  --name openclaw \
  --restart unless-stopped \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

使用 Docker Compose 管理（推荐）：

# docker-compose.yml
version: "3.8"
services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789"
    volumes:
      - ~/.openclaw:/root/.openclaw

docker compose up -d

---

方式四：从源码构建（开发者）

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖（需要 pnpm）
npm install -g pnpm
pnpm install

# 构建
pnpm ui:build
pnpm build

# 全局链接
pnpm link --global

# 初始化
openclaw onboard --install-daemon

---

五、初始化配置（onboard）

安装完成后，必须运行以下命令进行初始化：

openclaw onboard

这是一个交互式向导，按照以下流程操作：

? 是否了解并接受风险告知？ → 选择 Yes
? 请选择启动模式 → 选择 QuickStart（新手推荐）
? 请配置 AI 模型 API Key → 输入你的 API Key（如智谱 GLM-4、OpenAI 等）
? 通讯平台配置 → 选择 skip for now（稍后再配置）
? 是否安装 Skills 扩展包 → 选择 NO（稍后按需安装）
? Hooks 配置 → 选择 skip for now

💡 获取 API Key：

• 智谱 AI（GLM）：https://open.bigmodel.cn/
• OpenAI：https://platform.openai.com/
• Moonshot（Kimi）：https://platform.moonshot.cn/

---

六、启动服务

6.1 启动网关

openclaw gateway start

保持此窗口运行，或者设为后台启动：

# 后台启动（daemon 模式）
openclaw gateway start --daemon

6.2 打开 Dashboard

新开一个终端窗口：

openclaw dashboard

这会自动打开浏览器，访问地址为：http://127.0.0.1:18789
也可以手动打开浏览器，输入该地址访问。

6.3 验证安装状态

# 综合诊断
openclaw doctor

# 查看网关状态
openclaw gateway status

# 查看系统状态
openclaw status

---

七、配置 AI 模型（接入大模型）

在 Dashboard 中，点击左侧菜单 「模型配置」 或通过命令行修改：

openclaw config

常见模型配置示例

智谱 AI（GLM-4.6 / 4.7）：

{
  "provider": "zhipu",
  "model": "glm-4-plus",
  "apiKey": "your-api-key-here",
  "baseURL": "https://open.bigmodel.cn/api/paas/v4/"
}

OpenAI / 兼容接口：

{
  "provider": "openai",
  "model": "gpt-4o",
  "apiKey": "sk-xxxx",
  "baseURL": "https://api.openai.com/v1"
}

Moonshot（Kimi）：

{
  "provider": "openai",
  "model": "moonshot-v1-8k",
  "apiKey": "your-api-key-here",
  "baseURL": "https://api.moonshot.cn/v1"
}

---

八、接入飞书机器人（可选）

8.1 安装飞书插件

openclaw plugins install @m1heng-clawd/feishu

8.2 在飞书开放平台创建应用

1. 访问 飞书开放平台，登录后点击 「创建应用」
2. 选择 「企业自建应用」，填写应用名称
3. 在左侧菜单找到 「权限管理」，导入以下权限配置：

["im:message", "im:message.group_at_msg", "im:message.p2p_msg", 
 "im:resource", "im:message:send_as_bot"]

4. 在 「事件订阅」 中，选择 「长连接」 模式
5. 添加事件：搜索 im.message.receive_v1，添加并保存
6. 创建并发布应用版本

8.3 绑定机器人到 OpenClaw

# 在 OpenClaw 中启动飞书绑定
openclaw bind feishu

按提示操作：

1. 在飞书中找到你创建的机器人，发送任意消息
2. 机器人会回复一个配对码
3. 将配对码粘贴到终端中，完成绑定

---

九、常用维护命令

# 查看日志（实时）
openclaw logs --follow

# 重启网关
openclaw gateway restart

# 停止网关
openclaw gateway stop

# 更新到最新版
npm update -g openclaw

# 系统诊断
openclaw doctor

# 重新配置
openclaw config

---

十、常见问题 & 排错

❓ 问题1：命令 openclaw 找不到

原因：npm 全局路径未加入 PATH。

解决方案：

# 查看 npm 全局安装目录
npm prefix -g

# 将其 bin 目录加入 PATH（以下以 Linux/macOS 为例）
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

---

❓ 问题2：Dashboard 打不开 / 无法访问

检查步骤：

# 1. 确认网关是否正在运行
openclaw gateway status

# 2. 查看实时日志
openclaw logs --follow

# 3. 尝试重启网关
openclaw gateway restart

确认端口 18789 未被占用：

# Windows
netstat -ano | findstr :18789

# Linux / macOS
lsof -i :18789

---

❓ 问题3：Windows PowerShell 提示"不允许执行脚本"

解决方案：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

---

❓ 问题4：API Key 调用失败 / 模型无响应

检查清单：

• API Key 是否正确、未过期
• baseURL 是否填写正确
• 账号余额是否充足
• 网络是否能访问对应的 API 服务

---

❓ 问题5：初始化失败 / onboard 卡住

# 重新运行初始化
openclaw onboard

# 如果还不行，清除配置重试
rm -rf ~/.openclaw   # Linux/macOS
# Windows: 删除 C:\Users\用户名\.openclaw 文件夹

openclaw onboard --install-daemon

---

十一、安全建议

⚠️ OpenClaw 具有执行系统命令的能力，请务必注意以下安全事项！

1. 隔离部署：不建议在主力生产机上直接部署，优先使用虚拟机或云服务器
2. 最小权限原则：不要赋予 AI 不必要的高权限
3. 定期更新：及时更新到最新版本，修复已知安全漏洞
4. 网络隔离：如部署在服务器上，建议配置防火墙，限制 Dashboard 端口的访问来源
5. API Key 保护：不要将含 API Key 的配置文件提交到公开代码仓库

---

十二、环境变量参考

变量名	说明	示例
OPENCLAW_HOME	OpenClaw 主目录路径	/home/user/.openclaw
OPENCLAW_STATE_DIR	可变状态数据存储路径	/var/openclaw/state
OPENCLAW_CONFIG_PATH	配置文件路径	/etc/openclaw/config.json

---

十三、总结

至此，你已完成 OpenClaw 的完整部署！整个流程回顾：

步骤	内容	状态
1	安装 Node.js 22+	✅
2	安装 OpenClaw	✅
3	运行 openclaw onboard 初始化	✅
4	启动网关服务	✅
5	访问 Dashboard	✅
6	配置 AI 模型 API Key	✅
7	（可选）接入飞书/钉钉等平台	⚙️ 按需

---

📌 参考资料

• OpenClaw 官方文档：https://docs.openclaw.ai/
• OpenClaw GitHub：https://github.com/openclaw/openclaw
• 飞书开放平台：https://open.feishu.cn/

---

💬 如果本文对你有帮助，欢迎点赞 👍 收藏 ⭐ 关注！有任何问题欢迎在评论区留言。

---

最后更新：2026年4月