乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw教程二:5分钟安装OpenClaw:Windows/Mac/Linux全平台

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

当前时间： 2026-08-17 17:24:12 分类：办公文件 评论(0)
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 无法正常工作！

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

DeepSeek 是国内优秀的大模型服务提供商，新用户注册即送免费额度，非常适合测试和学习。

步骤 1：获取 API Key

1. 访问 DeepSeek 开放平台

2. 注册/登录账号（支持微信登录）

3. 进入"API Keys"页面

4. 点击"创建新的 API Key"

5. 复制生成的 Key（格式：sk-xxxxx）

注意：API Key 只显示一次，请妥善保管！

步骤 2：找到并编辑配置文件

OpenClaw 的配置文件位于：

  • Windows
    : C:\Users\你的用户名\.openclaw\openclaw.yaml
  • Mac
    : /Users/你的用户名/.openclaw/openclaw.yaml
  • Linux
    : /home/你的用户名/.openclaw/openclaw.yaml

使用你喜欢的文本编辑器（VS Code、Notepad++、vim 等）打开配置文件。

步骤 3：修改配置文件

将你的 API Key 填入配置文件：

# ~/.openclaw/openclaw.yaml# 大模型配置models:  - provider: deepseek    api_key: sk-your-actual-api-key-here  # 替换为你的真实 API Key    model: deepseek-chat    base_url: https://api.deepseek.com/v1  # DeepSeek API 地址    temperature: 0.7    max_tokens: 4096# 对话渠道配置channels:  - id: terminal    type: terminal    enabled: true# 工具权限配置tools:  - filesystem  - shell  - web

配置说明：

- api_key：必填，你的 DeepSeek API Key

- model：模型名称，deepseek-chat（通用）或 deepseek-coder（编程专用）

- base_url：API 地址，DeepSeek 的固定地址

- temperature：温度参数，0-1，越高越随机

步骤 4：保存配置文件

保存后，OpenClaw 会自动重新加载配置。如果已经在运行，重启 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 命令进行自检，它会自动诊断常见问题并给出解决建议。