OpenClaw安装教程：5分钟快速上手这款AI数字员工

你有没有想过，有一天你的电脑可以像员工一样自动完成各种任务——整理文件、生成报告、监控网站、甚至帮你写代码？OpenClaw 正在把这件事变成现实。

一、OpenClaw是什么？

OpenClaw是一个开源、本地部署的AI Agent网关。它的核心思路不是"只回答问题"，而是让AI真正具备执行动作的能力——访问网页、运行命令、调度任务、连接聊天渠道、管理会话。

用一个通俗的比喻：传统AI像一位顾问，你问它答；而OpenClaw更像一个数字员工，你告诉它目标，它自己想办法完成。

OpenClaw的核心能力

•自动化执行：不只是聊天，能真正操作电脑、执行多步骤任务

•跨平台通信：接入飞书、钉钉、QQ、Telegram，随时随地唤醒AI

•Skills插件生态：1800+技能扩展，浏览器控制、PDF编辑、代码执行等

•7×24小时运行：作为后台服务持续工作，无需人工干预

•本地隐私保护：所有数据留在自己设备上，更安全可控

截至2026年3月，OpenClaw已在GitHub上积累了数十万星标，成为AI Agent领域最热门的开源项目之一。

二、安装前的环境准备

OpenClaw的安装并不复杂，但在动手之前需要确保环境达标。这步没做好，后面会遇到各种报错。

硬件和系统要求

                                                                                                                           

配置项	最低要求	推荐配置
操作系统	macOS 12+ / Windows 10+ / Ubuntu 20.04+	macOS 14+ / Windows 11
内存	4GB	8GB以上
磁盘	10GB可用空间	20GB以上
网络	能访问openclaw.ai	稳定的互联网连接

核心依赖：Node.js 22+

OpenClaw基于Node.js运行，必须安装Node.js 22.0.0及以上版本。建议通过nvm（Node Version Manager）来管理Node版本，好处是可以随时切换不同版本，不影响其他项目。

macOS / Linux 安装nvm和Node.js

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

# 重新加载shell配置
source ~/.zshrc  # 如果你使用zsh
# 或
source ~/.bashrc  # 如果你使用bash

# 安装Node.js 22（国内加速）
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
nvm install 22
nvm use 22
nvm alias default 22

# 验证安装
node -v  # 应显示 v22.x.x
npm -v   # 应显示 10.x.x

Windows 安装Node.js

Windows用户推荐使用 nvm-windows：

1.前往 GitHub 下载 nvm-setup.exe

2.双击运行安装（和普通软件一样）

3.打开管理员模式的PowerShell，执行：

nvm install 22.22.0
nvm use 22.22.0
node -v

💡 国内用户注意：由于网络访问海外npm源经常超时，建议配置国内镜像： ``bash npm config set registry https://registry.npmmirror.com ``

三、三种系统的安装步骤

环境准备好后，正式安装OpenClaw就很快了。根据不同系统，安装方式略有差异。

3.1 macOS 安装

# 方式一：直接安装（推荐）
npm install -g openclaw

# 方式二：使用Homebrew
brew install openclaw

# 验证安装
openclaw --version

3.2 Windows 安装

在 管理员模式的PowerShell 中执行：

# 设置执行策略（首次安装需要）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 安装OpenClaw
iwr -useb https://openclaw.ai/install.ps1 | iex

如果遇到「不知道安装在哪里」的报错，执行以下命令定位：

ls C:\nodejs\node\_global\openclaw\*
# 然后手动将路径添加到系统环境变量

3.3 Linux 安装

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

3.4 云端一键部署（适合不想折腾的用户）

如果本地安装总是遇到网络问题，或者想省心，可以选择云端部署：

•腾讯云轻量应用服务器：20元/月，带宽20M，2C2G配置，官方有一键镜像

•阿里云：相近价格，提供官方一键部署方案

•火山引擎：9.9元/月，适合飞书生态用户

