OpenClaw教程二:5分钟安装OpenClaw:Windows/Mac/Linux全平台

OpenClaw教程二：5分钟安装OpenClaw：Windows/Mac/Linux全平台安装教程

一、什么是 OpenClaw？

OpenClaw 是一个开源的本地 AI 助手框架，让你能够在自己的电脑上运行 AI，数据完全可控，支持接入多种大模型（DeepSeek、Claude、GPT 等），并提供文件操作、命令执行、浏览器自动化等 25+ 内置工具。

简单来说：它是一个懂你、能帮你干活、而且数据完全私密的本地 AI 助手。

二、痛点引入

想用 AI 助手提高工作效率，但又担心数据隐私泄露？想部署本地 AI，却被复杂的安装步骤劝退？Node.js 版本冲突、Python 依赖报错、配置文件一改就崩……这些坑是不是让你头疼？

别担心！OpenClaw 专为解决这些痛点而生——无论你用 Windows、Mac 还是 Linux，只需 5 分钟（一键脚本安装），跟着本教程一步步操作，就能轻松完成安装，让本地 AI 助手即刻为你工作！

注意：本文介绍的"5 分钟安装"指使用一键安装脚本的时间。如果选择源码安装，预计需要 10-15 分钟。

三、效果预览

安装完成后，你将拥有：

✅ 一个完全运行在本地的 AI 助手
✅ 支持通过终端、微信、Telegram 多渠道对话
✅ 可接入 DeepSeek、Claude 等多种大模型
✅ 自动记忆上下文，越用越懂你

最终效果演示：

# 终端对话示例你: 帮我列出当前目录的所有文件OpenClaw: 正在执行 ls 命令...[文件列表输出]你: 把所有 .txt 文件重命名为 .mdOpenClaw: 好的，我将批量重命名文件...

四、前置准备

⚠️ 重要：Node.js 是必需的

OpenClaw 基于 Node.js 开发，必须先安装 Node.js 18.0 或更高版本。这是最常见的安装失败原因，请务必检查！

# 检查 Node.js 版本node --version# 应该输出 v18.0.0 或更高版本

如果版本过低或未安装，请访问 Node.js 官网下载 LTS 版本（推荐 18.x 或 20.x）。

Mac/Linux 用户也可以使用 nvm 管理 Node.js 版本：

# 安装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash# 安装最新 LTS 版本nvm install --ltsnvm use --lts

各平台系统要求

#### Windows 用户

系统版本
：Windows 10 1903 或更高版本（推荐 Windows 11）
Node.js
：18.0+ （必需！）
终端
：PowerShell 5.1+ 或 Windows Terminal
权限
：管理员权限（安装时需要）

#### Mac 用户

系统版本
：macOS 11 (Big Sur) 或更高版本
Node.js
：18.0+ （必需！）
包管理器
：Homebrew（可选，但推荐）
权限
：sudo 权限（安装时需要）

#### Linux 用户

系统版本
：
Ubuntu 20.04 LTS 或更高版本
Debian 11 或更高版本
CentOS 8 或更高版本
其他主流发行版（Arch、Fedora 等）
Node.js
：18.0+ （必需！）
权限
：sudo 权限（安装时需要）

通用准备

一个大模型 API Key（推荐 DeepSeek，注册送额度）
稳定的网络连接
至少 500MB 可用磁盘空间

五、完整安装步骤

方法一：一键安装脚本（推荐，适合大多数用户）

⏱️ 预计时间：2-5 分钟

#### 🪟 Windows 安装

步骤 1：打开 PowerShell（管理员模式）

右键点击"开始"按钮，选择"Windows PowerShell (管理员)"或"终端(管理员)"

步骤 2：执行一键安装脚本

# 下载并运行安装脚本irm https://install.openclaw.ai/windows.ps1 | iex

步骤 3：等待安装完成

安装脚本会自动完成以下操作：

✅ 检查 Node.js 版本（如果版本过低会提示）
✅ 安装 OpenClaw 核心包
✅ 创建配置目录 ~/.openclaw/
✅ 初始化默认配置文件

大约 2-3 分钟后，看到 "✅ OpenClaw 安装成功！" 提示即完成。

步骤 4：验证安装

openclaw --version# 输出: OpenClaw v1.0.0

#### 🍎 Mac 安装

步骤 1：打开终端

可以通过 Spotlight 搜索"终端"打开。

步骤 2：执行一键安装脚本

# 下载并运行安装脚本curl -fsSL https://install.openclaw.ai/macos.sh | bash

步骤 3：等待安装完成

Mac 的安装过程与 Windows 类似，脚本会自动处理所有依赖。

步骤 4：验证安装

openclaw --version

#### 🐧 Linux 安装

步骤 1：打开终端

步骤 2：执行一键安装脚本

# 下载并运行安装脚本curl -fsSL https://install.openclaw.ai/linux.sh | sudo bash

步骤 3：等待安装完成

Linux 安装可能需要输入 sudo 密码，请输入你的用户密码。

步骤 4：验证安装

