# OpenClaw安装教程（多方式详细指南）

OpenClaw作为开源AI助手工具，支持多平台部署，以下整理4种主流安装方式，步骤精简、重点突出，适配不同技术场景，兼顾新手入门与进阶需求，全程规避冗余操作，聚焦可落地执行步骤。
## 一、安装前核心准备（必做）

无论哪种安装方式，需先完成基础环境校验与准备，避免安装失败。
1.  系统要求：Windows 10+/macOS 10.15+/Linux（Ubuntu/Debian推荐），内存≥4GB，可用磁盘≥1GB。
2.  核心依赖：Node.js（推荐v22.14+或v24版本），部分方式需Git、Docker（按需准备）。
3.  权限要求：Windows需PowerShell管理员权限，Linux/macOS需sudo权限，确保命令可正常执行。
4.  依赖校验：终端输入`node -v`，输出版本号即完成依赖校验，无版本则需先安装Node.js。
## 二、四种安装方式详细步骤（按需选择）

### 方式一：官方脚本安装（推荐，新手首选）

优势：自动检测系统环境、安装依赖，无需手动配置，3-5分钟完成，适配全平台。
1.  macOS/Linux系统（终端操作）：
输入命令：`curl -fsSL https://openclaw.ai/install.sh | bash`，回车后等待自动安装。
2.  Windows系统（PowerShell管理员模式）：
输入命令：`iwr -useb https://openclaw.ai/install.ps1 | iex`，全程自动完成依赖检测与安装。
3.  安装验证：输入`openclaw --version`，输出版本号即安装成功。
### 方式二：npm安装（全平台通用，灵活度高）

优势：可自主控制版本，适合有Node.js基础的用户，适配各类系统。
1.  （可选）切换国内源，提升安装速度：
`npm config set registry https://registry.npmmirror.com`
2.  全局安装OpenClaw：
`npm install -g openclaw@latest`
3.  补充依赖安装：`openclaw install`，等待依赖下载完成。
4.  验证：`openclaw --version`，显示版本信息即成功。
### 方式三：源码安装（进阶用户，可自定义配置）

优势：可修改源码、自定义配置，适合需要二次开发或深度优化的场景。
1.  克隆源码仓库（需安装Git）：
`git clone https://github.com/openclaw/openclaw.git`
2.  进入源码目录：`cd openclaw`
3.  安装依赖：`npm install`
4.  构建项目：`npm run build`
5.  验证：`openclaw --version`，正常输出版本即完成安装。
### 方式四：Docker安装（隔离环境，避免依赖冲突）

优势：环境隔离，不影响本地系统配置，适合多工具并行部署的场景。
1.  前提：已安装Docker，输入`docker --version`校验是否可用。
2.  克隆源码仓库：`git clone https://github.com/openclaw/openclaw.git`
3.  进入目录并执行构建脚本：
`cd openclaw`
`./docker-setup.sh`
4.  配置向导：按提示选择QuickStart（快速配置），后续按指引完成模型配置即可。
5.  验证：输入`docker ps`，查看OpenClaw容器正在运行即成功。
## 三、安装后基础配置（必做）

安装完成后，需简单配置模型API Key，确保工具正常使用。
1.  启动配置向导：`openclaw config`，打开配置文件。
2.  配置API Key：根据选用的模型（如DeepSeek、Moonshot），将获取的API Key填入配置文件对应位置。
3.  启动服务：`openclaw gateway start`，提示“Gateway started”即配置完成。
## 四、高频安装问题解决方案

聚焦安装过程中最常见的5类报错，提供精准解决方案，避免无效排查。
1.  npm安装报错：网络问题导致，执行`npm cache clean --force`，切换国内源后重新安装。
2.  端口占用：默认3737/18789端口被占用，执行`openclaw gateway start --port 8080`，指定新端口。
3.  API调用失败：检查API Key是否正确、是否有可用额度，验证网络连通性。
4.  macOS提示“未验证开发者”：执行`sudo xattr -cr /usr/local/bin/openclaw`，允许运行。
5.  终端找不到openclaw：检查Node.js全局目录是否在PATH中，添加后重启终端即可。

OpenClaw作为开源AI助手工具，支持多平台部署，以下整理4种主流安装方式，步骤精简、重点突出，适配不同技术场景，兼顾新手入门与进阶需求，全程规避冗余操作，聚焦可落地执行步骤。

OpenClaw安装教程（多方式详细指南）

人工智能

开发工具

OpenClaw开源AI助手多平台安装指南，提供4种详细安装方式：官方脚本（新手首选）、npm安装（灵活通用）、源码安装（进阶定制）、Docker安装（环境隔离）。涵盖Windows/macOS/Linux系统，包含依赖检查、安装验证及常见问题解决方案，5分钟快速部署AI助手工具。

Windows

容器

Docker

Ubuntu

Debian

Linux

2026采购季 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenClaw安装教程（多方式详细指南）-腾讯云开发者社区-腾讯云

OpenClaw安装教程（多方式详细指南）

OpenClaw安装教程（多方式详细指南）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