OpenClaw 本地安装完全指南

OpenClaw 是一个功能强大的开源 AI 助手框架，支持自定义技能、插件扩展和多平台集成。无论你是想体验 AI 助手，还是想参与开发，这篇教程都能帮你从零搭建好环境。

什么是 OpenClaw？

简单来说，OpenClaw 是一个可编程的 AI 助手。你可以把它理解成一个"超级工具箱"，它能：

• 📝 帮你写作 — 写文章、润色文案、制作 PPT
• 💻 帮你编程 — 写代码、调试程序、解释代码
• 🔍 帮你搜索 — 查资料、整理信息、回答问题
• 🔧 定制技能 — 安装各种插件，扩展能力

更重要的是，它是开源免费的，任何人都可以免费使用和参与开发。

环境要求

在开始之前，确认你的电脑满足以下条件：

第一步：安装 Node.js 开发环境

OpenClaw 基于 Node.js 开发，我们需要先安装 Node.js 环境。

1.1 安装 nvm（Node 版本管理器）

nvm 可以让你轻松切换不同版本的 Node.js，非常适合开发者。

📖 详细教程：可以参考这篇文章 → CSDN: 安装nvm、node、npm

1.2 安装 Node.js

# 安装 Node.js 22.12.0
nvm install 22.12.0

# 使用这个版本
nvm use 22.12.0

1.3 验证安装成功

打开终端（PowerShell 或 CMD），运行：

node --version
# 应该显示：v22.12.0

npm --version
# 应该显示：10.9.0

第二步：安装 pnpm

pnpm 是 OpenClaw 使用的包管理器，它比 npm 更快、更省空间。

💡 什么是 pnpm？ 就像"快递员"，帮你高效地管理项目需要的各种"包裹"（依赖包）。

# 全局安装 pnpm
npm install -g pnpm

# 验证安装
pnpm --version
# 应该显示：9.12.0 或更高版本

第三步：下载源码

方式一：从 GitHub 下载（推荐）

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

# 进入项目目录
cd openclaw

方式二：直接下载压缩包

如果不方便使用 git，也可以直接下载压缩包：

1. 访问 GitHub Release 页面：https://github.com/openclaw/openclaw/releases
2. 下载最新版本（如 v2026.3.13-1）
3. 解压到本地
4. 在终端进入解压后的目录

💡 建议：如果你想长期使用或参与开发，推荐使用方式一（git clone），这样后续更新更方便。

第四步：安装依赖

这一步很重要！它会下载项目需要的所有"零件"：

pnpm install

执行后，你会看到进度条在跑，这是在下载各种依赖包。

⏳ 耐心等待：首次安装可能需要 5-15 分钟，取决于你的网速。喝杯咖啡休息一下吧！

第五步：构建项目

源码下载好了，现在需要"组装"成可运行的程序：

pnpm ui:build

看到以下输出就说明成功了：

✓ 185 modules transformed.
../dist/control-ui/index.html 0.69 kB
../dist/control-ui/assets/index-BO0NBOvK.js 657.22 kB
✓ built in 1.36s

第六步：初始化配置

构建完成后，需要进行一些初始设置：

首次引导配置

pnpm openclaw onboard

这个命令会引导你完成初始设置，包括：

• 创建工作目录（你的"主场"）
• 配置 AI 模型（选哪个"大脑"）
• 设置语言和偏好

安装 Gateway 服务

Gateway 是 OpenClaw 的核心服务，负责处理各种任务：

# 以管理员身份运行
pnpm openclaw gateway install

打开配置界面

如果需要调整设置，可以随时打开配置界面：

pnpm openclaw configure

第七步：启动 OpenClaw

所有准备都完成了！现在启动它：

pnpm openclaw gateway start

启动成功后，在浏览器打开 http://localhost:8080 就能看到 OpenClaw 的控制台了。

🎉 恭喜你！ 安装完成，现在可以开始使用了！

额外配置：飞书机器人（可选）

如果你想用飞书来和 OpenClaw 交互，需要配置飞书机器人：

📖 详细教程：可以参考这篇文章 → 腾讯云开发者社区：飞书机器人配置

这个是可选步骤，如果你不需要飞书集成，可以跳过。

常见问题速查

❓ 安装失败了怎么办？

1. 检查网络 — 确保电脑能访问 GitHub
2. 清理重试 — 删除 node_modules 文件夹和 pnpm-lock.yaml，重新执行 pnpm install
3. 查看错误信息 — 仔细阅读终端输出的红色错误提示

❓ 构建卡住了？

# 清理缓存，重新开始
pnpm clean
pnpm ui:build

❓ 端口被占用？

8080 端口被其他程序占用了？可以在配置中改端口，或者先关掉占用端口的程序。

接下来做什么？

安装成功后，你可以：

1. 体验一下 — 在控制台和 AI 助手聊聊天
2. 安装技能 — 试试安装一些有用的插件
3. 阅读文档 — 访问 OpenClaw 官方文档了解更多
4. 参与开发 — 如果你想贡献代码，可以查看 GitHub 上的 CONTRIBUTING.md

总结

安装 OpenClaw 只需要 7 个步骤：

1. 安装 Node.js (22.12.0) — 参考 CSDN 教程
2. 安装 pnpm
3. 下载源码（git clone 或下载压缩包）
4. 执行 pnpm install
5. 执行 pnpm ui:build
6. 运行 pnpm openclaw onboard
7. 启动 pnpm openclaw gateway start

按照这个顺序来，你一定能成功！如果遇到问题，随时可以查看官方文档或提问。

祝你在 OpenClaw 的世界里玩得开心！🚀