本文为 2026 年 4 月实测版，覆盖Windows、macOS、Linux三大系统，从环境准备、一键安装、初始化配置到服务启动、常见问题，全程无夸大、无违规表述，小白按步骤即可完成本地部署。
一、OpenClaw 简介
OpenClaw（业内昵称 “小龙虾”）是一款轻量化、开源的本地 AI Agent 框架，支持一键部署、多渠道集成（飞书 / 微信 / 钉钉）与 AI 内容生成（漫剧 / 短剧 / 文案）。2026 最新版（v2026.4.0）优化了跨平台兼容性，Windows、macOS、Linux均可一键部署，小白也能快速搭建本地 AI 服务。
二、部署前准备（全平台通用）
2.1 系统与硬件要求
表格
| 操作系统 | Windows 10+/macOS 12+/Ubuntu 22.04+ | 同左 |
| 处理器 | x86_64/Apple Silicon（M1/M2/M3/M4） | 同左 |
| 内存 | ≥4GB | 8GB+，运行更流畅 |
| 存储 | 可用空间≥2GB | 10GB+，预留模型空间 |
| 网络 | 稳定联网 | 带宽≥10Mbps，加速依赖下载 |
| 权限 | Windows 需管理员权限；Mac/Linux 需 sudo 权限 | 同左 |
2.2 工具准备
- Windows：以管理员身份打开 PowerShell（开始菜单搜索 PowerShell，右键选择 “以管理员身份运行”）。
- macOS/Linux：打开终端（macOS：启动台→其他→终端；Linux：Ctrl+Alt+T）。
- 关闭防火墙 / 杀毒软件：避免拦截安装脚本与服务启动。
- 路径规范：后续所有操作路径禁止中文、空格、特殊符号，推荐纯英文路径。
三、一键部署（新手首选，5 分钟搞定）
3.1 Windows 系统部署
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
powershell
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
powershell
openclaw –version
3.2 macOS 系统部署
bash
运行
curl -fsSL https://openclaw.ai/install.sh | bash
bash
运行
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
bash
运行
source ~/.zshrc # Zsh终端（默认）
# source ~/.bash_profile # Bash终端（老版本）
bash
运行
openclaw –version
3.3 Linux 系统部署（以 Ubuntu 为例）
bash
运行
curl -fsSL https://openclaw.ai/install.sh | bash
bash
运行
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
bash
运行
source ~/.bashrc
bash
运行
openclaw –version
四、初始化配置（3 分钟完成）
4.1 启动初始化向导
全平台通用命令，进入文字交互配置界面：
bash
运行
openclaw onboard
4.2 按提示配置（新手直接默认回车）
五、启动服务与访问控制台
5.1 启动网关服务（保持终端运行）
全平台通用命令：
bash
运行
openclaw gateway
终端显示「Gateway started on port 18789」即启动成功。
5.2 访问 Web 控制台
浏览器访问 http://localhost:18789，输入管理员密码即可登录使用。
六、Docker 容器化部署（进阶，环境隔离）
适合多服务并行、生产环境部署，不污染本地系统。
- Windows/macOS：下载
Docker Desktop
File
安装。
- Linux（Ubuntu）：
bash
运行
sudo apt update && sudo apt install docker.io docker-compose -y
sudo systemctl start docker && sudo systemctl enable docker
bash
运行
mkdir openclaw-docker && cd openclaw-docker
yaml
version: '3.8'
services:
openclaw:
image: openclaw/openclaw:latest
container_name: openclaw
ports:
– "18789:18789"
volumes:
– ~/.openclaw:/root/.openclaw # 持久化配置与数据
restart: always # 开机自启
bash
运行
docker compose up -d
bash
运行
docker compose ps
显示Up即为成功，访问http://localhost:18789即可。
七、常见问题解决（全平台通用）
7.1 命令找不到（command not found）
- Windows：关闭并重新打开 PowerShell。
- macOS/Linux：执行以下命令配置环境变量：
bash
运行
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc # macOS
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc # Linux
source ~/.zshrc # macOS
source ~/.bashrc # Linux
7.2 安装超时 / 下载失败
- 切换国内加速脚本（见 3.1/3.2/3.3）。
- 检查网络，或切换手机热点重试。
- 关闭 VPN / 代理。
7.3 端口占用（18789）
- Windows：
powershell
netstat -ano | findstr "18789"
- macOS/Linux：
bash
运行
lsof -i :18789
- 关闭占用程序，或启动时换端口：
bash
运行
openclaw gateway –port 18790
7.4 权限不足
- Windows：以管理员身份运行 PowerShell。
- macOS/Linux：命令前加sudo，如：
bash
运行
sudo openclaw gateway
7.5 服务启动失败
- 检查内存是否充足（推荐 8GB+）。
- 关闭防火墙 / 杀毒软件后重试。
- 查看日志：openclaw logs，定位具体错误。
八、总结与后续
本文覆盖 OpenClaw一键部署、初始化配置、Docker 容器化部署、常见问题全流程，2026 最新版流程极简，小白 10 分钟内可完成本地部署。后续可扩展：
- 配置本地 / 云端 AI 模型（如豆包、GPT、Ollama）。
- 集成飞书 / 微信 / 钉钉等聊天渠道。
- 安装 AI 漫剧 / 短剧 / 文案生成插件。
本文为纯技术分享，无商业推广，所有步骤均为 2026 年 4 月三平台实测有效。
最后再次附上官方部署包下载地址，方便大家自取：OpenClaw Windows 11 一键部署包 v2.3.12
