乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > 零基础10分钟装好OpenClaw:新手小白的第一个AI管家安装指南

零基础10分钟装好OpenClaw:新手小白的第一个AI管家安装指南

当前时间： 2026-07-06 16:00:03 更新时间： 2026-07-06 分类：软件教程 评论(0)

零基础10分钟装好OpenClaw:新手小白的第一个AI管家安装指南

你刷到过这样的帖子吗——「我把 500 篇 PDF 丢给 AI，10 分钟整理好了表格」「用 AI 帮我盯盘，每天自动推送行情」「微信发一句话，电脑就跑完了脚本」。

下面评论区永远有人在问：「怎么搞的？」「求教程。」「要钱吗？」

答案就是一个名字——OpenClaw。

今天这篇文章，用最直白的话告诉你：OpenClaw 是什么、怎么装、遇到报错怎么办。零基础也能跟着走。

一、先说清楚：OpenClaw 到底是什么

你可以把它理解为一个「AI 管家」。

ChatGPT、豆包这些，你在网页上问一句它回一句。对话结束就没了。但 OpenClaw 不一样——它跑在你自己的电脑上，你不在的时候它也在干活。整理文件、收发邮件、定时搜索、操控浏览器、连接微信/飞书/Telegram……大部分你想得到的重复操作，它都能自动化。

几个核心事实：

  • 完全开源免费（MIT 协议），不需要花钱
  • 跑在你自己的电脑上，数据不经过云端
  • 需要接入大模型 API——你要有一个 API Key（OpenAI/Claude/通义千问都行）
  • 支持 Windows、macOS、Linux

⚠️ 最需要搞清楚的误会：OpenClaw 只是一个「让 AI 能操作你电脑」的框架，它本身不会思考。你需要给它接一个大模型（比如 Kimi、Claude、DeepSeek），它才有脑子。就像你装了一个微信客户端——但你自己得有微信号才能聊天。

二、装之前先检查这三样东西

① Node.js（必须大于等于 22）

打开终端（Windows 叫「命令提示符」或 PowerShell，Mac 叫「终端」），输入：

node --version

如果出来 v22.x.x 或 v24.x.x，OK，下一步。不是的话要装一下。

怎么装 Node.js？最简单的办法：打开 nodejs.org 官网，下载 LTS 版本（左边那个绿色按钮），一路「下一步」装完。装完后重启终端再查版本。

② 一个 API Key

这是唯一的「门槛」。OpenClaw 需要调用大模型，所以你得有一个能用的 API Key。

如果你已经有 OpenAI 或者 Claude 的 API Key，直接跳过。如果还没有，最推荐的办法是注册一个国产大模型的 Key——便宜、中文好、不需要折腾：

  • 通义千问（阿里云）：dashscope.aliyun.com
  • DeepSeek：platform.deepseek.com
  • Kimi（月之暗面）：platform.moonshot.cn

注册后都能免费领额度，够你玩很久。

③ Windows 用户：关闭杀毒软件

这是很多人踩的第一个坑。360、火绒、Windows Defender 实时防护——安装前先关掉。OpenClaw 需要系统级权限，杀毒软件会拦截它的启动过程。装完后可以再打开。Mac 用户不需要。

三、正式安装（选你的系统）

macOS / Linux（最简单）

打开终端，复制粘贴下面这行命令，回车：

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

这句话的意思是：从 OpenClaw 官网下载安装脚本，自动帮你装好所有东西——Node.js（如果没装的话）、OpenClaw 本体、全部依赖。全程自动，你只需要等 3-5 分钟。

装完后继续执行：

openclaw onboard --install-daemon

这会启动一个引导向导，问你「用什么模型」「API Key 是多少」。一句一句跟着走就行。

Windows

Windows 用户有两种装法：

方案 A（推荐新手）：PowerShell 一键脚本

右键单击开始菜单 → 选择「Windows PowerShell（管理员）」或「终端（管理员）」。贴入：

iwr -useb https://openclaw.ai/install.ps1 | iex

回车，等待。同样自动装好一切。

方案 B（更稳定）：WSL2

如果方案 A 报错（特别是遇到 sharp 库构建失败），用 WSL2：

以管理员身份打开 PowerShell，依次执行：

wsl --install
wsl --install -d Ubuntu

