🦞 OpenClaw 完整安装指南

🦞 OpenClaw 完整安装指南

从零开始部署你的 7×24 小时 AI 助理

前文：最近好忙啊，摸鱼的时候看到openclaw可以部署在自己的电脑上帮我处理文件，想着试一下
（本文含部分AI生成内容）

📋 目录

安装有风险，请在确保自己有熟练操作能力情况下操作！

🖥️ 系统要求

支持的操作系统

系统 版本要求 备注
Windows Windows 10/11 推荐使用 PowerShell
macOS macOS 10.15+ 需要终端权限
Linux Ubuntu/Debian/CentOS 需要 root 或 sudo 权限

硬件要求

  • 内存: 最低 4GB，推荐 8GB+
  • 磁盘: 至少 2GB 可用空间
  • 网络: 稳定的互联网连接

前置依赖

  • Node.js: v18+ (安装脚本会自动检测并提示)
  • Git: 可选，用于高级功能

🪟 Windows 安装

步骤 1：打开管理员 PowerShell

  1. 点击开始菜单，搜索 PowerShell
  2. 右键点击 Windows PowerShell
  3. 选择 以管理员身份运行
  4. 在弹出的 UAC 对话框中点击 是

步骤 2：设置执行策略（首次使用）

如果是首次运行 PowerShell 脚本，需要先授权：

1
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认。

步骤 3：执行安装命令

复制以下命令并粘贴到 PowerShell 窗口中：

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

国内用户如遇网络问题，可使用镜像：

1
iwr -useb https://clawd.cn/install.ps1 | iex

步骤 4：跟随安装向导

安装脚本会自动执行以下操作：

  1. ✅ 检测并安装 Node.js（如未安装）
  2. ✅ 下载最新版 OpenClaw
  3. ✅ 配置环境变量
  4. ✅ 安装依赖包

安装过程中需要选择：

选项 推荐选择 说明
安装类型 QuickStart 快速启动，自动配置
模型供应商 Qwen / Zhipu 国内可用，速度快
安装路径 默认 建议保持默认路径

步骤 5：验证安装

安装完成后，在 PowerShell 中输入：

1
openclaw --version

如果显示版本号（如 2026.3.1-beta.1），说明安装成功！

🍎 macOS 安装

步骤 1：打开终端

  1. 按 Cmd + Space 打开 Spotlight
  2. 搜索 Terminal 或 终端
  3. 点击打开

步骤 2：执行安装命令

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

国内用户可使用镜像：

1
curl -fsSL https://clawd.cn/install.sh | bash

步骤 3：输入密码授权

脚本会提示输入管理员密码，输入后按回车（密码不会显示）。

步骤 4：跟随安装向导

与 Windows 类似，选择：

  • 安装类型：QuickStart
  • 模型供应商：Qwen 或 Zhipu

步骤 5：验证安装

1
openclaw --version

🐧 Linux 安装

步骤 1：打开终端

使用快捷键 Ctrl + Alt + T 或在应用菜单中搜索 Terminal。

步骤 2：执行安装命令

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

或使用 wget：

1
wget -qO- https://openclaw.ai/install.sh | bash

步骤 3：授权执行

如果提示权限不足，使用 sudo：

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

步骤 4：验证安装

1
openclaw --version

⚙️ 初始化配置

首次启动

安装完成后，运行：

1
openclaw

或

1
openclaw gateway start

配置模型 API

  1. 打开配置文件（通常位于 ~/.easyclaw/config.json）
  2. 填入你的 API Key

常用模型配置：

1
2
3
4
5
6
7
{
  "model": {
    "provider": "qwen",
    "apiKey": "your-api-key-here",
    "model": "qwen-plus"
  }
}

国内模型供应商：

供应商 模型 申请地址
通义千问 qwen-plus https://dashscope.console.aliyun.com
智谱 AI glm-4 https://open.bigmodel.cn
月之暗面 moonshot https://platform.moonshot.cn

配置记忆功能（可选）

启用长期记忆，让 AI 记住你的偏好：

1
openclaw memory enable

📱 消息渠道接入

飞书（Feishu）接入

  1. 登录 飞书开放平台
  2. 创建企业自建应用
  3. 获取 App ID 和 App Secret
  4. 配置事件订阅和消息接收地址

配置文件示例：

1
2
3
4
5
6
7
8
9
10
{
  "channels": {
    "feishu": {
      "appId": "cli_xxxxxxxxxxxxx",
      "appSecret": "xxxxxxxxxxxxx",
      "encryptKey": "xxxxxxxxxxxxx",
      "verificationToken": "xxxxxxxxxxxxx"
    }
  }
}

微信（WeChat）接入

  1. 关注 OpenClaw 官方公众号
  2. 获取个人专属接入码
  3. 在配置文件中填入

Telegram 接入

  1. 联系 @BotFather 创建机器人
  2. 获取 Bot Token
  3. 填入配置：
1
2
3
4
5
6
7
{
  "channels": {
    "telegram": {
      "botToken": "1234567890:ABCdefGHIjklMNOpqrsTUVwxyz"
    }
  }
}

WhatsApp 接入

  1. 扫描二维码绑定个人账号
  2. 或使用 WhatsApp Business API

🔧 常见问题

Q1: 安装时提示 Node.js 版本过低

解决方案：

1
2
3
4
5
6
7
# Windows (使用 nvm-windows)
nvm install 20
nvm use 20

# macOS/Linux (使用 nvm)
nvm install 20
nvm use 20

或直接下载最新版：https://nodejs.org

Q2: PowerShell 执行策略错误

错误信息： 无法加载文件，因为在此系统上禁止运行脚本

解决方案：

1
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Q3: 下载速度慢或超时

解决方案： 使用国内镜像

1
2
3
4
5
# Windows
iwr -useb https://clawd.cn/install.ps1 | iex

# macOS/Linux
curl -fsSL https://clawd.cn/install.sh | bash

Q4: 启动后无法访问

检查项：

  1. 确认防火墙未拦截（端口默认 3000）
  2. 检查配置文件中的监听地址
  3. 查看日志：openclaw logs

Q5: 模型 API 调用失败

排查步骤：

  1. 检查 API Key 是否正确
  2. 确认账户余额充足
  3. 检查网络连接
  4. 查看模型服务商状态

📚 后续步骤

安装完成后，你可以：

  1. 📖 阅读 用户文档 了解高级功能
  2. 🎨 配置个性化技能和自动化任务
  3. 🔌 接入更多消息渠道（钉钉、企业微信等）
  4. 🤖 创建自定义 Agent 和工具

🆘 获取帮助

最后更新: 2026-03-11 | 版本: 2026.3.1-beta