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；
- 执行命令下载安装脚本：
invoke-webrequest-uri"https://get.openclaw.sh/windows"-outfile"install.ps1"- 执行脚本完成安装：
.\install.ps1- 极简一键命令（可直接复制运行）：
iwrhttps://get.openclaw.sh/windows-useb|iex方式3：Chocolatey 包管理器安装
- 若未安装 Chocolatey，先执行以下命令安装包管理器：
set-executionpolicybypass-scopeprocess-force;[system.net.servicepointmanager]::securityprotocol =[system.net.servicepointmanager]::securityprotocol-bor3072;iex((new-objectsystem.net.webclient).downloadstring('https://community.chocolatey.org/install.ps1'))- 安装 openclaw：
choco install openclaw-y- 启动服务：
openclawstart（二）macOS 系统安装
方式1：Homebrew 包管理器（推荐）
- 未安装 Homebrew 时，先执行安装命令：
/bin/bash-c"$(curl-fsSLhttps://raw.githubusercontent.com/homebrew/install/head/install.sh)"- 安装 openclaw：
brewinstallopenclaw- 启动后台服务：
openclaw start方式2：在线脚本安装
- curl 方式：
curl-fsSLhttps://get.openclaw.sh/macos|sh- wget 方式：
wget-qo- https://get.openclaw.sh/macos|sh方式3：Docker 容器安装
- 安装 Docker Desktop：
brewinstall--caskdocker- 拉取官方镜像：
dockerpull openclaw/openclaw:latest- 运行容器（替换
your_key为你的 API 密钥）：
dockerrun-d\--nameopenclaw\-p8080:8080\-eanthropic_api_key=your_key\openclaw/openclaw:latest（三）Linux 系统安装
1. Ubuntu / Debian 系列
- curl 脚本安装：
curl-fsSLhttps://get.openclaw.sh/linux|sh- wget 脚本安装：
wget-qo- https://get.openclaw.sh/linux|sh- 安装完成后启动并设置开机自启：
sudosystemctl start openclawsudosystemctlenableopenclaw2. CentOS / RHEL 系列
- 执行专属安装脚本：
curl-fsSLhttps://get.openclaw.sh/linux-centos|sh- 启动服务并设置开机自启：
sudosystemctl start openclawsudosystemctlenableopenclaw3. 全 Linux 发行版通用（Docker 安装）
- 安装 Docker 环境：
curl-fsSLhttps://get.docker.com|sh- 拉取官方镜像：
dockerpull openclaw/openclaw:latest- 运行容器（持久化数据、自动重启，替换
your_key为对应密钥）：
dockerrun-d\--nameopenclaw\-p8080:8080\-eanthropic_api_key=your_key\-v/opt/openclaw/data:/app/data\--restartunless-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 支持丰富的拓展技能，通过命令行快速安装、管理：
- 闲鱼自动回复：
openclaw skillinstallxianyu-auto-reply- 电商客服：
openclaw skillinstallecommerce-customer-service- Telegram 机器人：
openclaw skillinstalltelegram-bot- 微信机器人：
openclaw skillinstallwechat-bot- 查看已安装的全部技能：
openclaw skill list五、验证安装是否成功
（一）Linux / macOS 系统
- 查看服务运行状态：
systemctl status openclaw- 实时查看运行日志：
journalctl-uopenclaw-f- 检查8080端口占用情况：
netstat-tlnp|grep8080（二）Windows 系统
- 查看系统服务状态：
get-serviceopenclaw- 实时查看运行日志：
get-content"c:\program files\openclaw\logs\openclaw.log"-tail 50-wait（三）API 接口测试
- 对话接口测试：
curl-XPOST http://localhost:8080/api/chat\-H"content-type: application/json"\-d'{ "message": "你好", "session_id": "test" }'- 健康状态检测：
curlhttp://localhost:8080/health（四）WebUI 访问验证
浏览器打开http://localhost:8080，正常显示 openclaw 欢迎界面即代表部署成功。
六、卸载教程
1. Windows 卸载
- 方式1：通过系统控制面板正常卸载程序；
- 方式2：Chocolatey 命令卸载：
choco uninstall openclaw-y- 手动删除残留配置文件：
remove-item-recurse-force c:\program files\openclaw2. macOS 卸载
- Homebrew 卸载主程序：
brew uninstall openclaw- 删除本地配置文件：
rm-rf~/.openclawrm-rf/usr/local/lib/python*/site-packages/openclaw3. Linux 卸载
Ubuntu / Debian
sudosystemctl stop openclawsudosystemctl disable openclawsudoaptremove openclawsudorm-rf/opt/openclawsudorm-rf/etc/openclawCentOS / RHEL
sudosystemctl stop openclawsudosystemctl disable openclawsudoyum remove openclawsudorm-rf/opt/openclawsudorm-rf/etc/openclaw4. Docker 容器卸载
# 停止并删除容器dockerstop openclawdockerrmopenclaw# 删除镜像dockerrmi openclaw/openclaw:latest# 删除数据卷dockervolumermopenclaw-data七、版本更新教程
1. Windows 更新
- Chocolatey 更新：
choco upgrade openclaw-y- 其他方式：下载最新安装包，直接覆盖安装。
2. macOS 更新
brew upgrade openclaw openclaw restart3. Linux 更新
Ubuntu / Debian
sudoaptupdate&&sudoaptupgrade openclawsudosystemctl restart openclawCentOS / RHEL
sudoyum update openclawsudosystemctl restart openclaw4. Docker 版本更新
# 拉取最新镜像dockerpull openclaw/openclaw:latest# 停止并删除旧容器dockerstop openclawdockerrmopenclaw# 启动新版本容器dockerrun-d\--nameopenclaw\-p8080:8080\-eanthropic_api_key=your_key\-v/opt/openclaw/data:/app/data\--restartunless-stopped\openclaw/openclaw:latest八、常见问题及解决方案
1. 安装失败：权限不足
- Linux / macOS：命令前添加
sudo提升权限：sudo ./install.sh - Windows：右键 PowerShell，选择以管理员身份运行。
2. 安装失败：依赖包缺失
执行自动依赖检测与修复命令：
openclaw doctor3. 启动失败：8080 端口被占用
- 修改服务端口：编辑配置文件
nano ~/.openclaw/config.yaml，将port: 8080修改为port: 8081； - 终止占用端口的进程：
lsof-ti:8080|xargskill-94. 启动失败：未配置 API Key
- 查看当前配置：
openclaw config show- 快速设置 API Key：
openclaw configsetanthropic_api_key your_key5. 无法访问页面
- 防火墙拦截（Ubuntu）：开放8080端口
sudoufw allow8080/tcp- 防火墙拦截（CentOS）：永久放行端口
sudofirewall-cmd --add-port=8080/tcp--permanent- 浏览器问题：清除浏览器缓存，或使用无痕模式重新访问。
九、后续拓展使用
部署配置完成后，可根据需求拓展功能：
- 知识库配置：上传FAQ文档、手动添加问答对；
- 技能拓展：安装闲鱼自动回复、电商客服、数据分析等插件；
- 平台接入：对接微信、Telegram、WhatsApp 等第三方平台；
- 自定义开发：编写专属技能、对接自有系统API。
更多高阶玩法可查阅官方完整文档。
总结
openclaw 整体部署门槛极低，不同场景推荐方案如下：
- 新手首选：虾壳云一键部署，全程零配置，一键部署；
- Windows 本地：优先使用安装包或 PowerShell 脚本；
- macOS 本地：优先使用 Homebrew 包管理器；
- Linux 本地：系统脚本或 Docker 容器均可；
- 跨平台通用：全平台均支持 Docker 容器部署。
整体流程：5分钟完成安装，10分钟完成基础配置，即可正式投入使用。
