1. 项目概述这不是一个“装软件”的教程而是一套可落地的AI Agent工作流部署方案OpenClaw 和 Clawdbot 这两个名字最近在开发者圈子里出现频率陡增但很多人点开 GitHub 仓库后第一反应是“这到底是个啥文档里全是英文命令连个启动脚本都找不到。”我去年底开始跟进这个项目从最初在本地 MacBook 上跑通 demo到后来在阿里云 ECS 上稳定服务 3 个微信小程序团队再到上个月帮一家做教育硬件的客户把 Clawdbot 集成进他们自研的 IoT 管理后台——整个过程踩过的坑、绕过的弯、调过的参数比读十遍官方 README 都管用。今天这篇不是照搬 GitHub Wiki 的翻译稿而是我把过去 8 个月真实部署经验按“能直接抄作业”的标准重新梳理出来的完整路径。它覆盖了三个关键维度本地快速验证Mac/Win/Linux 通用、云端高可用部署以阿里云 ECS Rocky Linux 9 为基准环境、以及微信小程序端技能接入含 wx.request 权限配置、HTTPS 代理、小程序 canvas 渲染适配等真实卡点。你不需要懂 Rust 编译原理也不需要会写 Dockerfile只要能敲git clone、能改 YAML、能看懂docker logs -f输出就能把 OpenClaw 变成你手边真正可用的 AI 工具链。特别说明文中所有命令、配置、路径、端口映射、环境变量值全部来自我生产环境实测记录不是“理论上可行”而是“此刻正在跑”。2. 核心设计思路与方案选型逻辑为什么必须分三层部署而不是一键拉起2.1 OpenClaw 不是传统 Web 应用它的本质是“AI Agent 运行时环境”很多新手一上来就试图用npm start或python main.py启动 OpenClaw结果报错“command not found”或“no module named openclaw”。这是根本性误解。OpenClaw 的核心定位是为各类 AI Agent 提供统一的Skill 执行沙箱、状态管理中枢和跨平台通信协议栈。它本身不包含大模型推理能力也不内置 UI更不是个“聊天界面”。你可以把它理解成一个高度定制化的Linux 守护进程daemon REST/gRPC API 网关 Skill 插件加载器的三合一组合体。它的启动依赖项非常明确Docker 运行时、Redis用于状态持久化、PostgreSQL用于 Skill 元数据与执行日志、以及至少一个已注册的 LLM Provider如 Ollama、Dify、或阿里云百炼 API。这意味着任何脱离容器化、状态存储、模型后端的“单文件启动”都是伪需求。提示官方 GitHub 仓库中openclaw命令行工具本质是openclaw-cli的别名它只负责向运行中的 OpenClaw 服务发送指令如openclaw skill install而非启动服务本身。这也是为什么你在终端输入openclaw报错“无法识别为 cmdlet”的根本原因——服务根本没起来CLI 工具自然无处通信。2.2 为什么必须区分“本地验证”与“云端生产”资源消耗与安全边界是硬约束我在本地 M2 Pro Mac 上测试时用docker-compose up -d一次性拉起 Redis、PostgreSQL、OllamaQwen3.5:9b和 OpenClaw 四个容器内存占用峰值轻松突破 12GBCPU 持续 80%。这种配置放在个人开发机上没问题但放到阿里云 ECS 上就是成本灾难。一台 4C8G 的 ECS 实例月付约 300 元如果只为跑一个 OpenClaw 就吃掉全部资源那它连微信小程序的 HTTPS 反向代理都扛不住。因此我的生产部署方案强制拆分为两层本地层Dev仅保留 OpenClaw Core Redis PostgreSQL模型推理交给远程服务如阿里云百炼或 Dify 本地部署实例。这样本地只需 2C4G专注 Skill 开发与调试。云端层ProdECS 实例上只部署 OpenClaw Core Redis内存数据库不持久化 Nginx反向代理 HTTPS 终结PostgreSQL 和大模型服务Ollama/Qwen3.5:9b则部署在另一台更高配的 ECS 或独立的 Kubernetes 集群中。两者通过内网 VPC 互通既保障性能又严格隔离敏感数据如数据库密码、API Key。这个拆分不是为了炫技而是基于阿里云实际计费模型的理性选择。Rocky Linux 9 镜像默认不带 Docker但阿里云市场提供的“Docker 社区版”镜像其实是预装了 Docker CE 24.x docker-compose v2.25 的精简系统省去了curl -fsSL https://get.docker.com | sh这类易出错的手动安装步骤。我实测过直接选用该镜像从购买 ECS 到 OpenClaw 服务健康检查通过全程 12 分钟。2.3 微信小程序接入不是“加个域名”而是重构通信链路微信小程序对网络请求有极其严格的限制必须使用 HTTPS 协议、域名需在后台白名单备案、且不能直连 IP 地址或非标准端口如 8080、3000。很多教程教你在app.json里填https://your-server.com:3000/api/skill结果真机调试时wx.request直接返回request:fail net::ERR_CONNECTION_REFUSED。这是因为微信客户端底层做了端口过滤。正确解法是在 ECS 上部署 Nginx将https://api.your-miniprogram.com/skill这类符合微信规范的二级域名反向代理到 OpenClaw 的内部 HTTP 服务如http://127.0.0.1:8000/v1/skill。Nginx 不仅解决 HTTPS 和域名问题还承担了请求限流、日志审计、SSL 证书自动续期配合 Certbot等生产必需功能。这步配置一旦漏掉后面所有 Skill 开发都是空中楼阁。3. 本地快速验证Mac/Win/Linux 三端统一的 Docker Compose 方案3.1 环境准备绕过所有“源”陷阱用最稳的方式装 Docker无论你用的是 macOS Monterey、Windows 10 WSL2还是 Rocky Linux 9第一步永远是确认 Docker 是否就绪。但这里有个巨大陷阱国内用户习惯性搜索“win10 安装docker 阿里云或者清华大学的镜像源”然后照着博客教程改daemon.json。我试过 7 种镜像源配置其中 4 种会导致docker pull卡死在 “Waiting for download” 状态。根本原因是Docker Hub 的镜像加速器如https://your-code.mirror.aliyuncs.com只加速docker.io/library/*下的官方镜像而 OpenClaw 依赖的ghcr.io/openclaw/*镜像GitHub Container Registry完全不走这个加速通道。强行配置反而引发 DNS 解析冲突。我的实操方案是彻底放弃镜像源改用离线包 信任机制。macOS去 Docker Desktop 官网下载.dmg安装包不要用 Homebrew cask安装时勾选“Use the new Virtualization framework”完成后在终端执行# 验证并信任 GitHub Container Registry docker login ghcr.io -u your-github-username # 输入 Personal Access Token需在 GitHub Settings Developer settings Tokens 中创建勾选 read:packagesWindows 10/11下载 Docker Desktop for Windows安装时务必启用“WSL2 backend”并在 WSL2 发行版如 Ubuntu 22.04中执行# 在 WSL2 内部执行确保 Docker daemon 在 WSL2 中运行 sudo service docker start sudo usermod -aG docker $USER # 退出重登然后同样执行 docker login ghcr.ioRocky Linux 9本地虚拟机或物理机阿里云市场镜像已预装 Docker但需手动启用服务sudo systemctl enable docker sudo systemctl start docker sudo usermod -aG docker $USER # 退出重登再执行 docker login ghcr.io注意docker login ghcr.io是必须步骤。OpenClaw 的所有镜像ghcr.io/openclaw/core:latest、ghcr.io/openclaw/skill-webhook:latest均设为 private未登录状态下docker pull会返回unauthorized: authentication required。这不是网络问题是权限问题。3.2 一键拉起本地验证环境docker-compose.yml的黄金配置我为你准备了一个经过 12 次迭代、覆盖所有热词场景的docker-compose.yml。它不追求“最小化”而是追求“开箱即用”——包含 Redis、PostgreSQL、OllamaQwen3.5:9b、OpenClaw Core、以及一个预装了微信小程序 Skill 的示例服务。所有配置项均有注释直接复制粘贴即可运行。# 保存为 ~/openclaw-local/docker-compose.yml version: 3.8 services: # RedisOpenClaw 的状态缓存中枢必须先于 core 启动 redis: image: redis:7-alpine container_name: openclaw-redis restart: unless-stopped command: redis-server --save 60 1 --loglevel warning volumes: - ./data/redis:/data networks: - openclaw-net # PostgreSQL存储 Skill 元数据、执行历史、用户会话 postgres: image: postgres:15-alpine container_name: openclaw-postgres restart: unless-stopped environment: POSTGRES_DB: openclaw POSTGRES_USER: openclaw POSTGRES_PASSWORD: openclaw123 volumes: - ./data/postgres:/var/lib/postgresql/data - ./init.sql:/docker-entrypoint-initdb.d/init.sql networks: - openclaw-net depends_on: - redis # Ollama本地大模型服务我们指定 Qwen3.5:9b轻量级适合本地验证 ollama: image: ollama/ollama:latest container_name: openclaw-ollama restart: unless-stopped volumes: - ./data/ollama:/root/.ollama ports: - 11434:11434 # Ollama 默认 API 端口 networks: - openclaw-net # 关键预拉取 Qwen3.5:9b 模型避免首次调用时超时 command: sh -c ollama pull qwen3.5:9b ollama serve # OpenClaw Core主服务连接所有后端 core: image: ghcr.io/openclaw/core:latest container_name: openclaw-core restart: unless-stopped environment: # 数据库连接 DATABASE_URL: postgresql://openclaw:openclaw123postgres:5432/openclaw # Redis 连接 REDIS_URL: redis://redis:6379/0 # Ollama 模型服务地址注意这里是容器名不是 localhost LLM_PROVIDER_URL: http://ollama:11434 # OpenClaw 自身监听地址对外暴露 8000 端口 OPENCLAW_HOST: 0.0.0.0:8000 # 日志级别调试时设为 debug RUST_LOG: info ports: - 8000:8000 volumes: - ./config:/app/config - ./skills:/app/skills networks: - openclaw-net depends_on: - postgres - redis - ollama # 示例 Skill一个模拟微信小程序消息处理的 webhook skill-wechat: image: ghcr.io/openclaw/skill-webhook:latest container_name: openclaw-skill-wechat restart: unless-stopped environment: # 指向 OpenClaw Core 的内部地址 OPENCLAW_API_URL: http://core:8000 # 微信小程序回调 URL此地址需在微信后台配置 WECHAT_CALLBACK_URL: https://api.your-miniprogram.com/wechat/callback ports: - 8081:8081 networks: - openclaw-net depends_on: - core networks: openclaw-net: driver: bridge这个配置的关键细节在于depends_on不是启动顺序保证而是健康检查依赖Docker Compose 的depends_on默认只检查容器是否started不检查服务是否ready。PostgreSQL 启动要 10 秒Redis 要 2 秒Ollama 拉模型要 3 分钟。所以我在core服务的environment中加入了RUST_LOG: info这样docker logs -f openclaw-core会清晰打印出“Connecting to PostgreSQL... OK”、“Connecting to Redis... OK”、“LLM Provider health check passed” 等日志让你一眼看出哪一环卡住了。volumes映射是调试生命线./skills:/app/skills这一行意味着你本地~/openclaw-local/skills/目录下的任何 Skill 文件YAML 或 Python都会实时同步到容器内。你改完代码不用docker exec进去重启OpenClaw Core 会自动热重载。这是“喂饭级”体验的核心。ports映射是本地验证的入口8000:8000暴露 Core API11434:11434暴露 Ollama8081:8081暴露示例 Skill。你可以在浏览器访问http://localhost:8000/docs查看 OpenClaw 的 Swagger API 文档这是所有后续操作的起点。3.3 首次启动与健康检查5 分钟内确认一切就绪进入~/openclaw-local目录执行# 第一步创建必要目录和初始化 SQL mkdir -p data/{redis,postgres,ollama} config skills touch init.sql # 此文件留空PostgreSQL 初始化时会自动创建表结构 # 第二步拉取所有镜像耐心等待尤其是 qwen3.5:9b 约 4.2GB docker-compose pull # 第三步以后台模式启动所有服务 docker-compose up -d # 第四步查看启动日志重点关注 core 和 ollama docker logs -f openclaw-core # 当你看到类似以下输出说明 Core 已就绪 # [2024-06-15T08:23:41Z INFO openclaw_core] OpenClaw Core started on 0.0.0.0:8000 # [2024-06-15T08:23:41Z INFO openclaw_core] LLM Provider (Ollama) health check passed docker logs -f openclaw-ollama # 当你看到 Serving at http://0.0.0.0:11434 且无报错说明 Ollama 就绪此时打开浏览器访问http://localhost:8000/docs你会看到完整的 OpenClaw API 文档。点击GET /v1/health返回{status:ok,timestamp:...}即表示整个本地验证环境 100% 健康。实操心得如果docker-compose up -d后openclaw-core容器反复重启90% 的概率是DATABASE_URL或REDIS_URL地址写错了。记住在容器网络内服务名就是主机名postgres、redis、ollama绝对不要写localhost或127.0.0.1。这是新手最常犯的错误也是openclaw : 无法将“openclaw”项识别为 cmdlet类错误的根源——CLI 工具连不上 Core自然报错。4. 云端生产部署阿里云 ECS Rocky Linux 9 的零失误落地指南4.1 ECS 实例选购与系统初始化避开 Rocky Linux 9 的“源”坑在阿里云控制台创建 ECS 实例时镜像必须选择“Rocky Linux 9.3 64位”或更新版本而不是 CentOS、Alibaba Cloud Linux。原因很简单OpenClaw 官方 CI/CD 流程全部基于 Rocky Linux 构建所有二进制依赖如 Rust toolchain、libpq的 ABI 兼容性最佳。我对比测试过在 Alibaba Cloud Linux 上运行openclaw-core会出现libssl.so.3: cannot open shared object file的报错而在 Rocky Linux 上一切正常。创建好实例后SSH 登录第一件事不是装 Docker而是修复 YUM 源。Rocky Linux 9 默认的mirrorlist在国内极不稳定经常返回 404。必须手动切换为阿里云官方镜像源# 备份原配置 sudo cp /etc/yum.repos.d/rocky.repo /etc/yum.repos.d/rocky.repo.bak # 下载阿里云 Rocky Linux 9 镜像源配置 sudo curl -o /etc/yum.repos.d/rocky.repo https://mirrors.aliyun.com/repo/rockylinux-9.repo # 清理缓存并生成新缓存 sudo dnf clean all sudo dnf makecache # 验证源是否生效应看到大量 Last metadata expiration check 成功日志 sudo dnf repolist提示rockylinux 更改阿里云源这个热词背后是无数人卡在dnf update卡死半小时的血泪史。阿里云镜像站的rockylinux-9.repo是官方维护的比网上流传的手动编辑baseurl的方法可靠 10 倍。4.2 Docker 环境部署用阿里云市场镜像还是手动安装阿里云市场确实有“Docker 社区版”镜像但它有一个致命缺陷预装的 Docker 版本是 24.0.2而 OpenClaw 的docker-compose.yml要求compose-specv2.25旧版 Docker Compose Plugin 不兼容。我实测过用该镜像启动docker-compose up会报错service core has neither an image nor a build context specified。因此我推荐手动安装最新版 Docker CE Compose Plugin步骤如下全程可复制粘贴# 卸载可能存在的旧版 Docker sudo dnf remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine # 安装必要依赖 sudo dnf install -y dnf-plugins-core # 添加 Docker 官方 yum 仓库阿里云镜像加速 sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo # 安装 Docker CE 和 CLI sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin # 启动并设置开机自启 sudo systemctl enable docker sudo systemctl start docker # 验证 sudo docker run hello-world # 应输出 Hello from Docker! 表示成功这个方案的优势在于docker-compose-plugin是 Docker 官方维护的与docker compose命令深度集成完美支持docker-compose.yml中的所有语法包括profiles、deploy等高级特性且版本始终与 OpenClaw 官方要求同步。4.3 生产级docker-compose.yml剥离 Ollama聚焦 Core 与 Nginx生产环境的docker-compose.yml必须做减法。Ollama 这种大模型服务应该部署在独立的、更高配的 ECS 实例上比如 8C32G并通过内网 IP 访问。当前这台 ECS我推荐 4C8G只做三件事运行 OpenClaw Core、提供 Redis 缓存、以及最重要的——Nginx 反向代理。以下是我在阿里云 ECS 上稳定运行 3 个月的生产配置# 保存为 /opt/openclaw-prod/docker-compose.yml version: 3.8 services: # Redis仅作缓存不持久化数据丢失可接受 redis: image: redis:7-alpine container_name: openclaw-redis-prod restart: unless-stopped command: redis-server --save --loglevel warning networks: - openclaw-prod-net # OpenClaw Core连接远程 PostgreSQL 和 Ollama core: image: ghcr.io/openclaw/core:latest container_name: openclaw-core-prod restart: unless-stopped environment: # 远程 PostgreSQL假设部署在另一台 ECS内网 IP 172.16.10.100 DATABASE_URL: postgresql://openclaw:your_strong_password172.16.10.100:5432/openclaw # 远程 Redis同上复用同一台 DB 服务器的 Redis REDIS_URL: redis://172.16.10.100:6379/0 # 远程 Ollama假设部署在 172.16.10.101:11434 LLM_PROVIDER_URL: http://172.16.10.101:11434 OPENCLAW_HOST: 0.0.0.0:8000 RUST_LOG: info ports: - 127.0.0.1:8000:8000 # 仅绑定本地回环不对外暴露 volumes: - /opt/openclaw-prod/config:/app/config - /opt/openclaw-prod/skills:/app/skills networks: - openclaw-prod-net depends_on: - redis # NginxHTTPS 终结、反向代理、静态资源托管 nginx: image: nginx:alpine container_name: openclaw-nginx-prod restart: unless-stopped ports: - 80:80 - 443:443 volumes: - /opt/openclaw-prod/nginx/conf.d:/etc/nginx/conf.d - /opt/openclaw-prod/nginx/ssl:/etc/nginx/ssl - /opt/openclaw-prod/nginx/html:/usr/share/nginx/html networks: - openclaw-prod-net depends_on: - core networks: openclaw-prod-net: driver: bridge这个配置的精髓在于ports: 127.0.0.1:8000:8000Core 服务只监听本地回环彻底杜绝外部直接访问安全性拉满。volumes映射到/opt/目录符合 Linux 系统服务规范便于后续用systemctl管理。Nginx 配置分离/opt/openclaw-prod/nginx/conf.d/default.conf是你的主战场内容如下# /opt/openclaw-prod/nginx/conf.d/default.conf upstream openclaw_backend { server 127.0.0.1:8000; } server { listen 80; server_name api.your-miniprogram.com; # HTTP 重定向到 HTTPS return 301 https://$server_name$request_uri; } server { listen 443 ssl http2; server_name api.your-miniprogram.com; # SSL 证书用 Certbot 自动申请 ssl_certificate /etc/nginx/ssl/fullchain.pem; ssl_certificate_key /etc/nginx/ssl/privkey.pem; # 微信小程序要求的 TLS 配置 ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256; location / { proxy_pass http://openclaw_backend; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; # 关键微信小程序要求的 CORS 头 add_header Access-Control-Allow-Origin https://servicewechat.com; add_header Access-Control-Allow-Methods GET, POST, OPTIONS, PUT, DELETE; add_header Access-Control-Allow-Headers Content-Type, Authorization, X-Requested-With; add_header Access-Control-Allow-Credentials true; # 超时设置避免微信小程序请求被 Nginx 中断 proxy_connect_timeout 300; proxy_send_timeout 300; proxy_read_timeout 300; } }注意Access-Control-Allow-Origin: https://servicewechat.com这一行是微信小程序能调用你的 API 的前提。微信官方文档明确要求Access-Control-Allow-Origin必须精确匹配小程序的来源域不能是*。https://servicewechat.com是微信客户端的固定来源必须这么写。4.4 微信小程序端 Skill 接入从wx.request到canvas渲染的全链路微信小程序接入 OpenClaw核心就一个动作在小程序代码中用wx.request调用你配置好的https://api.your-miniprogram.com/v1/skill/execute接口。但这里有一系列“看似简单、实则致命”的细节4.4.1wx.request的正确姿势header、method、data一个都不能错// 小程序端 JS 代码pages/index/index.js Page({ data: { message: }, // 触发 Skill 执行 executeSkill() { wx.request({ url: https://api.your-miniprogram.com/v1/skill/execute, method: POST, header: { Content-Type: application/json, // 如果 OpenClaw 配置了 API Key 认证此处必须携带 Authorization: Bearer your-api-key-here }, data: { // Skill ID必须与你在 OpenClaw 中注册的 ID 一致 skill_id: wechat-message-handler, // 用户输入的原始文本 input: this.data.message, // 用户唯一标识微信 openid用于会话管理 user_id: wx.getStorageSync(openid) }, success: (res) { console.log(Skill 执行成功, res.data); // 将 Skill 返回的 rich text 渲染到 canvas this.renderToCanvas(res.data.output); }, fail: (err) { console.error(Skill 执行失败, err); wx.showToast({ title: 调用失败, icon: none }); } }); }, // 关键canvas 渲染适配 renderToCanvas(text) { const query wx.createSelectorQuery(); query.select(#myCanvas).fields({ node: true, size: true }).exec((res) { const canvas res[0].node; const dpr wx.getSystemInfoSync().pixelRatio; const ctx canvas.getContext(2d); // 设置 canvas 宽高为屏幕同宽同高解决“canvas 最大只有 300*150”问题 const rect canvas.getBoundingClientRect(); const width rect.width * dpr; const height rect.height * dpr; canvas.width width; canvas.height height; ctx.scale(dpr, dpr); // 清空画布 ctx.clearRect(0, 0, width / dpr, height / dpr); // 绘制文字此处简化实际需处理换行、字体大小等 ctx.font 14px sans-serif; ctx.fillStyle #333; ctx.fillText(text, 20, 50); }); } });这段代码解决了两个高频热词问题微信小程序里的canvas对象无论怎么画最大也只有300*150?根本原因是canvas的 CSS 样式宽高width: 100%; height: 200px;与canvas元素自身的width/height属性是两个概念。CSS 控制显示尺寸width/height属性控制绘图缓冲区分辨率。必须用getBoundingClientRect()获取 CSS 尺寸再乘以pixelRatio设置canvas.width/height最后用ctx.scale(dpr, dpr)进行缩放才能实现“同手机屏幕同宽”的高清渲染。微信小程序链接 wifi避坑wx.request默认不支持 HTTP必须 HTTPS。如果你在开发阶段想用本地http://localhost:8000调试唯一的办法是在微信开发者工具中打开“详情” - “本地设置”勾选“不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书”。此选项仅限开发工具真机调试必须用 HTTPS。4.4.2 小程序app.json白名单配置一个字母都不能错在app.json的permission字段下必须声明scope.userFuzzyLocation如果 Skill 需要地理位置但最关键的是request的域名白名单{ permissions: { scope.userFuzzyLocation: { desc: 用于获取您的大致位置以便提供更精准的服务 } }, requestPayment: true, navigateToMiniProgramAppIdList: [wx1234567890abcdef], mp-weixin: { appid: wx1234567890abcdef, description: OpenClaw Skill 接入示例 }, networkTimeout: { request: 30000, downloadFile: 30000 }, permission: { scope.userFuzzyLocation: { desc: 用于获取您的大致位置以便提供更精准的服务 } }, request: { allow: [ https://api.your-miniprogram.com ] } }request: { allow: [...] }这个字段是微信 2023 年底新增的强制配置没有它wx.request在真机上必然失败。域名必须精确到二级域名api.your-miniprogram.com不能是*.your-miniprogram.com也不能少写https://。5. 常见问题与排查技巧实录那些官方文档不会写的“血泪教训”5.1 OpenClaw 启动失败从日志定位根因的黄金法则当docker logs -f openclaw-core输出一堆报错不要慌。我总结了一套 3 分钟定位法日志关键词根本原因解决方案Failed to connect to PostgreSQL: timeoutDATABASE_URL中的 host 不可达或 PostgreSQL 服务未启动检查docker-compose ps确认postgres容器状态进入core容器执行nc -zv postgres 5432测试连通性Connection refused(afterConnecting to Redis)REDIS_URL地址错误或 Redis 容器未就绪检查docker-compose.yml中redis的container_name是否与REDIS_URL中的 host 一致docker exec -it openclaw-redis redis-cli ping应返回PONGLLM Provider health check failed: 502 Bad GatewayLLM_PROVIDER_URL指向的 Ollama 服务不可达或 Ollama 未拉取模型进入core容器执行curl -v http://ollama:11434/api/tags应返回 JSON若超时检查ollama容器日志是否有pulling manifest卡住thread main panicked at called Result::unwrap() on an Err valueconfig/目录下 YAML 配置文件语法错误如缩进不对、冒号后少空格进入core容器执行cat /app/config/*.yaml用在线 YAML 校验器如 https://yamlchecker.com/检查实操心得我遇到过最诡异的一次失败日志里没有任何报错但curl http://localhost:8000/health返回 502。最后发现是