OpenClaw部署方法

一、本地一键部署（新手首选，Windows/macOS/Linux）

对于初次接触的用户，本地部署能确保完全的环境控制。无论你的操作系统是Windows、macOS还是主流Linux发行版，均可依照下述流程，在十分钟内完成OpenClaw的环境初始化与启动。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

1. Windows（管理员 PowerShell）

在你的Windows设备上，必须使用管理员身份启动Windows PowerShell。随后，复制并粘贴下方的脚本命令，回车执行。安装程序将自动处理所有依赖项与配置。

iwr -useb https://raw.githubusercontent.com/736773174/openclaw-setup-cn/main/install-windows.ps1 | iex

2. macOS/Linux（终端）

macOS或Linux用户，请直接打开系统终端。运行以下curl指令，自动化安装脚本会为你配置好所需的全部基础环境。

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

3. 配置与启动

基础安装完成后，需进行关键账户绑定与初始化。按顺序在终端内执行这三条核心命令：

# 启动配置向导（绑定你的大模型API Key）
openclaw onboard
# 启动本地服务
openclaw gateway start
# 生成访问Token
openclaw token generate

服务成功运行后，请在浏览器中访问 http://localhost:18789。将上一步生成的访问令牌（Token）填入登录框，即可进入你本地的OpenClaw AI助手界面。

二、Docker 部署（最稳定、隔离性好，推荐主力机）

若追求极致的环境隔离与运维便捷性，Docker容器化部署是主力工作站的理想方案。它将服务组件封装于独立的容器内，彻底杜绝依赖冲突，并简化后续的版本管理与迁移流程。

1. 安装 Docker（略，官网一键安装）

此步骤为基础：请访问Docker官方网站，下载适用于你操作系统的安装包并完成安装。安装后，请确保Docker守护进程（Docker Daemon）处于运行状态。

2. 部署 OpenClaw

具备Docker环境后，通过终端执行以下部署序列：

# 克隆仓库
git clone https://gitee.com/openclaw-cn/openclaw.git
cd openclaw
# 复制并编辑配置
cp .env.example .env
nano .env
# 填入 API Key、账号密码
# 一键启动
docker-compose up -d

在编辑.env配置文件时，请准确填入你从供应商处获取的大模型API Key，并设定好后续用于Web界面登录的账户凭证。完成所有配置后，访问 http://localhost:3000 并使用你设定的账号密码登录系统。

三、云端 VPS 部署（7×24 在线，适合长期使用）

为实现不间断的AI助手访问，将其部署于云端VPS是最优解。此方式能提供可靠的在线可用性，无需依赖本地主机的运行状态。

1. 选购云服务器实例：无需过高配置。建议选择Ubuntu 22.04 LTS系统，配备2核CPU与4GB内存的实例，以保证性价比与基础性能。
2. 远程登录并部署：通过SSH客户端连接至你的云服务器，其后完整执行上述「Docker部署」章节中的全部步骤。
3. 配置网络防火墙：至关重要的是，需在云服务商的安全组或服务器的防火墙设置中，启用对3000端口的入站（Inbound）访问规则。
4. 远程访问：部署与网络配置均完成后，即可通过浏览器访问 http://你的服务器公网IP:3000 来远程使用你的OpenClaw服务。

四、部署前准备（必做）

充分的准备工作能大幅提升部署成功率与后续使用体验。请在开始前核查并完成以下事项：

• 获取有效的大模型API密钥：这是驱动OpenClaw的核心资源。建议提前注册并配置好诸如MiniMax、通义千问或Claude等主流平台的有效API Key，并确保账户余额充足。
• 本地部署的硬件基准：Windows/macOS/Linux系统均支持。为保障服务运行流畅，建议本地计算机的可用内存不低于8GB。
• 云端部署的网络考量：若采用VPS方案，为确保远程交互的响应速度，服务器的公网带宽建议不低于2Mbps。

五、常见问题

部署过程中遇到障碍时，首先排查以下高频问题，通常可以快速定位并解决绝大多数状况：

• 安装进程失败：首先验证网络连接是否正常；其次检查执行权限，Windows系统需管理员权限，Linux/macOS系统在必要时请在命令前添加sudo。
• 服务无法访问：服务已启动但浏览器无法连接。请检查本地主机的防火墙设置或云服务器的安全组策略，确认目标端口（18789或3000）已对外开放。
• 模型调用异常：成功登录后AI无响应。这通常由身份验证错误导致。请重点核验配置文件中的API Key是否正确，以及该密钥所对应的模型服务是否可用。