OpenClaw 本地部署超详细教程

手把手教你搭建属于自己的 AI 私人助手，小白也能轻松搞定！

---

很多人想拥有一个属于自己的 AI 助手，但不知道从哪开始。今天这篇教程，我会用最通俗的语言，带你一步步在自己电脑上部署 OpenClaw。不需要你懂编程，跟着做就行！

---

一、OpenClaw 是什么？

简单来说，OpenClaw 是一个开源的 AI 私人助手平台。它不像 ChatGPT 那样问完就走，而是能：

• 🤖 24小时在线 —— 像真正的助手一样持续运行，随时待命
• 💬 多平台聊天 —— 支持 Telegram、WhatsApp、Discord、Signal、微信等
• 🔧 会各种技能 —— 查天气、搜索网页、管理文件、定时提醒……能力可以无限扩展
• 🧠 有记忆 —— 记得你之前说过的话，越用越懂你
• 🔒 数据在你手里 —— 开源项目，所有数据跑在你自己的电脑上，不经过第三方

---

二、准备工作

在开始之前，你需要准备以下东西：

2.1 硬件要求

• 一台电脑（Windows / macOS / Linux 都行）
• 内存至少 2GB（推荐 4GB 以上）
• 硬盘至少 5GB 可用空间

2.2 软件要求

• Node.js（v22 或更高版本）—— 这是运行 OpenClaw 的基础环境
• 一个 AI 模型的 API Key —— 比如 OpenAI、小米 MiMo、或者任何兼容 OpenAI 接口的服务

---

三、安装 Node.js（最重要的一步）

Node.js 是 OpenClaw 运行的基础，必须先装好。

3.1 Windows 用户

最简单的方法：

• 打开浏览器，访问 https://nodejs.org
• 点击下载 LTS 版本（推荐版本）
• 双击安装包，一路"下一步"即可
• 安装完成后，按 Win + R，输入 cmd，回车
• 在黑色窗口中输入以下命令验证：

node --version

如果显示类似 v22.x.x 的版本号，说明安装成功！

3.2 macOS 用户

如果你已经安装了 Homebrew，打开终端输入：

brew install node@22

如果没有 Homebrew，先去 https://nodejs.org 下载 macOS 安装包，操作和 Windows 类似。

3.3 Linux 用户

推荐使用 nvm（Node 版本管理器），更灵活：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
node --version

---

四、安装 OpenClaw

Node.js 装好后，安装 OpenClaw 就非常简单了。

打开终端（Windows 用户打开 CMD 或 PowerShell），输入：

npm install -g openclaw

⏳ 等待安装完成（通常 1-2 分钟），然后验证：

openclaw --version

如果显示版本号，恭喜你，OpenClaw 已经安装成功了！

---

五、初始化配置

第一次运行，需要做初始化设置：

openclaw init

系统会引导你完成基本配置。你也可以之后手动编辑配置文件：

• 配置文件位置：~/.openclaw/openclaw.json
• 工作空间：~/.openclaw/workspace/

5.1 配置 AI 模型

你需要告诉 OpenClaw 使用哪个 AI 模型。在配置文件中添加你的 API Key：

• OpenAI —— 需要 OpenAI API Key
• 小米 MiMo —— 小米自研模型，中文能力强
• 其他兼容服务 —— 任何支持 OpenAI 接口格式的服务都可以

5.2 配置消息渠道（可选）

如果你想在手机上和 AI 助手聊天，可以配置以下渠道：

• 📱 Telegram —— 创建一个 Bot，填入 Token
• 📱 WhatsApp —— 扫码连接你的 WhatsApp
• 📱 Discord —— 创建 Discord Bot 应用
• 🌐 Webchat —— 内置网页聊天，无需额外配置

---

六、启动 OpenClaw

配置完成后，启动非常简单：

openclaw gateway start

启动后，OpenClaw 会在后台持续运行。你可以：

• 打开浏览器访问 http://localhost:18800 进入网页聊天界面
• 在配置好的消息平台上和 AI 助手对话

常用命令：

openclaw gateway status    # 查看运行状态
openclaw gateway stop      # 停止服务
openclaw gateway restart   # 重启服务

---

七、常见问题

Q1：npm install 报错怎么办？

可能是网络问题，试试换源：

npm config set registry https://registry.npmmirror.com

Q2：Windows 上提示权限不足？

右键点击"命令提示符"，选择"以管理员身份运行"，再执行命令。

Q3：如何让 OpenClaw 开机自启动？

Linux 用户可以用 systemd 设置服务，macOS 可以用 launchd，Windows 可以用任务计划程序。具体方法请参考官方文档。

Q4：AI 模型怎么选？

如果是国内用户，推荐使用小米 MiMo，中文能力强，延迟低。如果需要更强的推理能力，可以选择 GPT-4o 或 Claude。

---

八、进阶玩法

部署完成后，你可以探索更多高级功能：

• 🎨 技能系统 —— 安装各种技能插件，扩展 AI 能力
• ⏰ 定时任务 —— 让 AI 定时帮你做事情
• 🧠 记忆管理 —— AI 会记住你的偏好和习惯
• 💓 心跳机制 —— 让 AI 主动检查邮件、日历等

📖 更多详细文档请访问：https://docs.openclaw.ai

💬 社区交流：https://discord.com/invite/clawd

---

🎉 恭喜你完成部署！现在你拥有了一个 24 小时在线的 AI 私人助手！

如果觉得有用，欢迎分享给朋友～ 🚀