小白也能养龙虾!OpenClaw 安装教程,看这篇就够了

懒人工具志

每天带你发现一个好用的高效工具

关注我，让工作和生活更轻松

小白也能养龙虾！

OpenClaw 安装教程，看这篇就够了

写在前面

GitHub 31万星标、全网爆火的 AI 工具 OpenClaw（昵称「小龙虾」），到底怎么安装？网上教程五花八门，小白看完还是一头雾水。这篇文章，我按 Windows、Mac、Linux 三个系统，手把手带你从零开始，每一步都写清楚了，跟着做就能成功。

一、OpenClaw 是什么？一句话：它让 AI 替你操作电脑

OpenClaw 是一个开源的 AI 智能体工具，由清华团队发起，GitHub 星标已超 31 万。说白了，它就是一只数字「小龙虾」——你用自然语言告诉它想干什么，它就自动帮你操作电脑完成任务。

核心能力包括：

• 智能对话：支持 DeepSeek、Kimi、GPT-4、Claude 等主流大模型

• 文件操作：自动读取、创建、修改文件

• 命令执行：在终端运行命令，自动化脚本和系统管理

• 网页搜索：联网获取实时信息，帮你调研查资料

• 多平台：Windows、macOS、Linux 全覆盖

最重要的是：OpenClaw 完全免费、开源，任何人都可以使用。

二、安装前的准备工作（很重要，别跳过）

在正式安装之前，确认电脑满足以下条件，不满足的话安装会失败。

运行平台	Windows 10/11、macOS 12+、Ubuntu 20.04+
Node.js	22.16.0 及以上版本（推荐 24.x）
磁盘空间	至少预留 500MB
网络	安装时需联网（首次约 100-200MB）
API Key	至少准备一个模型的 Key（下文教怎么免费获取）

关于 API Key（新手必读）

OpenClaw 本身免费，但它需要连接 AI 大模型才能工作，连接大模型需要一个「通行证」，就是 API Key。很多国内平台都有免费额度，够日常使用。下面专门教你怎么获取。

附：如何免费获取 API Key（小白友好版）

国内用户推荐以下平台，注册即送免费额度，不需要信用卡，不需要翻墙：

DeepSeek	注册送 500 万 Token（约可对话几千次）官网：platform.deepseek.com → 注册 → API Keys → 创建
Kimi	注册送 15 元体验金官网：platform.moonshot.cn → 注册 → API Key 管理 → 新建
阿里百炼	注册送 100 万 Token 官网：bailian.console.aliyun.com → 开通 → 获取 Key
硅基流动	注册送 2000 万 Token（非常大方）官网：cloud.siliconflow.cn → 注册 → API 密钥
通义千问	注册送免费额度官网：dashscope.console.aliyun.com → 获取 Key

以 DeepSeek 为例（推荐新手）

第一步：打开 platform.deepseek.com，用手机号注册（填手机号→收验证码→设密码）第二步：登录后，点击左侧菜单「API Keys」第三步：点击「创建 API Key」，随便起个名字，点确定第四步：复制生成的 Key（格式类似 sk-xxxxxxxx），保存到记事本备用全程不超过 2 分钟，免费，不绑卡。

三、Windows 安装教程（最详细版）

以下是 Windows 10/11 的完整安装过程，每一步都有说明。跟着做，不会出错。

第一步：安装 Node.js

Node.js 是 OpenClaw 的运行环境，如果已装过可跳过。

（1）打开浏览器，访问 https://nodejs.org ，下载 LTS 版本的 .msi 安装包，双击运行，一路点「Next」，所有选项保持默认。

# 下载地址：https://nodejs.org/en/download

# 双击 .msi 文件 → Next → Next → Install → Finish

（2）安装完成后，按 Win+R，输入 powershell，回车。验证安装：

$ node -v

# 显示类似 v24.14.0 就成功了

# 如果显示「node 不是内部命令」，重启电脑再试

$ npm -v

# 显示类似 10.x.x 就说明 npm 也装好了

Node.js 安装失败的常见原因

1. 旧版本冲突：先去「控制面板→程序和功能」卸载旧版，再重装 2. 权限不足：右键 .msi →「以管理员身份运行」 3. 安装路径有中文：确保路径中无中文字符

第二步：安装 OpenClaw

