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 获取更详细的故障排查指南。*
夜雨聆风