返回教程列表

OpenClaw 完全入门指南

从零开始，手把手教你安装和运行 OpenClaw，无需编程基础

入门30 分钟
入门安装环境配置服务器

OpenClaw 完全入门指南

🎯 目标: 即使你完全没有编程经验，也能跟着本教程在 30 分钟内让 OpenClaw 运行起来。

本教程适合谁？

  • ✅ 从来没写过代码的小白用户
  • ✅ 想要一个 AI 助手帮你自动回复消息
  • ✅ 想在微信/Telegram/飞书里用 AI
  • ✅ 担心隐私，不想把数据传给第三方

📖 学习路径

本教程是 OpenClaw 入门的第一步。完成后，建议继续学习：

  1. 安装详解 - 深入了解各种安装方式和故障排除
  2. 配置指南 - 详细配置 AI 模型和平台连接
  3. 费用说明 - 了解 OpenClaw 的使用成本

开始之前：选择你的部署方式

OpenClaw 有两种主要部署方式，根据你的需求选择：

| 方式 | 优点 | 缺点 | 适合人群 | |------|------|------|----------| | 本地部署 | 免费、数据在本地、完全控制 | 电脑需要一直开机 | 有电脑、偶尔使用 | | 云服务器 | 24小时在线、随时随地使用 | 需要付费（约 50-100 元/年） | 需要全天候服务 |

方式一：本地部署（Mac/Windows）

系统要求

在开始之前，请确认你的电脑满足以下要求：

| 配置项 | 最低要求 | 推荐配置 | |--------|----------|----------| | 操作系统 | macOS 12+ / Windows 10+ | macOS 14+ / Windows 11 | | 内存 | 4GB | 8GB 或以上 | | 磁盘空间 | 10GB | 20GB 以上 |

⚠️ Windows 用户注意: Windows 必须使用 WSL2（Linux 子系统），不支持直接在 Windows 上运行。

第一步：安装 Node.js

⏱️ 预计时间: 5-10 分钟

Node.js 是 OpenClaw 运行的基础环境，就像汽车需要汽油一样。

为什么需要 Node.js v22+？

OpenClaw 使用了一些最新的 JavaScript 特性，这些特性只在 Node.js 22 及以上版本中支持：

  • 更好的性能和内存管理
  • 原生支持 TypeScript 转换
  • 更稳定的长连接处理

如果你的系统已有旧版本 Node.js，必须升级到 v22 或更高版本。

Mac 用户

  1. 打开终端（按 Command + 空格，输入 Terminal，回车）

  2. 检查是否已安装 Node.js：

    node --version
    • 如果显示 v22.x.x 或更高版本，跳到第二步
    • 如果显示版本低于 v22，或提示 command not found，继续下面的安装

  3. 安装 Homebrew（Mac 的软件包管理器）：

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

    按提示操作，可能需要输入电脑密码

  4. 安装 Node.js：

    brew install node@22

  5. 验证安装：

    node --version

    应该显示 v22.x.x

Windows 用户

Windows 用户需要先安装 WSL2（Windows Subsystem for Linux），这是官方要求。

  1. 启用 WSL2：

    • 右键点击开始菜单，选择「终端(管理员)」或「Windows PowerShell (管理员)」
    • 输入以下命令并回车：
    wsl --install
    • 等待安装完成后，重启电脑

  2. 设置 Ubuntu：

    • 重启后，会自动弹出 Ubuntu 窗口
    • 按提示设置用户名和密码（密码输入时不会显示，正常输入后回车即可）

  3. 在 Ubuntu 中安装 Node.js：

    # 安装 nvm（Node.js 版本管理器）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 重新加载配置
source ~/.bashrc

# 安装 Node.js 22
nvm install 22

# 验证
node --version

第二步：安装 OpenClaw

⏱️ 预计时间: 3-5 分钟

现在 Node.js 已经准备好了，接下来安装 OpenClaw 本体。

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

在终端（Mac）或 Ubuntu（Windows WSL2）中运行：

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

脚本会自动完成以下工作：

  • 检测系统环境
  • 安装缺失的依赖
  • 配置 OpenClaw
  • 启动引导向导

