OpenClaw（龙虾）在宝塔为什么打不开模板示例

引言

OpenClaw（龙虾）在宝塔为什么打不开模板示例 是指中国跨境卖家在使用宝塔面板部署 OpenClaw（一款开源的 Shopify 数据分析与运营工具，GitHub 项目名 openclaw）时，访问其内置模板示例页面（如 /example 或 /templates）失败的现象。宝塔是 Linux 服务器可视化管理面板，OpenClaw 并非官方商业 SaaS，而是开发者社区维护的开源项目，需手动部署；‘打不开模板示例’本质是 Web 服务配置或路径映射问题。

主体

它能解决哪些问题

• 场景化痛点→对应价值：卖家想快速验证 OpenClaw 是否成功接入 Shopify API，但首页可访问、模板页 404 → 通过排查 Nginx 配置与静态资源路径，定位部署完整性问题；
• 场景化痛点→对应价值：团队成员复现他人部署效果失败，无法加载 demo 模板 → 明确宝塔中站点根目录、伪静态规则、PHP/Node.js 运行环境三者匹配逻辑；
• 场景化痛点→对应价值：误将 OpenClaw 当作即装即用 SaaS，未理解其需前端构建步骤 → 区分「源码克隆」与「构建产物部署」两个阶段，避免直接运行未编译的 src/ 目录。

怎么用/怎么开通/怎么选择

OpenClaw 不提供官方托管服务，无“开通”流程，仅支持自建部署。在宝塔中使其模板示例正常访问，需按以下步骤操作（以主流 Node.js + Nginx 方式为例）：

1. 确认服务器已安装 Node.js（≥18.x）及 PM2，宝塔中启用对应运行环境；
2. 通过宝塔终端或 SSH 克隆 OpenClaw 仓库：git clone https://github.com/openclaw/openclaw.git；
3. 进入项目目录执行构建：npm install && npm run build（生成 dist/ 静态文件）；
4. 在宝塔新建站点，根目录指向 openclaw/dist/（非项目根目录）；
5. 在站点设置 → 「网站目录」中关闭「防跨站攻击」，并确保「运行目录」留空或设为 /；
6. 检查站点设置 → 「伪静态」是否误启用了 PHP 规则（如 ThinkPHP/Laravel），应清空或设为「纯静态」。

注：若使用 Docker 部署，需在宝塔中安装 Docker 插件，并按项目 docker-compose.yml 启动，模板路径由容器内 Nginx 配置决定，与宝塔站点设置无关——务必先确认部署方式（原生 Node / Docker / PM2 托管），再匹配排查路径。

费用/成本通常受哪些因素影响

• 服务器配置（CPU/内存）是否满足 OpenClaw 前端构建及 Node.js 运行需求；
• 是否需额外配置 SSL 证书（宝塔免费证书申请成功率受域名 DNS 解析状态影响）；
• 是否启用 CDN 或反向代理，可能干扰 history 路由模式下的模板路径解析；
• Shopify App 的 OAuth 回调域名是否与宝塔绑定域名完全一致（含 www/non-www、HTTP/HTTPS）；
• 是否自行修改了 vue.config.js 中的 publicPath，导致构建后资源路径与 Nginx location 不匹配。

为了拿到准确部署成本，你通常需要准备：服务器系统版本（CentOS 7/8、Ubuntu 22.04）、宝塔版本（如 8.0.5）、OpenClaw GitHub commit hash（或 release tag）、Nginx 版本、以及当前站点配置文件完整内容（/www/server/panel/vhost/nginx/xxx.conf）。

常见坑与避坑清单

• ❌ 误将 npm start 开发服务直接挂载到宝塔站点 → OpenClaw 开发模式依赖 Webpack Dev Server，不可用于生产；必须执行 build 后部署 dist/；
• ❌ 宝塔站点根目录设为项目根目录（含 src/、package.json） → 导致 Nginx 尝试解析 .js 文件为 PHP 或返回 403；应严格指向 dist/；
• ❌ 启用宝塔「强制 HTTPS」但未正确配置证书或未放行 443 端口 → 模板页重定向失败，表现为白屏或无限跳转；
• ❌ 忽略 OpenClaw 的 BASE_URL 环境变量配置 → 若部署在子目录（如 yourdomain.com/claw/），需在 .env 中设 VUE_APP_BASE_URL=/claw/ 并重建。

FAQ

{关键词} 常见失败原因是什么？如何排查？

最常见原因是：① 未执行 npm run build，直接访问源码目录；② 宝塔站点根目录路径错误（指向了项目根而非 dist/）；③ Nginx 配置中存在冲突的 location / { try_files $uri $uri/ /index.html; } 规则被覆盖。排查建议：查看浏览器开发者工具 Network 标签页，确认模板 HTML 请求返回 404 还是 502；登录宝塔终端执行 ls -l /www/wwwroot/your-site/ 核实文件结构；检查 Nginx 错误日志（/www/wwwlogs/nginx_error.log）。

{关键词} 适合哪些卖家/平台/地区/类目？

OpenClaw 本身不绑定特定平台或类目，但因其深度对接 Shopify Admin API，仅适用于已开通 Shopify 商店且拥有 read_products、read_orders 等必要权限的中国跨境卖家；对服务器运维能力有基础要求，适合有技术协同人员（或懂 Linux 命令）的中小卖家；不适用于 Shopify Plus 以外的平台（如 Shopee、TikTok Shop），亦不支持国内微信小程序等非 Shopify 生态。

{关键词} 怎么开通/注册/接入/购买？需要哪些资料？

OpenClaw 是 MIT 协议开源项目，无需注册、购买或授权，不存在官方开通流程。接入前提条件为：① 拥有 Shopify 开发者账号；② 创建 Private App 或 Custom App，获取 API Key、Password、API Version（推荐 2023-10 及以上）；③ 服务器具备 Node.js 运行环境及域名解析能力。所需资料仅包括：Shopify 店铺域名、App 凭据、服务器 SSH 权限、域名 DNS 管理权限。

结尾

OpenClaw 模板打不开不是产品缺陷，而是部署链路中的标准配置问题，按路径、构建、路由三步排查即可解决。