OpenClaw 是一个本地优先的个人 AI 助手，支持多种通讯渠道（WhatsApp、Telegram、Slack、Discord 等）。本文将详细介绍如何在 Linux 和 Windows 系统上安装 OpenClaw。
- 系统要求
- Linux 系统安装
- Windows 系统安装
- Docker 安装（可选）
- 从源码安装
- 安装后配置
- 常见问题
检查 Node.js 版本：
方法一：官方安装脚本（推荐）
这是最简单、最推荐的安装方式，适用于大多数 Linux 发行版（Ubuntu、Debian、CentOS、Fedora 等）：
安装脚本会自动完成以下操作：
- 检查系统依赖
- 安装或更新 Node.js（如需要）
- 通过 npm 安装 OpenClaw
- 创建必要的目录结构
方法二：使用 npm/pnpm 全局安装
如果你更喜欢使用包管理器手动安装：
使用 npm：
使用 pnpm（推荐，速度更快）：
⚠️注意：不建议使用 Bun 作为 Gateway 运行时，因为存在 WhatsApp/Telegram 兼容性问题。
方法三：Docker 安装
如果你希望使用容器化部署：
更多 Docker 配置选项，请参考 Docker 安装章节。
前提条件
Windows 安装强烈建议通过WSL2（Windows Subsystem for Linux）进行。原生 Windows 支持有限。
安装 WSL2
- 以管理员身份打开 PowerShell
- 运行以下命令安装 WSL2：
- 重启计算机
- 安装 Ubuntu 发行版（或其他 Linux 发行版）
在 WSL2 中安装 OpenClaw
进入 WSL2 环境后，使用与 Linux 相同的安装命令：
PowerShell 直接安装（实验性）
如果你不想使用 WSL2，可以尝试 PowerShell 安装脚本：
⚠️警告：Windows 原生支持不如 WSL2 完善，某些功能可能无法正常工作。
Docker 安装适合以下场景：
- 需要隔离的运行环境
- 在 VPS/云服务器上部署
- 不想在主机上安装 Node.js 依赖
快速开始
脚本执行完成后：
- 访问打开控制面板
- 在设置中输入生成的 Token
使用远程镜像（跳过本地构建）
可用的镜像标签：
- - 最新的稳定版本
- - 最新的开发版本
- - 特定版本号
常用 Docker 命令
适合开发者或需要最新功能的用户。
步骤
开发模式（热重载）
1. 运行安装向导
首次安装后，运行安装向导进行配置：
向导将引导你完成：
- 身份验证配置（OpenAI 或其他模型提供商）
- Gateway 基本设置
- 通讯渠道配置（WhatsApp、Telegram 等）
- 安装系统服务（自动启动）
2. 检查 Gateway 状态
3. 打开控制面板
4. 运行健康检查
命令会：
- 检查配置是否正确
- 迁移旧版本配置
- 检测安全风险（如 DM 策略）
- 修复常见问题
5. 启动/停止 Gateway
Q: 安装时提示权限不足？
Linux/macOS：
Q: Node.js 版本过低？
Q: Windows 上无法使用某些功能？
强烈建议使用 WSL2。WSL2 提供更完整的 Linux 兼容性，是 Windows 上运行 OpenClaw 的推荐方式。
Q: Docker 构建时内存不足？
确保分配至少 2GB 内存给 Docker：
- Docker Desktop：Settings → Resources → Memory
- Linux：确保系统有足够的可用内存
Q: 如何更新 OpenClaw？
推荐方式（重新运行安装脚本）：
使用包管理器：
从源码更新：
Q: 如何切换更新通道？
Q: 安装后 Gateway 无法启动？
- 检查端口是否被占用：
- 查看详细日志：
- 运行诊断工具：
- 官方网站
- 官方文档
- GitHub 仓库
- Discord 社区
对于大多数用户，官方安装脚本是最简单、最可靠的选择。Windows 用户强烈建议使用WSL2环境运行 OpenClaw。
最后更新：2026年3月
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/229957.html