零基础也能轻松上手!OpenClaw本地安装全教程

⚠️ 重要声明：本文仅适用于零基础/无技术背景小白，本地电脑安装，不提供服务器部署方案。

为什么？ OpenClaw 的核心价值是操作你的电脑——整理文件、控制软件、访问本地数据。部署在服务器上，大部分能力失效。

一、为什么 OpenClaw 安装这么难？

如果你之前尝试过安装但失败了，不是你的问题。OpenClaw 的安装门槛确实高，主要卡在以下 4 个点：

痛点 1：科学上网问题

为什么需要？

OpenClaw 的核心代码托管在 GitHub（美国），安装时需要从国外服务器下载大量依赖包。

具体表现：

- 下载速度极慢（几 KB/s）

- 连接超时中断

- npm 仓库访问失败

本文解决方案：

✅ 使用国内镜像源（无需科学上网）

✅ 推荐国产 AI 工具辅助（通义灵码、Trae 等，国内可直接访问）

痛点 2：环境变量配置（Node.js、Git、Python）

很多人看到要安装这些”编程环境”就被吓退了。别担心，我会解释为什么需要它们，以及具体怎么装。

为什么需要 Node.js？

原因：OpenClaw 是用 JavaScript/TypeScript 编写的，Node.js 是运行这些代码的”发动机”。

通俗理解：

- 就像你要看视频需要安装”视频播放器”

- 你要运行 OpenClaw，就需要安装”Node.js 运行环境”

版本要求：必须 ≥ 22（低于此版本会编译失败）

为什么需要 Git？

原因：OpenClaw 的某些高级技能（Skills）需要从 GitHub 拉取代码。

通俗理解：

- Git 是一个”代码下载工具”

- 就像用迅雷下载电影，Git 用来下载开源代码

注意：基础功能不需要 Git，但如果你想扩展功能（如安装社区技能），就必须安装。

为什么需要 Python？

原因：部分技能（如数据处理、AI 模型调用）是用 Python 编写的。

通俗理解：

- 某些”插件”是用 Python 写的，需要 Python 环境才能运行

- 就像某些游戏需要 DirectX 才能运行

版本要求：3.8 及以上

痛点 3：API Key 配置

什么是 API Key？

简单说，它是你使用大模型服务的”通行证”或”充值卡”。

为什么需要？

OpenClaw 本身只是一个”空壳”，它需要连接大模型（如通义千问、Kimi、Claude）才能思考。API Key 就是连接凭证。

通俗理解：

- OpenClaw = 手机硬件 - 大模型 = 移动网络信号

- API Key = SIM 卡（没有它，手机无法联网）

本文解决方案：

✅ 推荐阿里云百炼（国内可直接访问，新用户有免费额度）

✅ 提供详细获取步骤（截图级指引）

痛点 4：权限和环境问题

常见问题：

- Windows 提示”无法运行脚本”

- Mac 提示”权限不足”

- 安装完成但命令无法识别

- unauthorized: gateway token missing 等一些报错

本文解决方案：

✅ 提供权限解锁步骤

✅ 提供环境变量配置方法

✅ 提供安装失败自检表

✅ 防火墙

二、这篇文章适合谁？

✅ 适合人群

完全零基础、没有技术背景的小白

不懂编程、不懂命令行、不懂技术术语
能跟着步骤一步一步操作

没有科学上网条件的用户

所有步骤均使用国内可访问的资源
无需翻墙

想在本地电脑使用 OpenClaw 的用户

希望 AI 能操作自己的文件、软件、数据
理解本地部署的价值

❌ 不适合人群（劝退清单）

如果你符合以下任一情况，建议先不要安装：

电脑配置过低

内存 < 4GB
硬盘剩余空间 < 2GB
电脑运行已经很卡

无法接受命令行操作

看到黑色窗口就害怕
完全不愿意复制粘贴命令

期望”一键安装、自动使用”

OpenClaw 需要配置 API Key、聊天软件等
至少需要 30 分钟耐心操作