云端部署的优势是服务器常年在线，OpenClaw可以7×24小时为你工作，手机发消息就能驱动它执行任务。

四、初始化配置（onboard向导）

安装完成后，运行初始化向导来配置AI模型和聊天渠道：

openclaw onboard

这个向导会引导你完成以下配置：

4.1 配置AI模型

OpenClaw支持多种AI模型接入方式：

•OpenAI API：直接填入API Key，适合有账号的用户

•Claude API：通过Anthropic官方或中转API接入

•国内模型：支持Kimi、DeepSeek等，可通过OpenAI兼容接口接入

💡 省钱技巧：可以注册NVIDIA Build平台获取免费GPU算力，使用Kimi等模型的免费额度；也可以使用各平台的中转API，价格比官方更低。

4.2 配置示例（以NVIDIA免费Kimi为例）

在配置文件中添加模型信息：

"models": {
  "providers": {
    "nvidia": {
      "baseUrl": "https://integrate.api.nvidia.com/v1",
      "apiKey": "nvapi-你的Key"
    }
  }
}

修改后重启Gateway：

openclaw gateway restart
openclaw tui  # 测试连接是否成功

五、接入聊天平台（随时唤醒AI）

安装配置只是开始，真正让OpenClaw好用的是接入聊天平台——在微信、飞书、Telegram里直接跟它对话。

5.1 接入飞书

1.前往 飞书开放平台 创建企业自建应用

2.获取 App ID 和 App Secret

3.在OpenClaw配置中填入这两个凭证

4.开启长连接模式（推荐，比Webhook更稳定）

5.订阅消息事件：im.message.receive_v1

6.发布应用版本

配置完成后，在飞书里给机器人发消息，OpenClaw就会响应了。

5.2 接入QQ

在OpenClaw配置中找到QQ插件，填入机器人Token即可。QQ渠道适合个人用户，无需企业资质。

5.3 接入Telegram

1.找 BotFather 创建一个新机器人，获取API Token

2.通过 getidsbot 获取自己的数字ID

3.在OpenClaw配置中填入Token和Owner ID

💡 推荐优先接入Telegram，生态更干净，稳定性最好。

六、Skills插件：让AI无所不能

OpenClaw的Skills生态是其最大亮点之一。目前有1800+个Skills可用，涵盖各种实用场景：

                                                                                                                   

场景	代表Skills
浏览器自动化	Agent Browser、Chrome DevTools MCP
文件处理	PDF编辑、Word/Excel操作
编程辅助	Coding Agent、GitHub集成
信息获取	网络搜索、天气查询
定时任务	Cron定时提醒、日程管理

安装Skills

# 查看可用Skills
openclaw skills list

# 安装指定Skill
openclaw skills install github

# 搜索Skills
openclaw skills search "browser"

安装Skills后，它们会自动加载到OpenClaw的能力中，无需额外配置。

七、常见问题排查

Node.js版本不对

node -v  # 确认是22.x.x
nvm use 22  # 强制切换

网络超时

配置国内npm镜像后重试：

npm config set registry https://registry.npmmirror.com
npm install -g openclaw

Gateway启动失败

# 查看详细日志
openclaw gateway --port 18789 --verbose

# 检查端口占用
lsof -i :18789

飞书Bot不回复

确认已完成事件与回调中的长连接配置，并订阅了im.message.receive_v1事件。

八、总结

OpenClaw的安装其实并不复杂，核心就是三步：

1.装好Node.js 22+（用nvm管理更省心）

2.一行命令装好OpenClaw（本地或云端皆可）

3.onboard配置模型和渠道（5分钟搞定）

安装完成之后，你就拥有了一个7×24小时在线的AI数字员工。它可以帮你整理文件、写代码、生成报告、监控网站——所有你不想做的重复性工作，都可以交给它。

最难的不是安装，而是迈出第一步。 赶紧动手试试吧。

---

*如果你在安装过程中遇到问题，欢迎在评论区留言，或前往 awesome-openclaw-tutorial 获取更详细的故障排查指南。*