在 PowerShell 中输入：

$ npm install -g openclaw@latest

# 下载约 100-200MB，需要 1-5 分钟

# 黄色警告信息是正常的，只要没有红色 error 就行

国内用户安装加速（强烈建议）

如果下载很慢或卡住，换成国内镜像源： npm install -g openclaw@latest --registry=https://registry.npmmirror.com 永久切换国内源：npm config set registry https://registry.npmmirror.com

验证安装：

$ openclaw -v

# 显示版本号就成功了

# 如果提示「找不到 openclaw」，看下方常见问题 Q1

第三步：初始化配置

第一次使用需要完成配置向导：

$ openclaw onboard

向导会问你几个问题，以下是建议选择：

选择 AI 模型	DeepSeek 用户选 DeepSeek V3，Kimi 用户选 Moonshot V1 没有偏好选第一个推荐的
输入 API Key	粘贴你之前保存的 Key（格式类似 sk-xxx）粘贴时直接 Ctrl+V，不需要加引号
选择主题	选 light（亮色）或 dark（暗色），只是外观
是否自启	输入 no，需要时手动打开就好

向导交互的关键提醒

1. API Key 输入时终端不会显示任何字符（正常的安全机制），直接粘贴回车 2. 网络断开就重新运行 openclaw onboard，不影响已装程序 3. 配置文件在用户目录下的 .openclaw 文件夹中

第四步：开始使用（推荐 Web 版）

安装完成后有两种使用方式。如果你不习惯敲命令，强烈推荐 Web 版——打开浏览器就能用，界面友好，操作简单。

方式一：Web 图形界面（推荐新手）

Web 版是小白的首选，不需要打开终端，在浏览器里就能跟 AI 对话、让它帮你干活。

$ openclaw web

# 运行后会自动打开浏览器（如果没有自动打开，手动复制地址）

# 默认地址是 http://localhost:3000

# 在浏览器地址栏输入这个地址就能访问

打开后你会看到一个类似聊天窗口的界面，和用微信聊天一样简单。直接在输入框里打字就行，比如：

# 你可以这样跟它说：

# 「帮我写一个 Python 脚本，批量重命名桌面上的文件」

# 「搜索一下最近 AI 领域有什么新进展」

# 「帮我整理一下这个文件夹，把图片和文档分开」

# 「帮我写一封请假邮件」

Web 版的优势

1. 界面直观，像聊天软件一样，不需要记任何命令 2. 支持文件拖拽上传，直接把文件拖进浏览器窗口就行 3. 对话历史自动保存，关闭浏览器下次打开还在 4. 支持深色/浅色主题切换

方式二：终端交互模式（适合命令行用户）

如果你习惯终端操作，也可以直接在命令行里使用：

$ openclaw

# 启动终端交互模式，会出现一个对话框

# 直接输入你的需求即可，和 Web 版功能一样

# 退出方式：输入 /exit 或按 Ctrl+C

两种方式怎么选？

日常使用推荐 Web 版，操作更友好。如果你是程序员，经常需要在终端环境里工作，终端模式更方便。两者功能完全一致，随时可以切换。

四、macOS 安装教程

Mac 用户的安装流程类似，命令不同。以下假设 macOS 12 及以上版本。

第一步：安装 Node.js

打开「终端」（启动台搜索 Terminal），检查是否已安装：

$ node -v

# 有版本号就跳过，没有就安装

方式一：官方安装包（推荐小白）

# 打开 https://nodejs.org 下载 .pkg 文件

# 双击 → 一路「继续」「安装」→ 重启终端验证

方式二：Homebrew（适合终端用户）

$ brew install node

# 没有 brew 先装：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

第二步：安装 OpenClaw

$ npm install -g openclaw@latest

# 国内加速：--registry=https://registry.npmmirror.com

# 权限报错就加 sudo：sudo npm install -g openclaw@latest

# 输入 Mac 登录密码（不会显示字符，正常输入）

第三步：配置并使用

$ openclaw onboard

# 配置向导和 Windows 一样

$ openclaw web

# 推荐：启动 Web 版，浏览器打开使用

$ openclaw

# 或者启动终端版

五、Linux 安装教程（以 Ubuntu 为例）

Linux 用户通常更熟悉命令行，流程更简洁。

第一步：安装依赖和 Node.js

