爆火OpenClaw保姆级安装教程|新手零门槛,手把手教你部署专属AI管家

家人们谁懂啊！2026年最顶的开源AI工具，非OpenClaw莫属🔥

GitHub星标狂涨至10万+，不是普通的聊天AI，是能真正帮你干活的「全能管家」——自动整理文件、执行代码、对接飞书发消息、管理日历，甚至24小时后台值守，解放双手直接拉满！

很多新手后台私信说“不会安装”“配置报错”，今天这篇保姆级教程，全程图文级步骤（无复杂术语），Windows/macOS/Linux全系统适配，新手跟着走，5分钟就能部署成功，看完直接上手！

先划重点：OpenClaw完全免费，仅AI模型API调用有少量费用（国内模型日均几毛钱），普通电脑就能安装，无需高端配置，新手放心冲！

一、先搞懂：OpenClaw到底牛在哪？

别再把它和普通AI混为一谈！它的核心优势的是「能动手，不废话」，对比一眼看清：

简单说：普通AI是“嘴炮”，OpenClaw是“实干家”，办公党、程序员、宝妈都能用到，省下来的时间用来摸鱼不香吗？

二、安装前准备（5分钟搞定，缺一不可）

不管什么系统，先准备好这2件事，避免安装时卡壳：

1. 软硬件要求（普通电脑完全满足）

• 操作系统：Windows 10+/macOS 12+/Linux（Ubuntu优先）

• 内存：最低4GB，推荐8GB（运行更流畅）

• 网络：能访问外网（国内用户可用镜像，下文有教程）

• AI API Key：后续配置，先不用急，新手可先跳过

2. 核心依赖：Node.js v22+（必装！）

所有系统都需要先安装Node.js v22及以上版本，推荐用nvm管理（避免版本冲突），不同系统操作如下，复制命令直接执行即可：

✅ Linux/macOS用户（终端操作）：

# 安装nvm（版本管理工具）curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bashsource ~/.bashrc# 安装并使用Node.js 22nvm install 22nvm use 22# 验证是否成功（显示v22.x.x即可）node --version

✅ Windows用户（简单版）：

直接去Node.js官网，下载v22版本安装包，双击下一步即可（默认安装路径，不用修改），安装完成后重启终端，输入node --version验证。

小贴士：如果安装Node.js报错，直接重启电脑再试，90%的问题都能解决～

三、全系统安装步骤（3种方案，新手首选一键安装）

OpenClaw提供3种安装方式，新手直接选「一键脚本」，不用手动配置，全程自动完成；进阶用户可选手动安装或Docker部署，按需选择即可。

方案1：一键脚本安装（新手首选，5分钟搞定）

全系统适配，复制对应命令，粘贴到终端/ PowerShell，回车等待即可，全程不用手动操作。

👉 Windows用户（重点看！）

1. 第一步：以「管理员身份」打开PowerShell（右键开始菜单，找到“Windows PowerShell (管理员)”）；

2. 第二步：输入以下命令，解锁脚本权限（输入Y确认）：        Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 第三步：关闭管理员终端，打开「普通PowerShell」，粘贴以下命令，执行一键安装：        iwr -useb https://openclaw.ai/install.ps1 | iex

4. 第四步：出现「OpenClaw installed successfully」，就说明安装成功啦！

👉 macOS/Linux用户

1. 打开终端（Linux：Ctrl+Alt+T；macOS：启动台→其他→终端）；

2. 粘贴以下命令，回车执行（macOS需输入开机密码，输入时不显示，直接回车即可）：        curl -fsSL https://openclaw.ai/install.sh | bash

3. 全程自动安装，等待1-3分钟，出现成功提示即完成。

👉 国内网络优化（下载卡顿必看）

如果执行脚本时下载很慢、卡住，说明网络受限，替换成国内镜像脚本，复制执行：

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

方案2：npm手动安装（进阶用户）

适合有一定终端基础的用户，步骤如下：

# 1. 配置国内npm镜像（解决下载慢）npm config set registry https://registry.npmmirror.com# 2. 全局安装OpenClawnpm i -g openclaw@latest# 3. 验证安装（显示版本号即成功）openclaw --version

