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
[*]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 的本地部署。
页:
[1]