openclaw 一键安装教程（2026年6月15最新）

openclaw 一键安装教程（2026最新）

本篇为2026年最新版 openclaw 一键安装教程，全程仅需5分钟即可完成部署，同时提供 Windows、macOS、Linux 三大主流操作系统的完整一键安装方案，兼顾云端部署与本地部署两种使用场景。

一、在线一键安装（推荐）

虾壳云一键部署（部署速度最快）

该方式无需手动配置环境，是零基础用户的首选方案，操作步骤极简：

访问专属部署地址：https://openclaw.ikidi.top/api/download/package/33?promoCode=IVA4136EC91D，查看 openclaw 专属实例；
点击一键下载安装包，即可启动使用

方案优势

开箱即用，部署完成直接使用；
系统自动完成全部环境配置；
运行性能稳定，配备官方技术支持。

二、本地一键安装

（一）Windows 系统安装

提供三种安装方式，可根据使用习惯选择。

方式1：官方安装包（图形化向导）

访问项目发布页：https://github.com/openclaw/openclaw/releases，下载 openclaw-installer-windows.exe 安装包；
双击运行安装程序，跟随向导逐步操作：
- 自定义安装目录（默认路径：C:\program files\openclaw）；
- 选择需要安装的组件：WebUI、CLI、系统服务；
- 设置管理员登录密码；
安装完成后程序自动启动，浏览器访问 http://localhost:8080 即可进入页面。

方式2：PowerShell 脚本安装

以管理员身份打开 PowerShell；
执行命令下载安装脚本：

powershell 复制代码

invoke-webrequest -uri "https://get.openclaw.sh/windows" -outfile "install.ps1"

执行脚本完成安装：

powershell 复制代码

.\install.ps1

极简一键命令（可直接复制运行）：

powershell 复制代码

iwr https://get.openclaw.sh/windows -useb | iex

方式3：Chocolatey 包管理器安装

若未安装 Chocolatey，先执行以下命令安装包管理器：

powershell 复制代码

set-executionpolicy bypass -scope process -force; [system.net.servicepointmanager]::securityprotocol = [system.net.servicepointmanager]::securityprotocol -bor 3072; iex ((new-object system.net.webclient).downloadstring('https://community.chocolatey.org/install.ps1'))

安装 openclaw：

powershell 复制代码

choco install openclaw -y

启动服务：

powershell 复制代码

openclaw start

（二）macOS 系统安装

方式1：Homebrew 包管理器（推荐）

未安装 Homebrew 时，先执行安装命令：

bash 复制代码

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/homebrew/install/head/install.sh)"

安装 openclaw：

bash 复制代码

brew install openclaw

启动后台服务：

bash 复制代码

openclaw start

方式2：在线脚本安装

curl 方式：

bash 复制代码

curl -fsSL https://get.openclaw.sh/macos | sh

wget 方式：

bash 复制代码

wget -qo - https://get.openclaw.sh/macos | sh

方式3：Docker 容器安装

安装 Docker Desktop：

bash 复制代码

brew install --cask docker

拉取官方镜像：

bash 复制代码

docker pull openclaw/openclaw:latest

运行容器（替换 your_key 为你的 API 密钥）：

bash 复制代码

docker run -d \
--name openclaw \
-p 8080:8080 \
-e anthropic_api_key=your_key \
openclaw/openclaw:latest

（三）Linux 系统安装

1. Ubuntu / Debian 系列

curl 脚本安装：

bash 复制代码

curl -fsSL https://get.openclaw.sh/linux | sh

wget 脚本安装：

bash 复制代码

wget -qo - https://get.openclaw.sh/linux | sh

安装完成后启动并设置开机自启：

bash 复制代码

sudo systemctl start openclaw
sudo systemctl enable openclaw

2. CentOS / RHEL 系列

执行专属安装脚本：

bash 复制代码

curl -fsSL https://get.openclaw.sh/linux-centos | sh

启动服务并设置开机自启：

bash 复制代码

sudo systemctl start openclaw
sudo systemctl enable openclaw

3. 全 Linux 发行版通用（Docker 安装）

安装 Docker 环境：

bash 复制代码

curl -fsSL https://get.docker.com | sh

拉取官方镜像：

bash 复制代码

docker pull openclaw/openclaw:latest

运行容器（持久化数据、自动重启，替换 your_key 为对应密钥）：

bash 复制代码

docker run -d \
--name openclaw \
-p 8080:8080 \
-e anthropic_api_key=your_key \
-v /opt/openclaw/data:/app/data \
--restart unless-stopped \
openclaw/openclaw:latest

三、初始化基础配置

1. 首次访问入口

安装完毕后，通过浏览器访问地址：

