夜雨聆风从零开始,10分钟搭建你的私人AI助手
1. 什么是OpenClaw?
OpenClaw(原名Clawdbot/Moltbot)是2026年最火爆的开源个人AI助手项目,GitHub星标超过26万+。与ChatGPT等传统AI不同,它不仅能回答问题,更能真正执行任务——清理邮箱、管理日程、整理文件、运行脚本,甚至自动编写代码。
核心优势:
✅ 本地部署:所有数据都在你的设备上,隐私安全 ✅ 多平台集成:支持微信、飞书、Telegram、WhatsApp等常用聊天工具 ✅ 自主执行:不仅建议怎么做,而是直接帮你完成 ✅ 开源免费:MIT协议,完全开源,社区活跃
2. 安装前准备
在开始安装之前,请确保你的设备满足以下要求:
系统要求:
操作系统:Windows 10+、macOS 10.15+、Linux(Ubuntu 20.04+) 内存:最低2GB,推荐4GB以上 存储空间:至少5GB可用空间 网络:稳定的互联网连接
2.1 核心依赖:Node.js
⚠️ 最重要! OpenClaw要求Node.js版本≥22,90%的安装失败都源于此!
检查当前Node.js版本:
node -v如果版本低于v22,必须先升级!
Windows用户:
方法1:下载官方安装包
访问 https://nodejs.org/ 下载LTS版本(v22.x),安装时勾选"Add to PATH"方法2:使用nvm-windows
下载nvm-windows,然后执行:- macOS/Linux用户:
# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 加载nvm
source ~/.bashrc
# 安装Node.js 22
nvm install 22
nvm use 22验证安装:
node -v # 应显示 v22.x.x 或更高
npm -v # 应显示 10.x.x 或更高2.2 其他工具
- Git:
用于拉取代码
Windows: https://git-scm.com/download
macOS:brew install git
Linux:sudo apt install git - 可选:Python 3.9+
某些技能需要 - 可选:FFmpeg
视频处理技能需要
3. 安装OpenClaw
OpenClaw提供三种安装方式,新手推荐使用一键脚本安装。
方式1:一键脚本安装 (推荐新手)
这是最简单的方式,会自动检测环境、安装依赖。
1
macOS/Linux用户:
curl -fsSL https://openclaw.ai/install.sh | bash2
Windows用户(需要WSL2):
首先,以管理员身份打开PowerShell,允许脚本执行:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser然后运行安装脚本:
iwr -useb https://openclaw.ai/install.ps1 | iex⚠️ Windows用户注意:
OpenClaw官方强烈推荐在WSL2(Windows Subsystem for Linux)中运行,因为原生Windows环境未经充分测试,兼容性问题较多。
安装WSL2的方法:
以管理员身份运行PowerShell,执行:wsl --install,然后重启电脑。
方式2:使用npm全局安装
如果你已经安装了Node.js 22+,可以直接使用npm安装:
npm install -g openclaw@latest国内用户加速:如果npm安装速度慢,可切换到国内镜像:
npm config set registry https://registry.npmmirror.com/
npm install -g openclaw@latest方式3:中文版安装
针对国内用户优化的中文版本,内置国产大模型支持:
npm install -g @qingchencloud/openclaw-zh@latest验证安装:
openclaw --version如果显示版本号(如 openclaw v2026.3.2),说明安装成功!
4. 初始化配置
安装完成后,需要运行初始化向导来完成基础配置。
openclaw onboard --install-daemon这个命令会启动一个交互式向导,引导你完成以下配置:
4.1 选择部署方式
- 本地Gateway
:推荐新手选择,在本地机器上运行 - 远程Gateway
:用于连接远程部署的服务器
4.2 配置AI模型
OpenClaw本身不提供模型,需要连接第三方AI服务:
推荐模型(国内用户):
🔹 DeepSeek:性价比高,中文理解好
获取API Key: https://platform.deepseek.com/🔹 通义千问:阿里云出品
获取API Key: https://dashscope.aliyun.com/🔹 Kimi(Moonshot):月之暗面出品
获取API Key: https://platform.moonshot.cn/
在向导中选择对应的模型提供商,粘贴你的API Key即可。
4.3 配置聊天渠道
OpenClaw支持多种聊天平台:
- Telegram
:最完善的官方支持 - 飞书
:国内用户推荐,功能丰富 - WhatsApp
:国际用户常用 - Discord
:游戏玩家常用
新手可以先跳过这一步,稍后再配置。
4.4 安装系统服务
向导会询问是否安装为系统服务(开机自启),建议选择是。
macOS:使用launchd Linux/WSL2:使用systemd Windows:使用计划任务
5. 启动与验证
5.1 启动Gateway
如果向导中安装了系统服务,Gateway应该已经自动启动。检查状态:
openclaw gateway status如果未启动,手动启动:
openclaw gateway start5.2 打开控制台
打开Web管理界面:
openclaw dashboard浏览器会自动打开 http://127.0.0.1:18789/
✅ 成功标志:
能看到OpenClaw的控制台界面 右上角显示绿色的"Health OK" 能发送消息并获得回复
5.3 发送第一条消息
试着给OpenClaw发送第一条指令:
你好,请帮我在桌面上创建一个名为hello_openclaw.txt的文件,写入"大道至简,实战落地"如果OpenClaw成功执行了这个任务,说明你的安装和配置完全正确!
6. 常见问题与解决方案
Q1: 安装时提示"openclaw不是内部或外部命令"
原因:Node.js未添加到PATH,或未重启终端
解决:重启PowerShell/终端,或重新安装Node.js并确保勾选"Add to PATH"
Q2: 提示"Unsupported Node.js version"
原因:Node.js版本低于22
解决:按前面的说明升级到Node.js 22+
Q3: npm install报错 EACCES (权限不足)
原因:npm全局安装需要管理员权限
解决:
Linux/Mac: 在命令前加sudo
Windows: 以管理员身份运行PowerShell
Q4: 网关无法启动
原因:端口被占用或配置错误
解决:
# 检查端口占用
openclaw gateway status
# 查看日志
openclaw logs --follow
# 重启网关
openclaw gateway restartQ5: Dashboard无法访问
原因:网关未运行或Token错误
解决:
确保网关正在运行: openclaw gateway status查看Gateway Token:
Windows:%USERPROFILE%\.openclaw\openclaw.json
Mac/Linux:~/.openclaw/openclaw.json复制token字段,添加到URL: http://127.0.0.1:18789/?token=你的token
Q6: Docker方式安装失败
原因:Docker未运行或资源不足
解决:
# 检查Docker状态
docker --version
docker ps
# 查看容器日志
docker logs openclaw
# 重启容器
docker restart openclaw🎉 恭喜!
你已经成功安装并配置了OpenClaw!现在你可以:
通过微信/飞书/Telegram等聊天工具与AI对话 让AI帮你整理文件、管理日程、清理邮箱 安装各种技能扩展功能 享受完全本地化的隐私保护
下一步:
访问技能市场: https://clawhub.com/ 查看官方文档: https://docs.openclaw.ai/zh-CN 加入中文社区:获取更多帮助和资源
相关资源:
OpenClaw官网: https://openclaw.ai/
GitHub仓库: https://github.com/openclaw/openclaw
中文社区: https://open-claw.org.cn/