openclaw --version

方法二：源码安装（适合开发者）

⏱️ 预计时间：10-15 分钟

如果你想参与 OpenClaw 开发、需要自定义配置，或者一键脚本在 your 系统上不可用，可以使用源码安装方式。

步骤 1：确保已安装 Git

# 检查 Git 是否已安装git --version# 如果未安装，请先安装 Git# Mac: brew install git# Ubuntu/Debian: sudo apt install git# CentOS: sudo yum install git# Windows: https://git-scm.com/download/win

步骤 2：克隆仓库

git clone https://github.com/openclaw-ai/openclaw.gitcd openclaw

步骤 3：安装依赖

npm install

如果遇到权限问题（Mac/Linux）：

sudo npm install

步骤 4：全局链接

npm link# 或者使用 sudo npm link（Mac/Linux）

步骤 5：验证安装

openclaw --version

六、配置大模型 API

⚠️ 重要：安装完成后，必须先配置至少一个大模型 API Key，否则 OpenClaw 无法正常工作！

七、第一次启动

启动 OpenClaw：

openclaw

首次启动会看到：

   ____       __          _ __  / __ \_____/ /_  __  __/ // / /_/ / __  / __ \/ / / / /_/ _, _/ /_/ / /_/ / /_/ / __//_/ |_|\__,_/_.___/\__,_/\__/v1.0.0 - 本地 AI 助手正在加载配置...✓ 配置文件加载成功✓ DeepSeek 模型连接成功✓ Terminal 渠道已就绪你好！我是 OpenClaw，你的本地 AI 助手。有什么我可以帮助你的吗？

如果看到 "模型连接失败" 或 "API Key 无效" 等错误，请检查：

1. API Key 是否正确复制

2. 账户是否有可用额度

3. 网络是否正常

试试第一个命令：

你: 你好OpenClaw: 你好！很高兴为你服务。我可以帮你完成以下任务：  • 文件管理和批量处理  • 命令行操作自动化  • 代码编写和调试  • 文档生成和处理  • 网页数据抓取  • ...请告诉我你需要什么帮助！

八、进阶技巧

技巧 1：配置多个模型备用

在 openclaw.yaml 中配置多个模型，实现主备切换：

models:  # 主模型（DeepSeek，性价比高）  - provider: deepseek    api_key: sk-deepseek-key    model: deepseek-chat    priority: 1  # 备用模型（Claude，能力更强）  - provider: anthropic    api_key: sk-ant-claude-key    model: claude-sonnet-4-6    base_url: https://api.anthropic.com/v1    priority: 2

当主模型不可用时（额度用完、网络问题等），OpenClaw 会自动切换到备用模型。

技巧 2：自定义系统提示词

让 OpenClaw 更符合你的使用习惯：

agent:  system_prompt: |    你是一个专业的前端开发助手，擅长 React、Vue 和 TypeScript。    回答时要简洁明了，代码示例要完整可运行。    当用户提问时，先理解需求，再给出解决方案。

技巧 3：配置日志级别

调试问题时可以开启详细日志：

logging:  level: debug  # debug | info | warn | error  file: ~/.openclaw/logs/openclaw.log

九、常见问题

❓ Q1：安装时报错 "Node.js 版本过低"

原因：OpenClaw 需要 Node.js 18.0 或更高版本。

解决方法：

1. 检查当前版本：node --version

2. 如果版本低于 18.x，访问 Node.js 官网下载 LTS 版本（推荐 18.x 或 20.x）

3. 安装完成后重新执行安装脚本

Mac/Linux 用户也可以使用 nvm 管理 Node.js 版本：

# 安装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash# 安装最新 LTS 版本nvm install --ltsnvm use --lts

❓ Q2：API Key 配置后仍报错 "未授权"或"401 Unauthorized"

可能原因和解决方法：

1. API Key 复制不完整

检查是否复制了完整的 Key（DeepSeek Key 以 sk- 开头）
确认没有多余空格或换行符

2. API Key 已失效

登录 DeepSeek 平台检查 Key 是否有效
尝试创建新的 API Key

3. 账户额度不足

登录 DeepSeek 平台查看余额
充值或领取免费额度

4. 网络问题

检查能否访问 https://api.deepseek.com
如果在中国大陆，通常可以直接访问
如果在其他地区，可能需要配置代理

❓ Q3：启动时提示 "配置文件解析错误"

原因：YAML 格式对缩进非常敏感，常见的错误包括使用 Tab 缩进、冒号后缺少空格等。

解决方法：

1. 检查 YAML 格式：

✅ 使用空格缩进（2 个空格为一层）
❌ 不要使用 Tab
✅ 同级配置项左对齐
✅ 冒号后面要有一个空格

2. 如果仍无法解决，删除配置文件，重新运行 OpenClaw 会自动生成默认配置：

```bash

# Windows PowerShell

Remove-Item $env:USERPROFILE\.openclaw\openclaw.yaml

# Mac/Linux

rm ~/.openclaw/openclaw.yaml

```

