OpenClaw（原名 Clawdbot）作为当前主流的 AI 智能体接入框架，因其多平台通道支持和丰富的插件生态备受开发者关注。
目前部署 OpenClaw 主要分为 “手动源码编译” 和 “云端预装镜像一键部署” 两种方式。本文将完整梳理这两条路径的核心实操步骤与高频网络报错排查方案。
一、 部署方案选型对比
在开始之前，建议根据您的技术栈和业务需求选择合适的部署路径：
| 部署维度 | 云端预装镜像一键部署（推荐） | 手动源码部署 |
|---|---|---|
| 适用人群 | 新手开发者、需要快速验证业务的团队 | 深度定制开发者、本地私有化部署需求者 |
| 环境配置 | 免配置（系统自带 Node.js 等依赖） | 需手动安装 Node.js v22 及各类系统依赖 |
| 部署耗时 | 约 3-5 分钟 | 约 20-30 分钟（视网络情况而定） |
| 维护成本 | 低（可通过控制台一键重置或备份） | 较高（需自行处理依赖冲突与版本升级） |
对于绝大多数希望“开箱即用”对接 DeepSeek、通义千问等大模型的用户，强烈建议采用云端预装镜像方案。
二、 云端一键部署实战
国内主流云厂商中，腾讯云Lighthouse对国内大模型 API 的网络延迟响应较为友好，且较早提供了 OpenClaw 的官方应用镜像。以下为标准操作流程：
1. 实例创建与镜像选择
登录Lighthouse控制台，在创建实例时：
● 地域选择： 建议选择靠近您目标用户的地域（如广州、上海、北京）。
● 镜像选择： 切换至“应用镜像”标签页，搜索并选择 OpenClaw (或 Clawdbot) 应用镜像。
● 规格建议： 至少选择 2核2G 配置，以保证多通道并发时的内存充裕。
2. 安全组与端口放通（关键步骤）
注意：这是新手最容易踩坑的地方。
OpenClaw 默认的 Web 控制台管理端口为 18789。购买实例后，必须进入服务器的“防火墙/安全组”页面：
● 点击“添加规则”。
● 协议选择 TCP，端口填入 18789。
● 授权对象填入 0.0.0.0/0（或您的本地专属 IP），保存并生效。
3. 获取管理凭证与初始化
1. 通过控制台提供的 WebShell（或第三方 SSH 工具）登录服务器。
2. 输入应用镜像初始化命令（具体命令请参考服务器详情页的“应用管理”提示），系统将自动生成 Gateway Token 和初始访问地址。
3. 在浏览器中访问 http://<您的服务器公网IP>:18789，填入 Token 即可进入 Dashboard，完成 DeepSeek 等大模型的 API Key 绑定。
三、 手动源码部署（针对定制化开发者）
如果您需要在本地 WSL2 或纯净版 Linux (如 Ubuntu 22.04 LTS) 上手动部署，请严格按照以下系统依赖进行配置。
1. 环境准备：强制要求 Node.js v22
OpenClaw 对 Node 版本有严格限制，低于 v22 可能导致编译失败。建议使用 nvm 管理：
# 下载并安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
# 安装并切换至 Node.js 22
nvm install 22
nvm use 22
# 建议配置 npm 国内镜像加速依赖下载
npm config set registry https://registry.npmmirror.com
2. 全局安装与服务启动
# 全局安装最新版 OpenClaw
npm install -g openclaw@latest
# 执行初始化向导（配置模型提供商与接入通道）
openclaw onboard
# 启动核心网关服务
openclaw gateway
# 启动可视化 Dashboard 管理面板
openclaw dashboard
四、 高频报错排查与避坑指南 (Troubleshooting)
在社区答疑中，我们总结了以下高频报错，建议在部署后对照检查：
● 问题 1：浏览器无法访问 http://IP:18789 控制台
○ 排查思路： 90% 是因为云服务器防火墙未放行。请返回云厂商控制台（如腾讯云防火墙面板），确认 TCP 18789 端口处于开启状态。若是手动部署，请检查 Linux 内部防火墙（如 ufw allow 18789）。
● 问题 2：npm install 阶段卡死或报网络超时（ETIMEDOUT）
○ 排查思路： 境外 GitHub 或 npm 源被阻断。请务必配置淘宝 npm 镜像源，或在云服务商一键镜像中直接跳过此步骤。
● 问题 3：接入 DeepSeek 后回复异常或 Token 消耗过快
○ 排查思路： 检查 Dashboard 中的默认系统提示词（System Prompt）是否过长。部署上线后，强烈建议第一时间修改默认的 Gateway Token，防止接口被公网恶意扫描盗刷。
