OPENCLAW

安装教程

保姆级图文指南|零基础小白也能搞定
Windows 10/11 macOS 11+ Node.js 22+ 5分钟搞定

📌 什么是 OpenClaw?

OpenClaw 是一款AI Agent 运行平台,让你的 AI 助手真正帮你做事:

💻
写代码、改 Bug
📝
生成文档、PPT、网页
📊
数据分析、可视化
🔄
自动化工作流

📋 安装前准备

软件 版本要求 下载地址
Node.js ≥ 22.0.0 nodejs.org
npm 随 Node.js 安装 -
Git 最新版 git-scm.com
1

安装 Node.js Windows

访问 Node.js 官网,下载 LTS 版本(长期支持版),双击安装,全部默认下一步即可。

# 验证安装(打开 PowerShell 输入)
node --version
# 输出示例:v22.12.0
2

安装 Git Windows

访问 Git 官网下载,双击安装,全部默认下一步即可。

git --version
# 输出示例:git version 2.43.0
3

配置 Git(重要!)

这一步很关键,避免安装失败!
# 配置 Git 使用 HTTPS
git config --global url."https://github.com/".insteadOf ssh://git@github.com/
git config --global url."https://github.com/".insteadOf git@github.com:

# 配置 GitHub 镜像加速
git config --global url."https://ghproxy.com/https://github.com/".insteadOf https://github.com/
4

安装 OpenClaw

# 清理缓存
npm cache clean --force

# 安装 OpenClaw
npm install -g openclaw@latest

# 验证安装
openclaw --version
# 输出示例:2026.2.25
5

初始化配置

# 运行配置向导
openclaw onboard

# 按提示操作:
# 1. 选择 AI 模型提供商
# 2. 输入 API Key
# 3. 选择默认模型
# 4. 配置完成!
6

启动服务

# 启动 Gateway 服务
openclaw gateway

# 看到 "Gateway running" 就成功了!
浏览器访问:http://localhost:18789 即可使用!

🍎 macOS 用户专属

Mac 用户推荐使用 Homebrew 安装:

# 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node@22

# 后续步骤与 Windows 相同
Mac 通常自带 Git,输入 git --version 检查即可

❓ 常见问题

安装失败,提示 Git 错误?
执行步骤3的 Git 配置命令,然后重试安装。
安装很慢或卡住?
使用 VPN/代理,或配置淘宝镜像:
npm config set registry https://registry.npmmirror.com
提示权限不足?
Windows:以管理员身份运行 PowerShell
Mac:使用 sudo 提权
找不到命令?
重启终端,检查 npm 全局路径是否在 PATH 中

🔗 官方资源

🎉

安装完成!

现在你可以开始使用 OpenClaw 了
定时任务 多渠道沟通 记忆系统 Skills 扩展