OpenClaw 部署完全指南：打造你的 24/7 AI 私人助手

什么是 OpenClaw？

OpenClaw 是一个开源的 AI 私人助手，可以在你自己的设备上运行，并通过 WhatsApp、Telegram、Discord、Slack 等消息平台与你交互。它最初叫 Clawdbot，因商标问题改名为 Moltbot，最终定名为 OpenClaw。

截至目前，OpenClaw 在 GitHub 上已经获得了 145,000+ Stars 和 20,000+ Forks，是 2026 年最受关注的 AI 开源项目之一。

为什么选择 OpenClaw？

• 隐私优先：数据存储在你自己的设备上
• 多平台支持：WhatsApp、Telegram、Discord、Slack、微信等
• 强大的 AI 能力：可连接 Claude 4.5、GPT-4o 或本地模型
• 安全沙箱：所有代码在 Docker 容器中执行
• 24/7 在线：部署后全天候响应

我部署 OpenClaw 的踩坑经历

我是在 GitHub 上刷 trending 的时候发现 OpenClaw 的，当时它已经有 10 万多 Stars 了。心想这么火的项目，一定要试试。

第一次部署的过程并不顺利。我在 Mac 上用 npm 安装后，运行 openclaw onboard 卡在了"配置消息平台"这一步——因为 WhatsApp 的扫码功能需要手机和电脑在同一个网络，而我当时用的是 VPN，网络环境有点复杂。折腾了半个小时后，关掉 VPN 切回直连才搞定。

第二个坑是 API Key 配置。我一开始用的是 OpenAI 的 Key，发现对中文的理解能力不够好。后来换成 Anthropic 的 Claude 4.5，效果立刻好了很多。所以如果你主要用中文，我强烈推荐用 Claude 作为后端模型。

部署成功后的体验是真的好——我现在每天早上醒来，直接在 WhatsApp 上给 OpenClaw 发消息："帮我看看今天的天气和日历安排"，它会自动查天气、读取我的 Google Calendar，然后返回一条格式化的日报。感觉像有了一个真正的私人助理。

---

系统要求

在开始之前，确保你的系统满足以下要求：

要求	说明
Node.js	>= 22
操作系统	macOS、Linux 或 Windows (WSL2)
内存	建议 4GB 以上
网络	稳定的互联网连接

Windows 用户注意：强烈建议使用 WSL2 (Ubuntu)，原生 Windows 支持有限。

---

第一步：安装 OpenClaw

方式一：一键安装（推荐）

Linux / macOS：

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

Windows PowerShell：

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

方式二：npm 全局安装

npm install -g openclaw@latest

或使用 pnpm：

pnpm add -g openclaw@latest

方式三：从源码构建

如果你想自定义或贡献代码：

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

# 进入目录
cd openclaw

# 安装依赖
pnpm install

# 构建 UI
pnpm ui:build

# 构建项目
pnpm build

---

第二步：初始化配置

安装完成后，运行 onboarding wizard 进行配置：

openclaw onboard --install-daemon

这个向导会引导你完成：

1. 选择网关模式

   • 本地网关（推荐个人使用）
   • 远程网关（适合服务器部署）

2. 配置 AI 模型

   • Anthropic API Key（推荐，使用 Claude 4.5）
   • OpenAI API Key
   • 或连接本地模型（如 Llama 4、Mixtral）

3. 设置消息平台（下一步详细说明）

4. 安装后台服务

   • macOS：launchd 服务
   • Linux：systemd 服务

---

第三步：连接消息平台

连接 WhatsApp

1. 运行登录命令：

openclaw channels login

2. 打开手机 WhatsApp → 设置 → 关联设备

3. 扫描终端中显示的二维码

4. 首次配对验证：

# 查看配对码
openclaw pairing list whatsapp

# 批准配对
openclaw pairing approve whatsapp <配对码>

连接 Telegram

1. 在 @BotFather 创建一个 Bot，获取 Token

