OpenClaw 保姆级安装教程（小白必看）

发表于 更新于 分类于 阅读次数： 本文字数： 3k 阅读时长 ≈ 3 分钟
从零开始，手把手教你安装配置 OpenClaw AI 助手，支持 Windows/macOS/Linux 全平台，包含常见问题解决方案

cover

什么是 OpenClaw？

上周有朋友问我，有没有办法让 AI 直接在飞书里帮他处理日程、发消息、查文档，不用每次都开浏览器切标签页。我把 OpenClaw 的 GitHub 链接发给他，他当天就装好了。

OpenClaw（原名 ClawdBot/Moltbot）是一个开源的 AI 智能助手框架，核心思路是把 AI 接进你已经在用的聊天工具里——WhatsApp、Telegram、Discord、飞书都支持——然后让 AI 帮你在这些平台上直接执行任务，不用再开第三个窗口。

几个关键点：

  • 多平台：微信、飞书、Telegram、WhatsApp、Discord 等
  • 多模型：Claude、GPT、DeepSeek、Qwen、智谱 AI 等，自己选
  • 技能系统：PDF 编辑、浏览器控制、日程管理、文档处理等可按需安装
  • 完全自托管：数据不经过第三方服务器

系统要求

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

  • Node.js：v22 或更高版本
  • 操作系统：
    • macOS（推荐）
    • Linux
    • Windows（需要通过 WSL2）
  • 网络：能够访问 npm 仓库

检查 Node.js 版本

打开终端（Windows 用户打开 PowerShell），输入：

1
node -v

如果版本低于 v22，需要先升级 Node.js。推荐使用 nvm 来管理 Node.js 版本。

安装方法

OpenClaw 提供了多种安装方式，这里介绍最常用的三种。

方法一：一键安装脚本（推荐）⭐

这是最简单快捷的方式，适合所有用户。

macOS / Linux / WSL2 用户：

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

Windows 用户（PowerShell）：

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

安装脚本会自动完成以下操作：

  1. 下载 OpenClaw CLI
  2. 通过 npm 全局安装
  3. 启动配置向导

方法二：npm 全局安装

如果你已经安装了 Node.js v22+，可以直接使用 npm 安装：

1
npm install -g openclaw@latest

macOS 用户注意：如果遇到 sharp 模块错误，使用以下命令：

1
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

安装完成后，运行配置向导：

1
openclaw onboard --install-daemon

方法三：从源码安装（开发者）

适合需要修改代码或参与贡献的开发者：

1
2
3
4
5
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

初始化配置

安装完成后，需要运行配置向导来设置 OpenClaw：

1
openclaw onboard --install-daemon

配置向导会引导你完成以下步骤：

1. 选择 AI 模型供应商

OpenClaw 支持多种 AI 模型，包括：

  • 国外模型：Claude（Anthropic）、GPT（OpenAI）、Gemini（Google）
  • 国内模型：通义千问（Qwen）、智谱 AI、MiniMax、DeepSeek

根据你的需求选择一个供应商，并输入对应的 API Key。

2. 配置聊天渠道

选择你想要使用的聊天平台：

  • Telegram（推荐，配置简单）
  • WhatsApp
  • Discord
  • 飞书（国内用户推荐）
  • 企业微信
  • 钉钉

每个平台都需要创建对应的 Bot 并获取 Token。

3. 安装技能插件

OpenClaw 通过技能系统扩展功能，常用技能包括：

  • 文档处理
  • 浏览器控制
  • 日程管理
  • PDF 编辑
  • 代码执行

可以根据需要选择安装。

4. 启动 Gateway 服务

Gateway 是 OpenClaw 的核心服务，负责连接 AI 模型和聊天平台：

1
2
openclaw gateway install    # 安装为系统服务
openclaw gateway start      # 启动服务

常见问题解决

问题 1：找不到 openclaw 命令

错误提示：openclaw: command not found

解决方案：

  1. 查找 npm 全局安装路径：

    1
    npm prefix -g

  2. 将路径添加到环境变量（以 macOS/Linux 为例）：

    1
    2
    echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
    source ~/.zshrc

Windows 用户需要手动添加到系统环境变量 PATH 中。

问题 2：安装过程中网络超时

解决方案：

使用国内 npm 镜像：

1
2
npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

问题 3：Node.js 版本过低

解决方案：

使用 nvm 升级 Node.js：

1
2
3
4
5
6
# 安装 nvm（如果还没安装）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 安装 Node.js 22
nvm install 22
nvm use 22

问题 4：Windows 用户安装失败

解决方案：

Windows 用户强烈建议使用 WSL2（Windows Subsystem for Linux）：

  1. 启用 WSL2：

    1
    wsl --install

  2. 重启电脑

  3. 在 WSL2 中运行 Linux 安装命令：

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

实用命令清单

安装完成后，这些命令会让你的使用更加顺畅：

命令 功能
openclaw doctor 系统健康检查
openclaw status 查看 Gateway 服务状态
openclaw dashboard 打开 Web 管理界面
openclaw tui 打开终端交互界面
openclaw models status 查看已配置的 AI 模型
openclaw channels list 查看聊天渠道列表
openclaw memory search 搜索助手的记忆
openclaw gateway restart 重启 Gateway 服务
openclaw plugins list 查看已安装的插件

验证安装

安装完成后，运行以下命令验证：

1
2
3
4
5
6
7
8
# 检查配置
openclaw doctor

# 查看服务状态
openclaw status

# 打开管理界面
openclaw dashboard

如果一切正常，你应该能看到 Gateway 服务正在运行，并且可以通过 Web 界面或配置的聊天平台与 OpenClaw 对话了。

下一步

安装完成后，你可以：

  1. 配置更多 AI 模型：在 ~/.openclaw/agents/<agentId>/agent/auth-profiles.json 中添加
  2. 安装更多技能插件：使用 openclaw plugins install <plugin-url>
  3. 接入更多聊天平台：运行 openclaw channels add
  4. 自定义工作流：通过 Skills 系统创建自动化任务

总结

装完 OpenClaw 之后，我朋友第一件事是让它帮他在飞书里设置了每日早报推送，第二件事是把 PDF 合同处理接进去了。他说最大的感受是”终于不用在 N 个 AI 工具之间来回切了”。

如果你在安装过程中遇到问题，先跑 openclaw doctor，它会告诉你哪里出了问题。实在解决不了，去 OpenClaw 官方文档 或 GitHub Issues 找答案。