OpenClaw 本地部署教程：Mac / Windows / Linux 安装、配置与常见问题

刘诗楠

一、OpenClaw 是什么

OpenClaw 是一个开源的本地 AI Agent 框架，可以在自己的电脑或服务器上运行，并连接飞书、钉钉、QQ、 Telegram、Discord、Slack、WhatsApp 等聊天应用，把大模型变成一个可执行任务的 AI 助手。

与普通 AI 工具不同，OpenClaw 可以访问文件、执行命令、调用 API，并通过消息平台与用户交互，因此适合构建个人 AI 助理、自动化工具或 AI 工作流系统。

OpenClaw 的一个重要特点是 本地运行（local-first）：
用户可以把数据、API Key 和运行逻辑保存在自己的设备中，避免依赖云端服务。

---

二、安装 OpenClaw 前的准备

在开始安装之前，需要确认系统环境满足要求。

系统要求

• macOS / Linux / Windows（建议使用 WSL2）
• Node.js 22 或更高版本
• 可以访问 GitHub / npm
• 终端环境（Terminal / PowerShell）
  

OpenClaw 基于 Node.js 构建，因此需要 Node 22+ 环境。

可以在终端运行下面命令行，先检查 Node 版本：

• node --version
  

如果版本低于 22，建议先升级 Node。

Node官网地址：https://nodejs.org/

---

三、OpenClaw 最简单安装方法（官方推荐）

OpenClaw 官方提供了一条 一键安装脚本，这是最推荐的方式。

macOS / Linux / WSL2

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

Windows（PowerShell）

• iwr -useb https://openclaw.ai/install.ps1 | iex
  

该脚本会自动完成：

• Node 环境检测
• CLI 安装
• 依赖安装
• 启动初始化向导
  

这是官方推荐的安装方式。

如果只想安装，不想自动进入初始化流程，可以使用：

• curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
  

---

四、使用 npm 手动安装 OpenClaw

如果你已经安装好 Node 22+，也可以手动安装 CLI。

• npm install -g openclaw@latest
  

安装完成后运行初始化：

• openclaw onboard --install-daemon
  

这个命令会启动 OpenClaw onboarding 向导，并自动安装 Gateway 服务。

完成后 OpenClaw 会以后台服务形式运行。

---

五、OpenClaw 初始化配置（Onboarding）

首次运行 OpenClaw 时，需要进行初始化配置：

• openclaw onboard --install-daemon
  

初始化流程通常包括：

• 设置 OpenClaw Gateway
• 创建 workspace
• 配置安全认证
• 选择聊天平台
• 绑定模型 API
  

整个流程是一个 交互式向导。

配置完成后，Gateway 会作为后台服务运行。

---

六、验证 OpenClaw 是否安装成功

安装完成后，可以通过以下命令检查：

查看服务状态

• openclaw gateway status
  

查看系统状态

• openclaw status
  

如果 Gateway 正常运行，就说明 OpenClaw 安装成功。

---

七、打开 OpenClaw 控制台

OpenClaw 提供了 Web Dashboard，可以直接在浏览器里与 AI 聊天。

运行：

• openclaw dashboard
  

或者直接访问：

• http://127.0.0.1:18789
  

Dashboard 打开后，就可以开始和 AI 对话。

官方文档也建议先使用 Dashboard 测试，再配置聊天通道。

---

八、连接聊天应用（可选）

OpenClaw 可以接入多个聊天平台：

• 飞书
• 钉钉
• Telegram
• Discord
• Slack
• WhatsApp
• Signal
• iMessage
  

通过这些平台，你可以在聊天软件中直接控制 AI Agent。

但对于第一次部署 OpenClaw 的用户来说，建议先确认本地 Dashboard 能正常运行，再接入聊天应用。

---

九、Docker 部署（进阶）

如果你希望把 OpenClaw 运行在容器环境，可以使用 Docker。

常见步骤：

• docker compose run --rm openclaw-cli onboard
  docker compose up -d openclaw-gateway
  

这种方式适合：

• VPS服务器
• 云端部署
• 隔离运行环境
  

不太适合完全新手。

---

十、常见问题与排错

1 安装完成后 openclaw 命令找不到

可能原因：

• Node PATH 未正确配置
• npm 全局路径未加入 PATH
  

可以尝试重新安装：

• npm install -g openclaw@latest
  

---

2 Dashboard 打不开

先检查 Gateway：

• openclaw gateway status
  

再查看日志：

• openclaw logs --follow
  

---

3 初始化失败

可以重新运行：

• openclaw onboard
  

---

十一、安全注意事项

OpenClaw 是一个可以执行系统操作的 AI Agent，因此需要注意安全。

建议：

• 不要在主工作机直接运行
• 最好在虚拟机或 VPS 运行
• 不要给 AI 过高权限
• 不要安装不可信插件
  

近期研究人员还发现 OpenClaw Gateway 的认证机制曾存在漏洞，因此建议及时升级到最新版本。

---

十二、总结

OpenClaw 是目前非常受欢迎的本地 AI Agent 框架，可以让大模型直接连接到聊天应用并执行任务。

整个部署流程大致为：

1 安装 OpenClaw
2 运行 onboarding 初始化
3 启动 Gateway
4 打开 Dashboard
5 接入聊天平台

只要按照上面的步骤操作，大多数用户都可以在几分钟内完成 OpenClaw 的本地部署。