想在服务器上部署

服务器无法操作本地文件
失去 OpenClaw 80% 的能力
本文不提供服务器部署方案

三、两种安装方案（任选其一）

方案	适合人群	难度	耗时
方案一：AI 工具辅助安装	完全零基础，不想碰命令行	⭐	20 分钟
方案二：手动本地部署	愿意学习，想完全掌控	⭐⭐⭐	40 分钟

建议：完全不懂技术的朋友，优先选择方案一。

方案一：AI 工具辅助安装（推荐零基础）

这种方式的核心思想是：让 AI 教你安装 AI。

你只需要下载一个 AI 编程工具，然后告诉它”帮我安装 OpenClaw”，它会一步步指导你。

第一步：下载 AI 编程工具（三选一）

这三个工具都可以，选一个下载：

选项 A：通义灵码（阿里出品）⭐ 国内推荐

背景：阿里巴巴基于通义千问大模型开发的 AI 编程助手，完全免费，中文支持最好。

下载步骤：

打开浏览器，访问：https://tongyi.aliyun.com/lingma
点击”下载”按钮
下载完成后，双击安装包
一直点”下一步”，直到安装完成
打开软件，用支付宝或淘宝账号登录

优点：

✅ 完全免费

✅ 中文支持最好

✅ 阿里云背书，稳定可靠

选项 B：Trae（字节跳动出品）

背景：字节跳动（抖音母公司）推出的 AI 编程工具，支持多模型切换，完全免费。

下载步骤：

打开浏览器，访问：https://trae.com
点击”Download”按钮
下载完成后，双击安装包
一直点”下一步”，直到安装完成
打开软件，用抖音或头条账号登录

优点：

✅ 完全免费

✅ 支持多种 AI 模型

✅ 中文界面友好

选项 C：Cursor（国际知名）

背景：基于 VS Code 开发的 AI 编程编辑器，功能强大，但部分高级功能需要付费。

下载步骤：

打开浏览器，访问：https://cursor.com
点击”Download”按钮
下载完成后，双击安装包
一直点”下一步”，直到安装完成
打开软件，用邮箱注册登录

优点：

✅ 功能最强大

✅ 社区活跃

✅ 支持多种插件

缺点：

❌ 部分功能需要付费（贵）

❌ 英文界面为主

第二步：获取大模型 API Key

AI 工具需要连接大模型才能工作。国内推荐用阿里云百炼，首月 7.9 RMB，很适合新手体验人群，推荐链接：“https://www.aliyun.com/benefit/ai/aistar?clubBiz=subTask..12407452..10263..”

步骤：

打开浏览器，访问：https://bailian.console.aliyun.com
用支付宝扫码登录
点击左侧”API-KEY 管理”
点击”创建新的 API-KEY”
复制生成的 Key（格式类似：sk-xxxxxxxxxxxxxxxx）

💡 提示：新用户通常有免费额度，够你用很长时间。

第三步：让 AI 帮你安装 OpenClaw

打开刚才下载的 AI 编程工具（通义灵码/Cursor/Trae）
找到对话框（通常在右侧或底部）
输入以下内容：

请帮我安装 OpenClaw。我是完全零基础的小白，请一步一步指导我操作。我需要：1. 检查我的电脑是否满足安装条件2. 告诉我需要安装什么软件（如 Node.js、Git 等）3. 提供详细的安装步骤，包括去哪里下载、怎么安装4. 安装完成后，帮我配置 OpenClaw我的电脑系统是：[在这里填写你的系统，如 Windows 11 / macOS 14 / Ubuntu 22.04]

4. 按回车发送

严格按照 AI 的指引操作，每一步做完再问下一步

第四步：验证安装

安装完成后，让 AI 帮你验证：

请帮我验证 OpenClaw 是否安装成功，并告诉我怎么使用。

方案二：手动本地部署

如果你想完全掌控，或者想深入学习，可以选择这种方式。

