OpenClaw 安装教程 - 从零开始搭建你的 AI 助手

📅 更新时间：2026 年 3 月
🎯 适合人群：想要拥有个性化 AI 助手的开发者和技术爱好者

---

什么是 OpenClaw？

OpenClaw 是一个开源的 AI 助手框架，让你能够：

• 🤖 拥有自己的 AI 助手 - 不是租用，是真正拥有
• 📱 多平台连接 - 支持 WhatsApp、Telegram、Discord、微信等
• 🧠 持久记忆 - 助手会记住你们之间的对话和重要信息
• 🔌 技能扩展 - 可以安装各种技能来扩展功能
• 🏠 本地部署 - 数据掌握在自己手中

简单说，OpenClaw 让你能够部署一个有记忆、有个性、能连接多个聊天平台的 AI 助手。

---

系统要求

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

项目	要求
操作系统	macOS / Linux / Windows (WSL2)
Node.js	v18.0 或更高版本
npm	v8.0 或更高版本
内存	建议 2GB 以上可用内存
磁盘空间	至少 500MB 可用空间

---

安装步骤

第一步：安装 Node.js

如果你还没有安装 Node.js，请先安装：

macOS (使用 Homebrew):

brew install node

Linux (Ubuntu/Debian):

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Windows:
访问 Node.js 官网 下载安装包

验证安装:

node --version
npm --version

第二步：安装 OpenClaw

使用 npm 全局安装 OpenClaw：

npm install -g openclaw

安装完成后，验证是否成功：

openclaw --version

如果看到版本号输出，说明安装成功！🎉

第三步：初始化工作空间

选择一个目录作为你的 OpenClaw 工作空间：

# 创建工作目录
mkdir -p ~/openclaw-workspace
cd ~/openclaw-workspace

# 初始化 OpenClaw
openclaw init

初始化过程中，OpenClaw 会创建以下文件结构：

~/openclaw-workspace/
├── AGENTS.md          # 助手的行为指南
├── SOUL.md           # 助手的个性定义
├── USER.md           # 关于你的信息
├── IDENTITY.md       # 助手的身份
├── MEMORY.md         # 长期记忆
├── TOOLS.md          # 工具配置
├── HEARTBEAT.md      # 定期检查任务
└── memory/           # 日常记忆目录
    └── YYYY-MM-DD.md

第四步：配置 API Key

OpenClaw 需要连接大模型服务。常用的配置方式：

使用阿里云 DashScope (通义千问):

openclaw configure --section models

然后按照提示输入你的 API Key。

或者手动配置环境变量:

export DASHSCOPE_API_KEY="your-api-key-here"

💡 提示：你可以在 阿里云 DashScope 官网 获取 API Key

第五步：启动 Gateway

Gateway 是 OpenClaw 的核心服务：

# 启动 Gateway
openclaw gateway start

# 查看状态
openclaw gateway status

看到 “running” 状态说明启动成功！

第六步：连接聊天平台（可选）

OpenClaw 支持连接多个聊天平台：

连接 Telegram:

openclaw configure --section telegram

然后按照提示输入 Bot Token（通过 @BotFather 创建）

连接 WhatsApp:

openclaw configure --section whatsapp

会显示二维码，用手机扫描即可连接

使用 Web 界面:
直接访问 Gateway 提供的 Web 界面进行聊天

---

验证安装

完成所有步骤后，运行以下命令验证：

# 检查 Gateway 状态
openclaw gateway status

# 查看已配置的服务
openclaw status

# 查看可用技能
openclaw skills list

如果所有命令都正常执行，恭喜！你的 OpenClaw 已经安装完成！🎊

---

常见问题

Q1: npm 安装时权限错误

解决方法:

# macOS/Linux
sudo npm install -g openclaw --unsafe-perm

# 或者修改 npm 默认目录
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

Q2: Gateway 启动失败

检查日志:

openclaw gateway logs

常见原因:

• 端口被占用（默认端口可配置）
• API Key 配置错误
• Node.js 版本过低

Q3: 找不到 openclaw 命令

解决方法:

# 检查 npm 全局 bin 目录
npm bin -g

# 将该目录添加到 PATH
export PATH=$(npm bin -g):$PATH

Q4: 内存不足

OpenClaw 运行时建议至少 2GB 可用内存。如果内存紧张：

• 关闭不必要的应用
• 考虑增加系统 swap 空间
• 使用更轻量级的模型配置

---

下一步

安装完成后，你可以：

1. 📖 阅读 SOUL.md 和 AGENTS.md 了解如何定制助手个性
2. 🔧 安装技能：openclaw skills install <skill-name>
3. 📱 连接更多聊天平台
4. 🧪 开始和你的 AI 助手对话！

---

资源链接

• 📚 官方文档：https://docs.openclaw.ai
• 💬 社区 Discord：https://discord.com/invite/clawd
• 🐙 GitHub 源码：https://github.com/openclaw/openclaw
• 🔌 技能市场：https://clawhub.com

---

有问题？ 欢迎在评论区留言讨论！如果觉得有帮助，请点赞收藏支持一下～ 👍