方法二：npm 安装

如果一键脚本遇到问题，可以手动安装：

# 安装 OpenClaw
npm install -g openclaw@latest

# 启动配置向导
openclaw onboard --install-daemon

常见安装问题

问题：openclaw: command not found

这是因为 npm 的全局目录不在系统 PATH 中。解决方法：

# 查找 npm 全局目录
npm prefix -g

# 添加到 PATH（Mac 用户）
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 添加到 PATH（Linux/WSL2 用户）
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

问题：Sharp 模块安装失败

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

第三步：配置 AI 模型

⏱️ 预计时间: 5 分钟

OpenClaw 本身不提供 AI 能力，需要连接到 AI 服务（如 Claude、ChatGPT 等）。

💡 提示: 想了解各模型的详细对比和费用？查看 费用说明

获取 API Key

你可以选择以下任一 AI 服务：

| 服务商 | 价格 | 特点 | 推荐指数 | |--------|------|------|----------| | Google Gemini | 免费额度 | 有免费额度，适合试用 | ⭐⭐⭐⭐⭐ | | DeepSeek | ¥1/百万token | 国产模型，价格低廉 | ⭐⭐⭐⭐⭐ | | Claude | $3/百万token | 智能程度高 | ⭐⭐⭐⭐ | | ChatGPT | $2.5/百万token | 生态完善 | ⭐⭐⭐⭐ | | Qwen 通义千问 | 免费额度 | 阿里云模型，国内友好 | ⭐⭐⭐⭐ | | Moonshot Kimi | 免费额度 | 长文本能力强 | ⭐⭐⭐⭐ | | 智谱 GLM | 免费额度 | 清华技术，性价比高 | ⭐⭐⭐⭐ | | Groq | 免费额度 | 极速响应 | ⭐⭐⭐⭐ |

💡 两种付费方式

OpenClaw 接入 AI 模型有两种付费方式：

| 方式 | 说明 | 适合人群 | |------|------|---------| | 按量付费 (API) | 按 token 消耗计费，用多少付多少 | 轻度用户、试用阶段 | | 订阅计划 (Code Plan) | 按月付费，固定费用无限使用 | 重度用户、成本可控 |

📖 详细费用对比请查看 费用说明

方式一：按量付费 (API Key)

适合轻度用户或试用阶段，按实际使用量付费。

🔹 Google Gemini（推荐新手，有免费额度）

  1. 访问 Google AI Studio
  2. 使用 Google 账号登录
  3. 点击「Create API Key」
  4. 复制生成的 API Key

📖 官方文档: Gemini API 快速入门

🔹 DeepSeek（国内用户首选，价格最低）

  1. 访问 DeepSeek 开放平台
  2. 注册账号并登录（支持手机号注册）
  3. 进入「API Keys」页面
  4. 点击「Create API Key」
  5. 复制生成的 API Key

📖 官方文档: DeepSeek API 文档

🔹 Qwen 通义千问（阿里云，有免费额度）

  1. 访问 阿里云百炼平台
  2. 使用阿里云账号登录
  3. 开通「模型服务灵积」
  4. 进入「API-KEY 管理」创建密钥

📖 官方文档: 通义千问 API 文档

🔹 Moonshot Kimi（长文本能力强，有免费额度）

  1. 访问 Moonshot 开放平台
  2. 注册账号并登录
  3. 进入「API Key 管理」
  4. 点击「创建新的 API Key」

📖 官方文档: Moonshot API 文档

🔹 智谱 GLM（清华技术，有免费额度）

  1. 访问 智谱开放平台
  2. 注册账号并登录
  3. 进入「API Keys」页面
  4. 点击「添加 API Key」

📖 官方文档: 智谱 GLM API 文档

🔹 Groq（极速响应，有免费额度）

  1. 访问 Groq Console
  2. 使用 Google/GitHub 账号登录
  3. 进入「API Keys」页面
  4. 点击「Create API Key」

📖 官方文档: Groq API 文档

🔹 Claude（智能程度高）

  1. 访问 Anthropic Console
  2. 注册账号并登录
  3. 进入「API Keys」页面
  4. 点击「Create Key」