2. 在配置向导中输入 Bot Token

3. 在 Telegram 中向你的 Bot 发送 /start

连接 Discord

1. 在 Discord Developer Portal 创建应用

2. 获取 Bot Token

3. 在配置向导中输入 Token

4. 邀请 Bot 到你的服务器

---

第四步：配置 AI 模型

使用 Anthropic Claude（推荐）

# 设置 API Key
claude setup-token

或在配置文件中手动设置：

# 编辑配置文件
nano ~/.openclaw/agents/<agentId>/agent/auth-profiles.json

使用本地模型（Ollama）

如果你想完全离线运行：

# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 下载模型
ollama pull llama4

# 在 OpenClaw 中配置使用本地模型
openclaw config set model ollama/llama4

---

第五步：验证安装

检查服务状态：

# 查看 OpenClaw 状态
openclaw status

# 查看网关状态
openclaw gateway status

# 健康检查
openclaw health

访问本地仪表板：

http://127.0.0.1:18789/

---

进阶：云端部署（24/7 在线）

如果你想让 OpenClaw 全天候在线，可以部署到云服务器。

方式一：DigitalOcean 一键部署

DigitalOcean 提供了预配置的 OpenClaw 镜像：

1. 访问 DigitalOcean 控制台
2. 选择 OpenClaw 1-Click Deploy
3. 选择配置（建议 $24/月起步）
4. 部署完成后 SSH 登录进行配置

方式二：手动 VPS 部署

在任意 VPS 上部署（以 Ubuntu 为例）：

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 安装 OpenClaw
npm install -g openclaw@latest

# 运行配置向导
openclaw onboard --install-daemon

# 配置防火墙
sudo ufw allow 18789/tcp

使用 Docker 部署

# 拉取镜像
docker pull openclaw/openclaw:latest

# 运行容器
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

---

安全注意事项

OpenClaw 让 AI 可以执行代码和访问系统，因此安全非常重要：

1. 使用 Docker 沙箱

   • 所有 AI 执行的代码都在容器内运行
   • 即使 AI "幻觉" 也不会影响宿主系统

2. 避免连接生产系统

   • 不要在 OpenClaw 中配置生产数据库凭证
   • 使用独立的测试环境

3. 定期更新

   npm update -g openclaw
   

4. 审查权限

   • 定期检查 OpenClaw 的权限配置
   • 只授予必要的访问权限

---

常用命令速查

命令	说明
openclaw status	查看服务状态
openclaw health	健康检查
openclaw channels login	登录消息平台
openclaw channels list	查看已连接平台
openclaw config set <key> <value>	设置配置项
openclaw logs	查看日志
openclaw restart	重启服务

---

常见问题

Q: 安装时提示 Node.js 版本过低？

确保安装 Node.js 22 或更高版本：

node --version  # 应该显示 v22.x.x

Q: WhatsApp 扫码后无法连接？

1. 确保手机和电脑在同一网络
2. 检查防火墙是否阻止了端口
3. 尝试重新运行 openclaw channels login

Q: 如何切换 AI 模型？

openclaw config set model anthropic/claude-4.5
# 或
openclaw config set model openai/gpt-4o

---

总结

通过本教程，你已经学会了：

1. ✅ 在本地安装 OpenClaw
2. ✅ 配置 AI 模型（Claude/GPT/本地模型）
3. ✅ 连接消息平台（WhatsApp/Telegram/Discord）
4. ✅ 部署到云端实现 24/7 在线
5. ✅ 安全最佳实践

OpenClaw 是一个非常强大的工具，但请记住：能力越大，责任越大。在享受 AI 助手带来便利的同时，也要注意数据安全和隐私保护。

---

相关资源

• OpenClaw 官方文档
• OpenClaw GitHub 仓库
• DigitalOcean 部署指南
• Claude Code 完全指南
• Manus 与 2026 AI Agent 趋势
• n8n 自动化工作流教程
• 普通人的 AI 学习指南