⚠️ 若出现「权限错误（EACCES）」，不要用sudo，执行以下命令解决：

npm config set prefix ~/.localexport PATH="$HOME/.local/bin:$PATH"# 重新安装npm install -g openclaw

方案3：Docker容器化部署（服务器用户首选）

适合云服务器部署（24小时在线），隔离环境更稳定，步骤：

# 克隆源码git clone https://github.com/openclaw/openclaw && cd openclaw# 后台启动容器docker-compose up -d# 验证状态（显示Up即成功）docker compose ps

安装验证（必做！）

不管用哪种方式，安装完成后，在终端输入以下命令，能显示版本号（如2026.3.2），就说明安装成功了：

openclaw --version

四、首次配置向导（必做！否则无法使用）

安装完成后，必须通过配置向导，完成基础设置，新手选「快速开始」，全程交互式操作，不用懂代码，跟着提示走就行。

1. 启动配置向导

推荐带「守护进程」（开机自启，后台运行），输入以下命令：

openclaw onboard --install-daemon

如果不需要开机自启，输入：openclaw onboard

2. 分步配置（新手友好，图文级提示）

1. 风险提示：按「左方向键」选「Yes」，按Enter确认（OpenClaw需要操作电脑的权限，放心选）；

2. 部署模式：选「QuickStart」（快速开始），跳过非必要配置，节省时间；

3. AI模型API Key：如果还没获取，先选「Skip for now」跳过，后续单独配置（新手先跳过，先完成基础部署）；

4. 默认模型：随便选一个临时占位，后续可以修改；

5. 网关端口：默认18789，不用修改，直接确认。

3. 配置后验证

输入以下命令，验证配置是否成功：

# 检查Gateway运行状态（显示running即成功）openclaw gateway status# 健康检查（返回{"status":"healthy"}即正常）curl http://127.0.0.1:18789/api/v1/health# 打开Web控制面板（浏览器自动跳转）openclaw dashboard

打开Web控制面板后，能看到OpenClaw的操作界面，就说明配置成功啦！

五、AI模型API Key配置（核心！国内用户首选）

OpenClaw需要对接AI模型，才能实现对话和各种操作，国内用户优先选「智谱GLM」（免费额度大，新手友好），其次是阿里云百炼，步骤超简单。

方案1：智谱GLM（推荐新手，免费！）

1. 获取API Key：

1. 访问「智谱AI开放平台」（点击跳转），注册并完成实名认证（很简单，几分钟搞定）；

2. 进入「API密钥」页面，点击「创建密钥」，复制生成的API Key（妥善保存，不要泄露）。

2. 配置OpenClaw： 打开Web控制面板，找到「模型配置」，粘贴API Key，保存即可；也可以直接修改配置文件，核心参数如下（替换成你的API Key）：{  "models": {    "providers": {      "zhipu": {        "baseUrl": "https://open.bigmodel.cn/api/paas/v4",        "apiKey": "你的智谱API Key",        "models": [{"id":"glm-4","name":"GLM-4"}]      }    }  }}

方案2：阿里云百炼（云服务器用户推荐）

登录「阿里云控制台」，进入「百炼大模型」服务，在「密钥管理」中创建并复制Access Key ID和Access Key Secret，按照Web控制面板的提示粘贴配置即可，这里不赘述。

关键提醒（必看！）

• API Key切勿泄露，不要分享给他人，否则可能被盗用、产生额外费用；

• 智谱GLM有免费额度，日常使用完全足够，超出后按用量计费（单价极低，日均几毛钱）；

• 如果配置后模型调用失败，检查3点：API Key是否正确、账户是否有配额、网络是否能访问模型地址。

六、接入飞书（国内用户首选，随时随地控制AI）

配置好AI模型后，把OpenClaw接入飞书，不用打开电脑，发一条消息就能让AI干活（比如“整理桌面文件”“约会议”），步骤分2部分，很简单。

第一步：飞书开放平台创建企业自建应用

1. 登录「飞书开放平台」（点击跳转），点击「创建应用」→「企业自建应用」；

2. 填写应用名称（比如“我的AI助手”），可选上传图标，点击「创建」；

3. 获取核心凭证：进入应用详情页→「凭证与基础信息」，复制「App ID」和「App Secret」（保存好，后续要用）；