3. 使用在线 YAML 验证工具检查格式：YAML Lint

❓ Q4：执行 `openclaw` 命令提示"命令不存在"

Windows：

重新打开 PowerShell/终端
检查环境变量 PATH 是否包含 npm 全局安装路径
尝试重启电脑

Mac/Linux：

# 检查 npm 全局安装路径npm config get prefix# 将路径添加到 PATH（通常是 /usr/local）export PATH=$PATH:$(npm config get prefix)/bin# 永久添加（添加到 ~/.bashrc 或 ~/.zshrc）echo 'export PATH=$PATH:$(npm config get prefix)/bin' >> ~/.bashrcsource ~/.bashrc

❓ Q5：安装脚本下载失败

原因：网络问题或防火墙阻止。

解决方法：

1. 检查网络连接

2. 尝试使用 VPN 或代理

3. 手动下载安装脚本：

```bash

# Windows

Invoke-WebRequest -Uri "https://install.openclaw.ai/windows.ps1" -OutFile "install.ps1"

.\install.ps1

# Mac/Linux

curl -O https://install.openclaw.ai/macos.sh

bash macos.sh

```

十、安装检查清单

完成以下检查，确保安装成功：

[ ] Node.js 版本 18.0+ 已安装
[ ] openclaw --version 能正确输出版本号
[ ] 配置文件 ~/.openclaw/openclaw.yaml 已创建
[ ] API Key 已正确填入配置文件
[ ] 执行 openclaw 能正常启动
[ ] 能与 OpenClaw 进行基本对话

如果所有项都打勾，恭喜你成功安装并启动了 OpenClaw！🎉

十一、下一篇预告

恭喜你成功安装并启动了 OpenClaw！🎉

在下一篇《OpenClaw教程三：配置完全指南：模型接入与多渠道对话》中，你将学习：

📱 如何接入微信、Telegram、Discord 等多种聊天渠道
🤖 配置 Claude、GPT、文心一言等更多大模型
🎨 个性化配置：自定义提示词、工具权限和工作区
🧠 搭建知识库，让 AI 拥有你的专属知识
⚙️ 高级配置：多 Agent 协作、Memory 记忆系统

准备好让你的 AI 助手更强大了吗？敬请期待下一篇！

附录：快速参考

常用命令

# 查看版本openclaw --version# 查看帮助openclaw --help# 检查配置和环境openclaw doctor# 指定配置文件启动openclaw --config /path/to/config.yaml# 查看当前配置openclaw config show# 重置配置openclaw config reset

配置文件位置

| 平台 | 配置文件路径 |

|------|-------------|

| Windows | C:\Users\你的用户名\.openclaw\openclaw.yaml |

| Mac | /Users/你的用户名/.openclaw/openclaw.yaml |

| Linux | /home/你的用户名/.openclaw/openclaw.yaml |

日志文件位置

如果遇到问题，可以查看日志文件：

# Windows PowerShellGet-Content $env:USERPROFILE\.openclaw\logs\openclaw.log -Tail 50# Mac/Linuxtail -50 ~/.openclaw/logs/openclaw.log

卸载 OpenClaw

如果需要卸载：

# Windows PowerShellnpm uninstall -g openclawRemove-Item $env:USERPROFILE\.openclaw -Recurse# Mac/Linuxnpm uninstall -g openclawrm -rf ~/.openclaw

✨ 安装成功后，别忘了加入我们的交流群，与其他 OpenClaw 用户一起分享经验！

📚 相关资源：

官方文档: https://docs.openclaw.ai
GitHub 仓库: https://github.com/openclaw-ai/openclaw
问题反馈: https://github.com/openclaw-ai/openclaw/issues
DeepSeek 注册: https://platform.deepseek.com/

💡 提示：如果安装过程中遇到问题，可以先运行 openclaw doctor 命令进行自检，它会自动诊断常见问题并给出解决建议。

OpenClaw教程二：5分钟安装OpenClaw：Windows/Mac/Linux全平台安装教程

一、什么是 OpenClaw？

二、痛点引入

三、效果预览

四、前置准备

⚠️ 重要：Node.js 是必需的

各平台系统要求

通用准备

五、完整安装步骤

方法一：一键安装脚本（推荐，适合大多数用户）

方法二：源码安装（适合开发者）

六、配置大模型 API

推荐使用 DeepSeek（国产、高性价比）

七、第一次启动

八、进阶技巧

技巧 1：配置多个模型备用

技巧 2：自定义系统提示词

技巧 3：配置日志级别

九、常见问题

❓ Q1：安装时报错 "Node.js 版本过低"

❓ Q2：API Key 配置后仍报错 "未授权"或"401 Unauthorized"

❓ Q3：启动时提示 "配置文件解析错误"

❓ Q4：执行 openclaw 命令提示"命令不存在"

❓ Q5：安装脚本下载失败

十、安装检查清单

十一、下一篇预告

附录：快速参考

常用命令

配置文件位置

日志文件位置

卸载 OpenClaw

❓ Q4：执行 `openclaw` 命令提示"命令不存在"