本地部署：[http://localhost:8080](https://openclaw.ikidi.top/api/download/package/33?promoCode=IVA4136EC91D)
云服务器部署：[http://你的服务器公网IP:8080](https://openclaw.ikidi.top/api/download/package/33?promoCode=IVA4136EC91D)

2. 初始化向导设置

首次进入页面会自动弹出配置向导，按顺序完成以下设置：

设置管理员登录密码；
选择系统语言（中文 / 英文）；
配置模型 API Key；
选择默认AI模型。

3. API Key 配置教程

方案一：Claude（推荐）

访问 Anthropic 控制台：https://console.anthropic.com/；
注册并登录账号，创建专属 API Key；
复制密钥，在 WebUI 中依次点击：设置 → 模型配置 → anthropic api key，粘贴保存。

方案二：OpenAI

访问 OpenAI 密钥页面：https://platform.openai.com/api-keys；
新建 API Key 并复制；
在 WebUI 中依次点击：设置 → 模型配置 → openai api key，粘贴保存。

四、安装拓展技能

openclaw 支持丰富的拓展技能，通过命令行快速安装、管理：

闲鱼自动回复：

bash 复制代码

openclaw skill install xianyu-auto-reply

电商客服：

bash 复制代码

openclaw skill install ecommerce-customer-service

Telegram 机器人：

bash 复制代码

openclaw skill install telegram-bot

微信机器人：

bash 复制代码

openclaw skill install wechat-bot

查看已安装的全部技能：

bash 复制代码

openclaw skill list

五、验证安装是否成功

（一）Linux / macOS 系统

查看服务运行状态：

bash 复制代码

systemctl status openclaw

实时查看运行日志：

bash 复制代码

journalctl -u openclaw -f

检查8080端口占用情况：

bash 复制代码

netstat -tlnp | grep 8080

（二）Windows 系统

查看系统服务状态：

powershell 复制代码

get-service openclaw

实时查看运行日志：

powershell 复制代码

get-content "c:\program files\openclaw\logs\openclaw.log" -tail 50 -wait

（三）API 接口测试

对话接口测试：

bash 复制代码

curl -X POST http://localhost:8080/api/chat \
-H "content-type: application/json" \
-d '{
"message": "你好",
"session_id": "test"
}'

健康状态检测：

bash 复制代码

curl http://localhost:8080/health

（四）WebUI 访问验证

浏览器打开 http://localhost:8080，正常显示 openclaw 欢迎界面即代表部署成功。

六、卸载教程

1. Windows 卸载

方式1：通过系统控制面板正常卸载程序；
方式2：Chocolatey 命令卸载：

powershell 复制代码

choco uninstall openclaw -y

手动删除残留配置文件：

powershell 复制代码

remove-item -recurse -force c:\program files\openclaw

2. macOS 卸载

Homebrew 卸载主程序：

bash 复制代码

brew uninstall openclaw

删除本地配置文件：

bash 复制代码

rm -rf ~/.openclaw
rm -rf /usr/local/lib/python*/site-packages/openclaw

3. Linux 卸载

Ubuntu / Debian

bash 复制代码

sudo systemctl stop openclaw
sudo systemctl disable openclaw
sudo apt remove openclaw
sudo rm -rf /opt/openclaw
sudo rm -rf /etc/openclaw

CentOS / RHEL

bash 复制代码

sudo systemctl stop openclaw
sudo systemctl disable openclaw
sudo yum remove openclaw
sudo rm -rf /opt/openclaw
sudo rm -rf /etc/openclaw

4. Docker 容器卸载

bash 复制代码

# 停止并删除容器
docker stop openclaw
docker rm openclaw
# 删除镜像
docker rmi openclaw/openclaw:latest
# 删除数据卷
docker volume rm openclaw-data

七、版本更新教程

1. Windows 更新

Chocolatey 更新：

powershell 复制代码

choco upgrade openclaw -y

其他方式：下载最新安装包，直接覆盖安装。

2. macOS 更新

bash 复制代码

brew upgrade openclaw
openclaw restart

3. Linux 更新

Ubuntu / Debian

bash 复制代码

sudo apt update && sudo apt upgrade openclaw
sudo systemctl restart openclaw

CentOS / RHEL

bash 复制代码

sudo yum update openclaw
sudo systemctl restart openclaw

4. Docker 版本更新

bash 复制代码

# 拉取最新镜像
docker pull openclaw/openclaw:latest
# 停止并删除旧容器
docker stop openclaw
docker rm openclaw
# 启动新版本容器
docker run -d \
--name openclaw \
-p 8080:8080 \
-e anthropic_api_key=your_key \
-v /opt/openclaw/data:/app/data \
--restart unless-stopped \
openclaw/openclaw:latest

八、常见问题及解决方案

1. 安装失败：权限不足

Linux / macOS：命令前添加 sudo 提升权限：sudo ./install.sh
Windows：右键 PowerShell，选择以管理员身份运行。

2. 安装失败：依赖包缺失

执行自动依赖检测与修复命令：

bash 复制代码

openclaw doctor

3. 启动失败：8080 端口被占用

修改服务端口：编辑配置文件 nano ~/.openclaw/config.yaml，将 port: 8080 修改为 port: 8081；
终止占用端口的进程：

bash 复制代码

lsof -ti :8080 | xargs kill -9

4. 启动失败：未配置 API Key

查看当前配置：

bash 复制代码

openclaw config show

快速设置 API Key：

bash 复制代码

openclaw config set anthropic_api_key your_key

5. 无法访问页面

防火墙拦截（Ubuntu）：开放8080端口

bash 复制代码

sudo ufw allow 8080/tcp

防火墙拦截（CentOS）：永久放行端口

bash 复制代码

sudo firewall-cmd --add-port=8080/tcp --permanent

浏览器问题：清除浏览器缓存，或使用无痕模式重新访问。

九、后续拓展使用

部署配置完成后，可根据需求拓展功能：

知识库配置：上传FAQ文档、手动添加问答对；
技能拓展：安装闲鱼自动回复、电商客服、数据分析等插件；
平台接入：对接微信、Telegram、WhatsApp 等第三方平台；
自定义开发：编写专属技能、对接自有系统API。

更多高阶玩法可查阅官方完整文档。

总结

openclaw 整体部署门槛极低，不同场景推荐方案如下：

新手首选：虾壳云一键部署，全程零配置，一键部署；
Windows 本地：优先使用安装包或 PowerShell 脚本；
macOS 本地：优先使用 Homebrew 包管理器；
Linux 本地：系统脚本或 Docker 容器均可；
跨平台通用：全平台均支持 Docker 容器部署。

整体流程：5分钟完成安装，10分钟完成基础配置，即可正式投入使用。