$ sudo apt update && sudo apt upgrade -y

$ sudo apt install -y build-essential

$ curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

$ sudo apt install -y nodejs

$ node -v && npm -v

第二步：安装并使用

$ npm install -g openclaw@latest

# 国内加速或权限问题同上

$ openclaw onboard

$ openclaw web

# 启动 Web 版

六、常见问题与解决办法（遇到先看这里）

以下是安装和使用中最容易遇到的问题，覆盖 90% 的报错情况。

Q1：「openclaw 不是内部命令」

npm 全局路径没加到环境变量。 Windows：npm root -g 查看路径 → Win+R → sysdm.cpl → 高级 → 环境变量 → 用户变量 Path → 新建 → 粘贴路径 → 确定 → 重启终端 Mac/Linux：export PATH="$(npm root -g):$PATH"，加到 ~/.bashrc 或 ~/.zshrc 永久生效

Q2：EACCES 权限不足

Windows：以管理员身份运行 PowerShell Mac/Linux：命令前加 sudo 永久解决：修改 npm 全局安装目录到用户目录，参考 npm 官方文档「Resolving EACCES permissions」

Q3：「node 版本不兼容」

OpenClaw 要求 Node.js 22.16.0+。运行 node -v 检查，低于此版本去 nodejs.org 下载最新 24.x LTS 重装。装完重启终端确认。

Q4：国内安装速度极慢或超时

切换国内镜像源：npm config set registry https://registry.npmmirror.com 切回官方源：npm config set registry https://registry.npmjs.org

Q5：API Key 输入后没反应

正常现象。终端出于安全不显示密码/Key 字符。直接 Ctrl+V 粘贴 + 回车。看不到内容但已输入。

Q6：配置错了模型怎么办

重新运行 openclaw onboard 覆盖旧配置，或直接编辑 ~/.openclaw/config.json 配置文件。

Q7：「API Key 无效」

1. 确认 Key 没有多余空格或换行 2. 登录平台确认 Key 是否正确、是否过期 3. 确认账户余额 4. 重新运行 openclaw onboard 更新

Q8：杀毒软件报毒

360、火绒等可能误报 npm 新包。暂时关闭杀毒软件安装完再开启。OpenClaw 完全开源，GitHub 代码公开可查。

Q9：想换 AI 模型

openclaw config set model deepseek-v3 openclaw config set model moonshot-v1 支持随时切换，不需要重装。

Q10：Web 版打不开或无法访问

1. 确认 openclaw web 命令已运行（终端不要关闭） 2. 浏览器访问 http://localhost:3000 3. 如果端口被占用，终端会显示其他端口号，用显示的地址访问 4. 防火墙可能阻止，检查防火墙设置或暂时关闭

七、使用注意事项（安全第一）

OpenClaw 能帮你操作电脑，意味着它有你的账户权限。以下安全建议务必了解：

1. 首次使用先在测试文件夹试运行

新建一个测试文件夹让它做实验，确认效果再扩展范围。

2. 重要文件提前备份

AI 偶尔会理解偏差，操作重要文件前先备份。

3. 仔细审查它要执行的操作

OpenClaw 执行操作前会先向你展示，认真看再批准（「审批模式」默认开启）。

4. 不要把 API Key 分享给别人

Key 泄露了去平台后台删除，创建新的。

5. 定期更新

npm update -g openclaw，新版本修复 Bug、提升性能。

6. 关闭不需要的权限

如果只需要聊天查资料，可关闭文件写入和命令执行权限。

八、写在最后

OpenClaw 的出现，标志着 AI 从「能聊天」进化到了「能干活」。以前你需要打开浏览器搜索、打开编辑器写代码、打开终端敲命令——现在一句话就能搞定。

它不是万能的，AI 会犯错、会理解偏差。但技术在进步，今天的 OpenClaw 已经比半年前好用太多。

安装或使用中遇到问题，欢迎在公众号后台留言，我会帮你解决。

觉得有帮助？点赞、在看、转发，让更多人知道这个好工具！

关注「懒人工具志」

每天一个高效工具，让工作和生活更轻松

扫码关注，不错过每一期干货

#AI工具

#免费开源

#效率神器

#小龙虾

—— 懒人工具志，每天带你发现一个好用的高效工具 ——