4. 配置权限：进入「权限管理」→「批量开通」，粘贴以下JSON（实现消息收发、群聊访问），点击「开通」：        {  "scopes": {    "tenant": [      "im:message", "im:message.p2p_msg:readonly", "im:message:send_as_bot",      "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access"    ],    "user": ["im:chat.access_event.bot_p2p_chat:read"]  }}

5. 发布应用：点击「版本管理与发布」→「创建版本」→「申请发布」，个人账号直接审核通过，企业账号需管理员审批。

第二步：OpenClaw侧配置飞书插件

# 1. 安装飞书渠道插件openclaw plugins install @openclaw/feishu# 2. 配置飞书App ID和App Secret（替换成你的凭证）openclaw config set channels.feishu.appId 你的App IDopenclaw config set channels.feishu.appSecret 你的App Secret# 3. 重启Gateway，使配置生效openclaw gateway restart

验证对接

在飞书中找到你创建的「AI助手」应用，发送消息「帮我查今天的天气」，如果AI能回复天气信息，就说明对接成功啦！以后发指令，AI就会自动干活～

七、进阶使用：让AI真正帮你解放双手

配置完成后，不用打开电脑客户端，在飞书发自然语言指令，就能让OpenClaw执行操作，分享几个高频实用场景，看完直接封神：

• 指令：「帮我和张三约下周三下午三点的面试」→ AI自动创建飞书日历，发送会议链接给张三；

• 指令：「整理桌面文件，按类型分文件夹」→ AI扫描桌面，自动创建文档、图片、视频文件夹，分类整理；

• 指令：「写一段爬取京东商品价格的Python代码」→ AI自动编写代码，在服务器上运行测试；

• 指令：「把桌面的XX文档翻译成英文」→ AI读取文档内容，翻译后生成新文件保存。

小技巧：让AI记住你的习惯

编辑「USER.md」文件，填写你的个人信息（比如职业、工作习惯、联系方式），AI会永久记住，回复更精准：

# Linux/macOS用户，终端输入nano ~/.openclaw/USER.md# Windows用户，找到对应目录，用记事本编辑

示例内容：“我是后端工程师，主要用Python，工作时区是北京时间，回复要简洁，不要废话，飞书@我就能联系到我。”

八、常见问题避坑指南（新手必看！）

整理了大家安装时最常遇到的5个问题，对应解决方案，遇到报错直接查这里，不用再找教程：

问题1：输入openclaw命令，提示“命令不存在”

原因：Node.js环境变量未配置，或OpenClaw未加入系统PATH；

解决：Linux/macOS执行「export PATH="$HOME/.local/bin:$PATH"」，并加入~/.bashrc；Windows重启终端，重新安装Node.js。

问题2：安装时卡在下载，速度很慢

解决：切换国内镜像脚本（上文有），关闭杀毒软件/防火墙，换稳定网络。

问题3：Windows执行PowerShell脚本报错

原因：未解锁脚本执行权限；

解决：重新以管理员身份打开PowerShell，执行「Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser」，输入Y确认。

问题4：飞书消息无法发送/接收

解决：检查App ID和App Secret是否正确；确认飞书应用已发布、权限已开通；重启Gateway（openclaw gateway restart）。

问题5：AI模型调用超时/失败

解决：检查API Key是否正确、账户是否有配额；验证网络能否访问模型地址；切换其他AI模型尝试。

九、常用命令速查表（收藏！）

日常使用高频命令，复制保存，不用记，用到时直接查：

最后说两句

OpenClaw的核心价值，就是“让AI落地干活”，不用懂复杂的部署和代码，新手跟着这篇教程，全程复制命令、跟着提示走，5分钟就能部署成功。

后续我还会分享OpenClaw的进阶玩法（比如自动办公脚本、多平台对接），关注我，不迷路～

如果安装过程中遇到其他问题，评论区留言，我会一一回复！

❤️ 觉得有用，记得点赞、在看、转发，给新手留个方便～

如果你正在学习python，这些Python资料、数据分析、Python从入门到实践第三版pdf书籍、Python+Pycharm安装包&永久激活插件、直播课程，可以在这里免费领取哈👇