乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > �� OpenClaw中文保姆级安装教程

�� OpenClaw中文保姆级安装教程

当前时间： 2026-03-10 18:51:37 分类：办公文件 评论(0)
�� OpenClaw中文保姆级安装教程

从零开始,10分钟搭建你的私人AI助手

1. 什么是OpenClaw?

OpenClaw(原名Clawdbot/Moltbot)是2026年最火爆的开源个人AI助手项目,GitHub星标超过26万+。与ChatGPT等传统AI不同,它不仅能回答问题,更能真正执行任务——清理邮箱、管理日程、整理文件、运行脚本,甚至自动编写代码。

核心优势:

  • ✅ 本地部署:所有数据都在你的设备上,隐私安全
  • ✅ 多平台集成:支持微信、飞书、Telegram、WhatsApp等常用聊天工具
  • ✅ 自主执行:不仅建议怎么做,而是直接帮你完成
  • ✅ 开源免费:MIT协议,完全开源,社区活跃
特性
传统AI (ChatGPT)
OpenClaw
数据存储
云端服务器
本地设备 ✅
执行能力
仅提供建议
直接执行任务 ✅
隐私安全
依赖第三方
完全自主 ✅
访问成本
固定月费($20)
按需付费(5-30元) ✅

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 | bash

2

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 start

5.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 restart

Q5: Dashboard无法访问

原因:网关未运行或Token错误

解决:

  1. 确保网关正在运行: openclaw gateway status
  2. 查看Gateway Token:
    Windows: %USERPROFILE%\.openclaw\openclaw.json
    Mac/Linux: ~/.openclaw/openclaw.json
  3. 复制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/