第一部分：环境准备

1. 安装 Node.js（必须）

步骤：

打开浏览器，访问：https://nodejs.org
你会看到两个版本：

LTS 版本（长期支持版，推荐）← 选这个
Current 版本（最新版，不稳定）

点击绿色的”LTS”下载按钮
下载完成后，双击安装包
一直点”下一步”，所有选项保持默认即可
关键：确保勾选”Add Node.js to PATH”（自动配置环境变量）
安装完成后，重启电脑（重要！）

验证是否安装成功：

按键盘上的 Win + R（Windows）或打开”终端”（Mac）
输入：cmd（Windows）或直接打开终端（Mac）
在黑色窗口中输入：node --version
如果显示类似 v22.x.x 的数字，说明安装成功
如果显示”不是内部命令”或没反应，说明没装好，重新安装

2. 安装 Git（推荐）

步骤（Windows）：

打开浏览器，访问：https://git-scm.com/download/win
下载会自动开始
下载完成后，双击安装包
一直点”Next”，所有选项保持默认
安装完成后，不用重启

步骤（Mac）：

打开”终端”（在”应用程序”→“实用工具”里）
输入：git --version
如果显示版本号，说明已安装
如果提示”需要安装”，按提示点击”安装”即可

验证是否安装成功：

打开命令行
输入：git --version
如果显示类似 git version 2.x.x，说明成功

3. 安装 Python（部分功能需要）

步骤：

打开浏览器，访问：https://www.python.org/downloads
页面会自动识别你的系统，显示下载按钮
点击”Download Python 3.x.x”
下载完成后，双击安装包
关键：勾选”Add Python to PATH”（添加到环境变量）
点击”Install Now”
安装完成后，重启电脑

验证是否安装成功：

打开命令行
输入：python --version
如果显示类似 Python 3.x.x，说明成功

4. 检查电脑配置

OpenClaw 对电脑配置要求不高，但还是要检查一下：

配置项	最低要求	如何查看
内存	4GB	Windows: 右键”此电脑”→“属性”；Mac: 左上角苹果图标→“关于本机”
硬盘空间	2GB 可用	打开”此电脑”或”访达”，查看剩余空间
系统	Windows 10 / macOS 12 / Linux	同上
网络	能正常上网	能打开网页就行

第二部分：安装 OpenClaw

步骤 1：打开命令行

Windows 用户：

按键盘上的 Win + R
输入：cmd
按回车

Mac 用户：

按 Command + 空格
输入：终端
按回车

步骤 2：配置国内镜像（防止下载超时）

在黑色窗口中，输入以下命令：

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

输入后按回车。

💡 说明：npm 默认服务器在国外，配置成国内镜像可以大幅提升下载速度。

步骤 3：输入安装命令

在命令行中，输入以下命令：

npm install -g openclaw@latest

输入后按回车，会开始下载和安装。

步骤 4：等待安装完成

安装过程会显示进度条，大约需要 2-5 分钟。

看到类似以下提示，说明成功：

added 1package in 2m

步骤 5：验证安装

输入以下命令：

openclaw --version

如果显示版本号（如 2026.3.2），说明安装成功。

第三部分：配置 OpenClaw

步骤 1：运行配置向导

在命令行输入：

openclaw onboard

步骤 2：按提示操作

会出现一系列问题，按以下建议选择：

“I understand this is powerful and inherently risky. Continue?”

选择：Yes（按回车）

“Select mode”

选择：QuickStart（快速开始）

“Select Model/Auth Provider”

选择：Custom Provider（自定义）
或者选择：Qwen（通义千问，国内可用）

“API Base URL”

如果选 Custom Provider，输入：https://dashscope.aliyuncs.com/compatible-mode/v1
如果选 Qwen，跳过

“API Key”

输入之前获取的阿里云百炼 API Key
粘贴后按回车

“Model ID”

输入：qwen-plus（通义千问，性价比高）

“Configure channels?”