📖 官方文档: Claude API 文档

🔹 ChatGPT / OpenAI（生态完善）

  1. 访问 OpenAI Platform
  2. 注册账号并登录
  3. 进入「API keys」页面
  4. 点击「Create new secret key」

📖 官方文档: OpenAI API 文档

方式二：订阅计划 (Code Plan)

适合重度用户，按月付费固定费用，避免按量付费的不确定性。

🔹 Claude Max / Anthropic 订阅

| 计划 | 月费 | 包含内容 | |------|------|---------| | Claude Pro | $20/月 | Claude.ai 网页版无限对话 | | Claude Max | $100-200/月 | API 额度 + 优先访问 |

📖 官方说明: Claude 订阅计划

🔹 ChatGPT Plus / Pro / Team

| 计划 | 月费 | 包含内容 | |------|------|---------| | ChatGPT Plus | $20/月 | GPT-4 无限对话 | | ChatGPT Pro | $200/月 | GPT-4 + o1 无限使用 | | ChatGPT Team | $25-30/月/人 | 团队协作 + 管理功能 |

📖 官方说明: ChatGPT 订阅计划

🔹 Google One AI Premium

| 计划 | 月费 | 包含内容 | |------|------|---------| | AI Premium | $19.99/月 | Gemini Advanced + 2TB 云存储 |

📖 官方说明: Google One AI Premium

🔹 Cursor Pro（AI 编程助手，支持 OpenClaw）

| 计划 | 月费 | 包含内容 | |------|------|---------| | Pro | $20/月 | 无限 AI 补全 + 快速模型 |

📖 官方说明: Cursor 定价

配置 API Key

运行配置向导：

openclaw onboard

按照提示选择 AI 服务商并输入 API Key。

💰 省钱小贴士

  1. 优先使用免费额度: Google Gemini、Qwen、Moonshot、智谱 GLM 都有免费额度
  2. 国内用户推荐: DeepSeek 价格最低（¥1/百万token）
  3. 重度用户推荐订阅: ChatGPT Plus/Claude Pro 按月固定费用更划算
  4. 需要速度: Groq 响应极快，适合实时对话场景
  5. 长文本处理: Moonshot Kimi 支持 20 万 token 上下文

📖 详细费用对比和推荐场景，请查看 费用说明

第四步：验证安装

⏱️ 预计时间: 2 分钟

运行健康检查：

openclaw doctor

健康检查结果解读

openclaw doctor 会检查以下项目：

| 检查项 | 含义 | 失败怎么办 | |--------|------|-----------| | ✅ Node.js Version | Node.js 版本是否 ≥22 | 重新安装 Node.js v22+ | | ✅ OpenClaw CLI | 命令行工具是否正常 | 重新运行安装命令 | | ✅ Config File | 配置文件是否存在 | 运行 openclaw onboard | | ✅ API Key | API 密钥是否有效 | 检查密钥是否正确配置 | | ✅ Network | 网络连接是否正常 | 检查网络或代理设置 |

如果所有检查项都显示 ✅，说明安装成功！

自动修复问题

如果有检查项失败，可以尝试自动修复：

openclaw doctor --fix

访问控制面板：

openclaw start

然后在浏览器打开 http://localhost:18789，你应该能看到 OpenClaw 的管理界面。

方式二：云服务器部署

⏱️ 预计时间: 15-20 分钟

如果你需要 OpenClaw 24 小时在线（比如运行 Telegram Bot），建议使用云服务器。

服务器配置要求

| 配置项 | 最低配置 | 推荐配置 | |--------|----------|----------| | CPU | 1 核 | 2 核 | | 内存 | 2GB | 4GB | | 存储 | 20GB SSD | 40GB SSD | | 系统 | Ubuntu 22.04 | Ubuntu 24.04 | | 带宽 | 1Mbps | 5Mbps+ |

💡 提示: 如果需要使用浏览器自动化功能，建议选择 4GB 内存的配置。

优惠服务器推荐

国内用户