重启电脑，进入 Ubuntu 终端，然后执行 macOS 那条一键命令就行了。

通用方案：npm 安装

如果你已经装了 Node.js，任何系统都能用 npm 安装：

npm install -g openclaw@latest
openclaw onboard --install-daemon

国内用户如果 npm 下载慢，先换源：

npm config set registry https://registry.npmmirror.com

四、验证安装成功

安装完成后，依次运行这三条命令验证：

openclaw --version          # 看版本号
openclaw gateway status      # 看 Gateway 是否在运行
openclaw dashboard           # 打开控制面板（浏览器）

如果 openclaw dashboard 自动弹出一个网页，上面有个聊天框，输入「你好」能回复——恭喜你，装成功了。

如果 openclaw gateway status 显示 Gateway: running 和端口号 18789，Gateway 也跑起来了。

五、新手最容易遇到的 5 个坑

坑 1：提示「command not found: openclaw」

原因：npm 的全局目录没有加到系统 PATH。

修法：

# 先找到 npm 全局路径
npm prefix -g

# 把那个路径加到 PATH（替换为你实际看到的路径）
echo 'export PATH="/usr/local/lib/node_modules/npm/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 再试试
openclaw --version

坑 2：提示「Node.js 版本不兼容」

现象：

npm warn EBADENGINE Unsupported engine
required: node >= 22
current: node v18.x.x

原因：Node.js 版本太低。OpenClaw 需要 22 以上。

修法：去 nodejs.org 官网下载最新 LTS 版，覆盖安装。装完重启终端再查版本。

坑 3：提示「EADDRINUSE: address already in use」

原因：18789 端口被占了。可能是之前启动过没关掉。

修法（macOS/Linux）：

lsof -i :18789
kill -9 [PID]

修法（Windows）：

netstat -ano | findstr 18789
taskkill /PID [PID] /F

或者直接换个端口：

openclaw configure  # 找到 gateway.port，改成别的比如 18790

坑 4：Gateway 显示 installed 但不 running

原因：Windows 计划任务状态异常（常见于非管理员安装），或 macOS LaunchDaemon 没启动。

修法（Windows）：以管理员身份打开 PowerShell，执行：

openclaw gateway install --force
openclaw gateway start

修法（macOS）：

openclaw gateway uninstall
openclaw gateway install
openclaw gateway start

坑 5：发送消息后没有回复（最经典的坑）

原因：API Key 没配，或者配错了。

排查：

openclaw config    # 查看当前配置
openclaw doctor    # 自动诊断

openclaw doctor 是神器——它会自动检查 API Key 是否有效、端口有没有冲突、守护进程配没配好。大部分问题它自己就能修。加上 --repair 参数还能自动应用修复：

openclaw doctor --repair

另外再看实时日志找问题：

openclaw logs --follow

99% 的情况，日志里会打出来「No API key found」或者「401 Unauthorized」——就是 Key 没配对。去你注册的那个大模型平台，找到正确的 API Key，复制粘贴进 openclaw configure 里即可。

六、装上之后，推荐做的第一件事

打开 openclaw dashboard，找到「Skills」标签页——这是 OpenClaw 最好玩的部分。技能市场里有 5000+ 个社区技能，从「自动整理桌面文件」到「定时推新闻」再到「写公众号文章」（对，包括我现在做的这个），点一下安装就能用。

如果你想让 OpenClaw 在微信里回复你：在 Skills 里搜微信相关插件，装对应渠道插件，扫码绑定，之后你手机上发微信消息，AI 就在电脑上帮你干活了。

如果你想把它放到云服务器上 24 小时跑：装到阿里云/腾讯云轻量服务器上（选 Ubuntu 镜像，同样用上面那条一键命令），配置好后它会一直在线。

七、总结

安装路线图：

装 Node.js（大于等于22）→ 获取 API Key → 关闭杀毒软件 → 一行命令安装 → onboard 引导配置 → 验证 → 安装技能

整条流程，从零到能发第一条消息，10 分钟就够了。

如果中途报错，记住两条原则：

  1. 先跑 openclaw doctor——它能自动诊断 80% 的问题
  2. 看日志 openclaw logs --follow——错误原因会写得很清楚

别再被那些「代安装收费 199」的帖子割韭菜了。开源工具，自己就能搞定。

—— Funmaker