最近 OpenClaw 爆火，但很多人卡在部署阶段。不是教程太简略，就是环境依赖问题莫名其妙，好不容易部署成功又不知道下一步该干什么。
我自己在部署过程中也踩了很多坑，从 Node.js 版本不兼容，到 Telegram Bot 配置失败，再到 Skill 安装不上。所以这篇保姆级教程，就是为了帮你避开这些常见坑，让你不管是小白还是开发者，都能顺利把 OpenClaw 跑起来。
| 方式 | 操作难度 | 适合人群 | 优势 | 劣势 |
|---|
| 一键脚本安装 | ⭐ | 所有新手，尤其是不想折腾的用户 | 傻瓜式操作，环境自动检测安装 | 灵活性低，无法深度定制 |
| Docker 容器化部署 | ⭐⭐ | 运维人员，追求隔离性和可移植性 | 环境隔离，配置统一 | 依赖 Docker 生态 |
| npm 手动安装 | ⭐⭐⭐ | 开发者，需要深度定制和调试 | 灵活性高，便于二次开发 | 需要手动处理依赖和版本 |
node --version # 应显示 v22.x.x
npm --version # 应显示 v10.x.x
访问 Node.js 官网，下载 macOS 安装包
打开安装包，按照指引完成安装
打开终端（Spotlight 搜索 Terminal），检查版本：
node -v # 应显示 v22.x.x
npm -v # 应显示 v10.x.x
使用 nvm 安装（推荐，方便版本管理）
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载终端
source ~/.bashrc # 或 ~/.zshrc
# 安装 Node.js 22
nvm install 22
nvm use 22
# 检查版本
node --version
npm --version
版本检查成功示例：
方案一：一键脚本安装（推荐小白）
适合人群
完全的技术小白（只会用鼠标，没碰过终端）
只想快速体验 OpenClaw 的用户
不想花时间在环境配置上的人
安装步骤
1. 打开终端
2. 执行一键安装命令
# Windows（PowerShell）
Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://openclaw.ai/install.ps1'))
# macOS/Linux
curl -fsSL https://openclaw.ai/install.sh | bash
脚本执行完后，会自动启动 openclaw onboard 配置流程：
✅ 欢迎使用 OpenClaw 初始化向导！
1. 请选择要使用的 AI 模型：
1) Claude (Anthropic)
2) GPT (OpenAI)
3) 豆包 (字节跳动)
4) GLM (智谱AI)
5) 本地模型 (Ollama)
2. 请输入 API Key（本地模型跳过此步）：
请输入：sk-xxxxxx
3. 请选择要连接的通讯渠道：
1) Telegram
2) WhatsApp
3) Discord
4) 飞书
5) 微信
4. 请选择安装核心 Skills：
✅ Web Search (网页搜索)
✅ Email Manager (邮件管理)
✅ Calendar (日历管理)
✅ File Organizer (文件管理)
配置完成后，通过 Telegram 给 OpenClaw Bot 发消息：
帮我生成一个简单的 JavaScript 代码示例
如果回复了代码，说明部署成功！
Error: failed to download installation script
解决方案：
解决方案：
运维人员
需要多环境隔离的团队
追求可移植性的用户
希望版本统一管理的场景
彻底的环境隔离，不影响主机系统
配置统一，多人协作更一致
便于迁移和部署到不同环境
资源管理更精细
访问 Docker 官网
下载 Windows 版本安装包（需开启 WSL2 功能）
安装完成后，启动 Docker Desktop，确保 Docker Engine 运行中
访问 Docker 官网
下载 macOS 版本安装包（Intel/M1/M2 需对应下载）
打开 Docker Desktop，配置资源限制
# 卸载旧版本
for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove $pkg; done
# 设置仓库
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyringscurl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo \
"deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
"$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 安装 Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# 验证安装是否成功
sudo docker run hello-world
# 拉取最新稳定版镜像
docker pull openclaw/openclaw:latest
# 查看已拉取的镜像
docker images
# 创建 Docker 网络（可选，但方便后续技能部署）
docker network create openclaw-net
# 运行 OpenClaw 容器
docker run -d \
--name openclaw \
--network openclaw-net \
-p 18789:18789 \
-v /path/to/openclaw/data:/data \
-e OPENCLAW_MODEL="claude" \
-e OPENCLAW_API_KEY="sk-xxxxxx" \
openclaw/openclaw:latest
参数说明：
--name openclaw：为容器命名
--network openclaw-net：连接到创建的网络
-p 18789:18789：映射端口，可通过 http://localhost:18789 访问
-v /path/to/openclaw/data:/data：挂载数据卷，持久化存储配置和记忆
-e OPENCLAW_MODEL：指定使用的 AI 模型
-e OPENCLAW_API_KEY：设置 API Key
# 进入容器
docker exec -it openclaw bash
# 运行初始化配置
openclaw onboard
# 退出容器
exit
进入 Telegram，搜索 @BotFather
发送 /newbot 命令，按照指引创建新机器人
复制生成的 API Token
配置 OpenClaw 连接 Telegram Bot
# 在容器内运行
openclaw config set channel.telegram.token "123456789:xxxxxxxx"openclaw gateway restart
通过 Telegram 给 OpenClaw Bot 发送消息：
如果返回了容器内的文件列表，说明部署成功！
1. 多模型切换配置
# 使用 GPT 模型docker run -d \
--name openclaw-gpt \
-e OPENCLAW_MODEL="gpt" \
-e OPENCLAW_API_KEY="sk-xxxxxx" \
openclaw/openclaw:latest# 使用 GLM 模型docker run -d \
--name openclaw-glm \
-e OPENCLAW_MODEL="glm" \
-e OPENCLAW_API_KEY="glm-xxxxxx" \
openclaw/openclaw:latest
2. 技能与主应用分离部署
# 部署 Email Skill 为独立容器docker run -d \
--name openclaw-email-skill \
--network openclaw-net \
openclaw/skill-email:latest# 部署 Calendar Skill 为独立容器docker run -d \
--name openclaw-calendar-skill \
--network openclaw-net \
openclaw/skill-calendar:latest
软件工程师
需要深度定制的开发者
需要进行二次开发的团队
想深入了解 OpenClaw 内部机制的用户
高度定制化，可根据需求修改配置
便于调试和日志查看
可以自定义技能和插件
灵活调整内存和进程参数
# macOS/Linux
curl -fsSL https://openclaw.ai/install-node-22.sh | bash
# Windows 建议通过官网安装
# 安装最新稳定版
npm install -g openclaw@latest
# 或者安装指定版本
npm install -g openclaw@2026.3.3
# 检查安装是否成功
openclaw --version
# Linux/macOS 终端
echo 'export OPENCLAW_MODEL="claude"' >> ~/.bashrc
echo 'export OPENCLAW_API_KEY="sk-xxxxxx"' >> ~/.bashrc
source ~/.bashrc
# Windows 环境变量设置：
# 控制面板 → 系统 → 高级系统设置 → 环境变量
# 添加变量 OPENCLAW_MODEL 和 OPENCLAW_API_KEY
# 后台运行方式（推荐）
openclaw gateway --daemon
# 前台运行（适合调试）
openclaw gateway start
# 安装 Web Search 技能
openclaw skills install @openclaw/tavily-search
# 安装 Email 管理技能
openclaw skills install @openclaw/email-manager
# 安装 Calendar 技能
openclaw skills install @openclaw/calendar
# 安装 Browser Control 技能
openclaw plugins install @openclaw/browser-control
# 进入 Discord 开发者门户，创建 Bot
# 复制 Bot Token
openclaw config set channel.discord.token "xxxxxx"
openclaw gateway restart
# 查看网关日志
openclaw logs gateway
# 查看技能日志
openclaw logs skill-email-manager
# 重启网关
openclaw gateway restart
# 克隆仓库到本地
git clone
cd openclaw
# 安装依赖
pnpm install
# 启动开发服务器
pnpm dev:gateway
# 创建新的技能模板
npx @openclaw/cli create-skill weather-plugin
# 安装本地技能
openclaw skills install ./weather-plugin
Windows: %APPDATA%/Roaming/openclaw/config.json
macOS: ~/Library/Application Support/openclaw/config.json
Linux: ~/.config/openclaw/config.json
定期备份配置和记忆文件！
便携需求，希望随时部署
低成本方案（用旧手机当服务器）
在无电脑环境下试用
下载并安装 Termux
在 Termux 中执行以下命令：
# 更新软件源
pkg upgrade -y
# 安装 Node.js
pkg install nodejs-lts
# 安装 OpenClaw
npm install -g openclaw@latest
# 运行初始化
openclaw onboard
# 安装技能命令格式
openclaw skills install @openclaw/[skill-name]
# 推荐技能清单
1. web-search（网页搜索）
2. email-manager（邮件管理）
3. calendar（日历管理）
4. file-organizer（文件管理）
5. 浏览器-control（浏览器自动化）
6. github（GitHub 集成）
7. web-scraper（网页爬虫）
8. markdown-editor（Markdown 编辑）
9. code-generator（代码生成）
10. pdf-processor（PDF 处理）
每天下午 6 点，帮我：
1. 读取今天的工作邮件，提取重点内容
2. 生成日报模板，填充内容
3. 发送给我的经理
帮我抓取这个网页的内容：https://example.com/products
提取标题、价格、库存信息，保存为 CSV 文件
帮我测试这个 GitHub 仓库的代码：https://github.com/xxx/xxx
如果测试通过，帮我部署到 VPS
# 开启沙箱模式
openclaw config set security.sandbox true
# 限制危险命令执行
openclaw config set security.blocked-commands "rm -rf,shutdown,format"
# 开启 API Key 轮换
openclaw config set security.rotate-api-key 30d
# 设置技能权限
openclaw config set skill.browser-control.permission "read-only"
每天凌晨 2 点，帮我：
1. 备份配置和记忆文件
2. 清理过期的日志
3. 检查是否有可更新的技能
Error: listen EADDRINUSE: address already in use :::18789
解决方案：
查看哪个进程占用了端口：
# Windowsnetstat -ano | findstr "18789"# macOS/Linuxlsof -i :18789
杀死占用端口的进程：
# Windowstaskkill /F /PID <pid># macOS/Linuxkill -9 <pid>
Error: skill not found in ClawHub
解决方案：
检查技能名称是否正确
尝试从 GitHub 安装：
openclaw skills install https://github.com/xxx/skill-xxx
手动安装：下载技能包后，运行 clawhub install xxx.zip
Error: model connection timeout
解决方案：
检查 API Key 是否正确
测试网络连接模型服务：
# 测试 Claude APIcurl https://api.anthropic.com/v1/messages \
-H "Content-Type: application/json" \
-H "x-api-key: sk-xxxxxx" \
-d '{"model": "claude-3-5-sonnet-20260220", "messages": [{"role": "user", "content": "测试"}]}'如果网络不通，尝试更换 DNS 或使用代理
#!/bin/bash# 监控 OpenClaw 运行状态LOG_FILE="/var/log/openclaw-monitor.log"CHECK_INTERVAL=60while true; do
if pgrep -x "openclaw" > /dev/null; then
echo "$(date): OpenClaw 运行正常" >> $LOG_FILE
else
echo "$(date): 警告！OpenClaw 停止运行，正在重启..." >> $LOG_FILE
openclaw gateway restart fi
sleep $CHECK_INTERVALdone
| 场景 | 推荐方案 |
|---|
| 个人试用，快速上手 | 一键脚本安装 |
| 团队协作，环境隔离 | Docker 容器化部署 |
| 深度定制，二次开发 | npm 手动安装 |
| 移动试用，旧手机利用 | Android 移动端部署 |
核心技能安装：安装常用技能，熟悉使用流程
自动化场景探索：从简单的定时任务开始，逐步增加复杂度
二次开发深入：学习技能开发和模型适配
优化性能：调整内存分配和并发设置
社区贡献：提交自己的技能和部署方案
部署 OpenClaw 确实需要一些技术基础，但它是值得的。一旦部署成功，你将拥有一个
真正能"做事"的 AI 助手——它不会只给你答案，而是帮你解决实际问题。
你可以：
用它监控行业信息，汇总新闻
用它处理邮件，自动回复常用问题
用它开发测试，完成从编码到部署的全流程
用它管理生活，处理琐碎事务
这是一个从"指令执行者"到"问题解决者"的转变。
希望这篇保姆级教程能帮你顺利部署 OpenClaw。如果在部署过程中遇到问题，欢迎在评论区交流，我们一起踩坑、一起成长！✨