| 服务商 | 配置 | 价格 | 特点 | 链接 | |--------|------|------|------|------| | 阿里云 | 2核2G | 99元/年 | OpenClaw 预装镜像 | 活动页 | | 腾讯云 | 2核2G | 99元/年 | 老用户续费优惠 | 活动页 | | 华为云 | 2核4G | ~100元/年 | 企业用户友好 | 活动页 |

阿里云 OpenClaw 一键部署（最简单）：

  1. 访问阿里云轻量应用服务器
  2. 选择「应用镜像」→「OpenClaw」
  3. 配置选择 2核2G 或以上
  4. 点击购买，等待 3-5 分钟自动部署完成

海外用户

| 服务商 | 配置 | 价格 | 特点 | 链接 | |--------|------|------|------|------| | Vultr | 1核1G | $2.5/月 | 新用户送 $100 | 注册链接 | | DigitalOcean | 1核1G | $4/月 | 稳定性好 | 官网 | | BandwagonHost | 1核1G | $49.99/年 | CN2 线路 | 官网 |

服务器部署步骤

1. 连接服务器

ssh root@你的服务器IP

2. 安装 Docker

curl -fsSL https://get.docker.com | sh

3. 部署 OpenClaw

# 克隆项目
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 运行部署脚本
./docker-setup.sh

4. 安全配置（重要！）

在云服务器上运行 OpenClaw，必须设置用户白名单：

# 编辑 ~/.openclaw/config.yaml
channels:
  telegram:
    allowed_users:
      - "你的Telegram用户ID"

⚠️ 安全警告: 不设置白名单，任何人都可以通过你的 Bot 使用你的 API 额度！

🎉 恭喜！

你已成功安装 OpenClaw！接下来可以：

  1. 配置 AI 模型 - 了解更多模型选择和配置选项
  2. 连接 Telegram - 最简单的消息平台接入
  3. 连接飞书 - 适合国内用户
  4. 了解费用 - 计算 OpenClaw 的使用成本

常见问题 FAQ

Q: OpenClaw 收费吗？

A: OpenClaw 本身完全免费开源。但你需要为 AI 模型的 API 调用付费：

  • Google Gemini 有免费额度
  • DeepSeek 约 ¥1/百万 token
  • Claude/ChatGPT 约 $2-3/百万 token

📖 详细费用对比请查看 费用说明

Q: 4GB 内存够用吗？

A:

  • 够用：只用 AI 聊天功能，不使用浏览器自动化
  • 不够用：需要频繁使用浏览器功能，建议 8GB

Q: 为什么 Windows 必须用 WSL2？

A: OpenClaw 依赖很多 Linux 系统库，Windows 原生环境无法满足。WSL2 提供了完整的 Linux 环境，能保证最好的兼容性。

Q: 安装失败怎么办？

A: 常见原因和解决方法：

| 错误信息 | 原因 | 解决方法 | |---------|------|---------| | EACCES permission denied | 权限不足 | 使用 sudo npm install -g openclaw | | network timeout | 网络问题 | 切换 npm 镜源或使用代理 | | sharp module not found | 依赖缺失 | 运行 SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest | | node-gyp rebuild failed | 编译工具缺失 | Mac: xcode-select --install，Linux: sudo apt install build-essential |

Q: 如何卸载或重新安装？

A:

# 卸载 OpenClaw
npm uninstall -g openclaw

# 清理配置文件（可选）
rm -rf ~/.openclaw

# 重新安装
npm install -g openclaw@latest

Q: 如何更新到最新版本？

A:

# 查看当前版本
openclaw --version

# 更新到最新版
npm update -g openclaw

# 验证更新
openclaw --version

Q: 支持哪些 AI 模型？

A: OpenClaw 支持所有主流 AI 模型：

  • Claude (Anthropic) - 推荐用于复杂任务
  • ChatGPT (OpenAI) - 生态完善
  • DeepSeek - 国产模型，价格低廉
  • Google Gemini - 有免费额度
  • Qwen (通义千问) - 阿里云模型
  • 其他 - 兼容 OpenAI API 格式的模型

Q: 遇到问题怎么办？

A:

  1. 运行 openclaw doctor --fix 自动修复常见问题
  2. 查看 GitHub Issues
  3. 在我们的社区寻求帮助

最后更新: 2026-03-10