选择：Skip for now（暂时跳过）

“Install Skills?”

选择：Yes（安装基础技能）

“Enable Memory?”

选择：Yes（启用记忆功能）

步骤 3：启动 OpenClaw

配置完成后，输入：

openclaw gateway start

步骤 4：打开控制面板

在浏览器中访问：

http://127.0.0.1:18789

如果能看到 OpenClaw 的界面，说明安装成功！

四、安装失败自检表

如果遇到问题，请按以下顺序检查：

问题	可能原因	解决方法
npm 不是内部命令	Node.js 没装好或没重启	重新安装 Node.js，可能要重启电脑
下载速度极慢	网络问题	运行 npm config set registry https://registry.npmmirror.com
权限不足（Mac）	系统权限限制	使用 sudo npm install -g openclaw@latest
PowerShell 无法运行脚本（Windows）	脚本执行策略限制	以管理员身份运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
打不开控制面板	OpenClaw 服务没启动	运行 openclaw gateway start
API Key 连接失败	Key 无效或没额度	检查 Key 是否复制完整，登录阿里云确认有额度

五、安装成功后做什么？

恭喜！你已经成功安装 OpenClaw。接下来：

在控制面板中测试对话

访问 http://127.0.0.1:18789
在对话框中输入：“你好，请介绍一下你自己”

接入聊天软件（可选）

可以接入飞书、钉钉、Telegram、QQ、企微等
在控制面板中配置

安装更多技能

在对话框中说：“请帮我安装 XLSX 技能”
AI 会自动帮你安装

开始使用

试着让它帮你做事：
“帮我整理桌面文件”
“搜索最新的 AI 新闻”（需要配置 Barve Search Key）
“写一封邮件给张三”

六、常见问题：权限与防火墙

6.1 安装时的权限问题

Windows 用户：PowerShell 权限解锁

问题：运行安装命令时提示”无法运行脚本”或”权限被拒绝”。

原因：Windows 默认禁止运行 PowerShell 脚本，这是系统安全保护机制。

解决方法：

按 Win + X，选择”Windows PowerShell（管理员）“或”终端（管理员）”
输入以下命令：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

提示确认时，输入 Y 并按回车
关闭 PowerShell，重新打开一个普通窗口，继续安装

💡 说明：这个命令只允许运行本地脚本和签名过的远程脚本，不会影响系统安全。

Mac 用户：sudo 权限使用

问题：安装时提示”Permission denied”或”权限不足”。

原因：Mac 系统保护全局安装目录，需要管理员权限。

解决方法：

在命令前加 sudo：

sudo npm install -g openclaw@latest

输入密码（密码不会显示），按回车确认。

⚠️ 注意：使用 sudo 后，确保你信任要安装的软件。本文推荐的官方安装是安全的。

6.2 防火墙问题

问题：安装完成后，无法访问控制面板（http://127.0.0.1:18789）。

原因：Windows 防火墙或 Mac 防火墙可能阻止了 OpenClaw 的网络访问。

Windows 防火墙配置

方法一：手动放行（推荐）

按 Win + S，搜索”防火墙”
打开”Windows Defender 防火墙”
点击左侧”高级设置”
点击”入站规则” → “新建规则”
选择”端口” → 下一步
选择”TCP”，在”特定本地端口”输入：18789
选择”允许连接” → 下一步
三个网络类型都勾选 → 下一步
名称填写：OpenClaw Gateway → 完成

方法二：临时关闭防火墙（仅测试用）

按 Win + S，搜索”防火墙”
打开”Windows Defender 防火墙”
点击左侧”启用或关闭 Windows Defender 防火墙”
临时关闭专用网络防火墙
测试访问 http://127.0.0.1:18789
测试完成后立即重新开启防火墙

⚠️ 警告：不要长期关闭防火墙，这会让你的电脑暴露在风险中。

Mac 防火墙配置

