OpenClaw 本地部署详细教程
OpenClaw 是一款强大的 AI 助手框架,可以帮助你快速搭建自己的 AI 助手服务。它支持多种渠道接入(飞书、Telegram、Discord 等),并且可以连接多种 AI 提供商。本文将详细介绍如何在本地电脑上部署 OpenClaw。OpenClaw 部署非常简单,几分钟就能搭建完成。它提供了丰富的渠道接入能力,是个人或团队搭建 AI 助手的优秀选择。如果大家在部署过程中遇到问题,欢迎在评
前言
OpenClaw 是一款强大的 AI 助手框架,可以帮助你快速搭建自己的 AI 助手服务。它支持多种渠道接入(飞书、Telegram、Discord 等),并且可以连接多种 AI 提供商。
本文将详细介绍如何在本地电脑上部署 OpenClaw。
环境要求
- 操作系统:macOS、Linux 或 Windows(推荐 WSL2)
- Node.js:Node 24(推荐)或 Node 22 LTS
- pnpm:如果你选择源码安装
💡 Windows 用户建议使用 WSL2,可以避免很多兼容性问题
安装方式一:安装脚本(推荐)
这是最简单的方式,脚本会自动检测并安装 Node.js。
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
运行完成后,脚本会自动启动引导配置,按照提示完成设置即可。
如果不想自动引导,可以加参数:
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
安装方式二:npm 安装
如果你已经安装了 Node.js,可以使用 npm 安装:
npm install -g openclaw@latest
openclaw onboard --install-daemon
pnpm 安装
pnpm add -g openclaw@latest
pnpm approve-builds -g # 批准构建脚本
openclaw onboard --install-daemon
安装方式三:源码安装
适合开发者或需要深度定制的朋友:
# 克隆项目
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖
pnpm install
pnpm ui:build
pnpm build
# 链接命令
pnpm link --global
# 启动引导
openclaw onboard --install-daemon
安装验证
安装完成后,运行以下命令验证:
openclaw doctor # 检查配置问题
openclaw status # 查看网关状态
openclaw dashboard # 打开浏览器管理界面
快速入门
首次运行 openclaw 或 openclaw dashboard 会自动打开浏览器配置页面。
主要配置步骤:
- 选择要接入的 AI 提供商(如 OpenAI、Claude、Minimax 等)
- 配置 API Key
- 选择要接入的渠道(飞书、Telegram、Discord 等)
- 完成配置
常用命令
| 命令 | 说明 |
|---|---|
openclaw status |
查看服务状态 |
openclaw start |
启动服务 |
openclaw stop |
停止服务 |
openclaw restart |
重启服务 |
openclaw logs |
查看日志 |
openclaw configure |
重新配置 |
常见问题
1. openclaw 命令找不到
检查 Node.js 和 npm 是否正确安装:
node -v
npm -v
npm prefix -g
确保 npm 全局 bin 目录在 PATH 中。
2. Windows 下运行报错
建议使用 WSL2,或者在 PowerShell 中以管理员身份运行。
3. 如何更新版本
npm update -g openclaw@latest
总结
OpenClaw 部署非常简单,几分钟就能搭建完成。它提供了丰富的渠道接入能力,是个人或团队搭建 AI 助手的优秀选择。
如果大家在部署过程中遇到问题,欢迎在评论区留言讨论!
参考链接:
- 官方文档:https://docs.openclaw.ai
- GitHub:https://github.com/openclaw/openclaw
更多推荐

所有评论(0)