OpenClaw 安装教程：从 0 到 1 搭建你的 AI Agent
🎯 前置准备
在开始安装之前，请确保你的系统满足以下要求：
- ✅ Node.js 18+（推荐 v20+）
- ✅ Git 已安装
- ✅ 终端/命令行工具（Windows 推荐 PowerShell 或 CMD）
- ✅ 代码编辑器（VS Code 推荐）
📦 第一步：安装 Node.js
Windows 用户
# 1. 下载 Node.js
访问 https://nodejs.org 下载 LTS 版本
# 2. 运行安装程序
node-v20.x.x-x64.msi
# 3. 验证安装
node --version
npm --versionmacOS 用户
# 使用 Homebrew 安装
brew install node@20
# 验证安装
node --version
npm --versionLinux 用户
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# 或使用 nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20🔧 第二步：克隆 OpenClaw 代码
# 1. 选择安装目录
cd /path/to/your/workspace
# 2. 克隆仓库
git clone https://github.com/openclaw/openclaw.git
# 3. 进入项目目录
cd openclaw⚙️ 第三步：安装依赖
# 安装核心依赖
npm install
# 安装可选依赖（根据需求）
npm install -g openclaw-cli
# 验证安装
openclaw --version📝 第四步：配置环境变量
创建 .env 文件在项目根目录：
# .env 文件内容
OPENCLAW_API_KEY=your_api_key_here
OPENCLAW_MODEL=default
OPENCLAW_WORKSPACE=/path/to/workspace
# 可选配置
OPENCLAW_DEBUG=true
OPENCLAW_LOG_LEVEL=info🪄 第五步：代码咒语（关键！）
以下是 OpenClaw 的核心"咒语"，帮助你快速上手：
咒语 1：初始化项目
openclaw init my-project
cd my-project
openclaw bootstrap咒语 2：创建第一个 Agent
openclaw agent create assistant
openclaw agent edit assistant咒语 3：运行 Agent
# 开发模式
openclaw run --watch
# 生产模式
openclaw build
openclaw start咒语 4：调试技巧
# 查看详细日志
openclaw run --verbose
# 单步调试
openclaw debug --step
# 查看状态
openclaw status🐛 常见问题
问题 1：npm install 失败
# 清理缓存
npm cache clean --force
# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com
# 重新安装
npm install问题 2：权限错误
# macOS/Linux
sudo chown -R $(whoami) ~/.npm
# Windows（管理员运行）
npm install --unsafe-perm=true问题 3：端口被占用
# 查看占用端口的进程
lsof -i :18789
# 杀死进程
kill -9
# 或修改配置使用其他端口 ✅ 验证安装
# 运行健康检查
openclaw doctor
# 应该看到类似输出：
✓ Node.js version: v20.x.x
✓ npm version: 10.x.x
✓ Workspace directory: OK
✓ Configuration: OK
✓ Connection: OK🎓 下一步
- 阅读 快速入门指南
- 查看 Agent 开发文档
- 加入 社区 Discord
- 参考 示例项目
📚 参考资料
- OpenClaw 官方文档：https://docs.openclaw.ai
- GitHub 仓库：https://github.com/openclaw/openclaw
- 社区论坛：https://discord.gg/clawd
祝你安装顺利！遇到问题欢迎留言交流。
📅 更新时间：2025 年 3 月 1 日 | 作者：技术团队