打开”系统设置” → “网络” → “防火墙”
点击”选项”
点击”+“添加应用
找到 OpenClaw（通常在 /usr/local/bin/openclaw）
选择”允许传入连接”
点击”好”保存

6.3 安全使用建议（重要！）

OpenClaw 拥有操作你电脑的权限，正确配置可以避免误操作。以下是给零基础用户的安全建议：

⚠️ 高风险操作（默认禁止）

以下操作强烈建议不要开放给 OpenClaw，除非你完全理解后果，你可以将以下禁止动作告诉OpenClaw，加入到他的长期记忆中：

操作类型	风险等级	建议
删除整个文件夹	🔴 极高	禁止（如 rm -rf、del /F /S）
格式化磁盘	🔴 极高	禁止
修改系统文件	🔴 极高	禁止
安装未知来源软件	🔴 高	禁止
执行管理员命令	🔴 高	禁止（如 sudo、管理员权限）
访问敏感目录	🟡 中	限制（如银行软件目录、密码管理器）

✅ 安全配置方法

方法一：设置工作区白名单（推荐）

在 OpenClaw 配置文件中，限制它只能操作特定目录：

打开配置文件：

Windows: C:\Users\你的用户名\.openclaw\openclaw.json
Mac: ~/.openclaw/openclaw.json

添加或修改以下配置：

{"workspace": {"allowPaths": ["~/Documents/OpenClaw","~/Desktop/OpenClaw"    ],"denyPaths": ["~/Documents/重要文件","~/Pictures/家庭照片","/System","/Windows"    ]  }}

保存文件，重启 OpenClaw：

openclaw gateway restart

💡 说明：这样配置后，OpenClaw 只能在你允许的目录内操作文件，不会误删重要数据。

方法二：启用操作确认

让 OpenClaw 在执行高风险操作前先询问你：

在控制面板中，打开”设置” → “安全”
启用”执行前确认”选项
设置确认级别为”高”

这样，当 OpenClaw 要删除文件、修改配置时，会先弹窗让你确认。

方法三：使用”沙盒模式”（最安全）

如果你非常担心安全问题，可以在虚拟机或沙盒中运行 OpenClaw：

Windows：使用 Windows Sandbox（专业版自带）
Mac：使用 Parallels Desktop 或 VMware Fusion
通用：使用 Docker 容器运行

💡 优点：即使 OpenClaw 误操作，也不会影响你的主力系统。缺点：无法操作你真实的文件和软件。

📋 安全检查清单

安装完成后，建议按以下清单检查：

1、已配置防火墙规则

2、已设置工作区白名单

3、已启用操作确认

4、已备份重要数据

5、已在备用目录测试过基本功能

6、已阅读官方安全文档

七、需要帮助？

如果遇到问题：

让 AI 帮你：在 AI 编程工具中描述问题
查看官方文档：https://docs.openclaw.ai
加入中文社区：Telegram 搜索”OpenClaw 中文社区”
联系作者：扫描下方二维码加入交流群

八、加入交流群

如果你在安装或使用过程中遇到问题，或者想和其他用户交流经验，欢迎加入 OpenClaw 零基础交流群！

群规：

✅ 欢迎提问、分享经验、交流心得

❌ 禁止广告、刷屏、人身攻击

🤝 互帮互助，大佬请多关照小白

💡 提示：如果二维码失效，请私信作者获取最新入群方式。

九、写在最后：安全第一，循序渐进

OpenClaw 是一个强大的工具，但强大的能力意味着需要谨慎使用。

作为零基础用户，建议你：

先在备用电脑上安装，熟悉后再在主力机上使用
从简单任务开始，如整理文件、搜索信息，不要一开始就让它执行复杂操作
定期备份重要数据，避免意外损失
遇到问题先查文档，不要盲目操作
加入交流群，和其他用户交流经验

记住：AI 是为你服务的工具，你才是它的主人。

祝你安装顺利，使用愉快！ 🦞

往期回顾

📌 全网都在“养龙虾”：OpenClaw 为什么突然爆了？