1. 从一次容器重启说起OpenClaw 容器化部署到底难在哪OpenClaw 是一个可以自托管的 AI 智能体网关它能用一个 Gateway 把飞书、企业微信、个人微信等消息通道统一接进来再配合技能系统和定时任务让 AI 真正跑在你的服务器上。适合谁适合想 7x24 挂机、又不想把数据交给第三方托管的自托管新手。但很多人第一次容器化部署时卡点不在“装不上”而在“装上了跑不起来”——容器一重启会话丢了Chrome 起不来浏览器自动化直接报错API Key 填了请求却 401。我自己在 2c2g 的机器上反复折腾过几轮最典型的一次是容器重启后 OpenClaw gateway 起来了但浏览器工具一直报SingletonLock相关错误日志里全是Failed to launch chrome。排查半天才发现是上一次容器退出时 Chrome 的锁文件没清理新进程以为已有实例在跑直接拒绝启动。这类坑官方文档不会逐条写只能靠踩。这篇是《永久免费 OpenClaw 部署》的续篇聚焦容器化部署里的典型报错与配置陷阱。我会交付可复制的 Docker Compose 配置、环境变量清单、逐步验证动作并说明怎么把 endpoint 和 Base URL 统一改到 TaoToken 的 API 通道让 Key 管理不再散落各处。全文按“问题场景 → 前置准备 → 可复制配置 → 验证请求 → 错排查 → 通道统一”的顺序展开你可以按需跳读。先说结论容器化部署 OpenClaw 的核心矛盾是状态持久化和进程生命周期。容器本身是无状态的但 OpenClaw 的会话、记忆、浏览器 profile 全都要落盘。你把它们放在容器内重启就丢放在挂载卷里又要处理权限和锁文件。下面一步步来。2. TaoToken 前置把 Key 和 Base URL 收口到统一通道在讲容器配置之前先把 API 通道这件事理清楚。OpenClaw 要调 LLM就得配OPENAI_API_BASE和OPENAI_API_KEY。很多人一开始用某家免费额度跑着跑着限速了又换一家结果配置文件里散落着好几套 Key 和地址排查问题时根本不知道当前生效的是哪个。我的做法是把所有模型请求统一走 TaoToken 的 API 通道。TaoToken 提供兼容 OpenAI 协议的接口Base URL 固定为https://taotoken.net/api你只需要一个 Key就能在多个模型之间切换。这样 OpenClaw 的openclaw.json里只保留一套 endpoint 配置换模型只改 Model ID不动地址。具体怎么拿 Key访问 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册后在控制台创建 API Key。控制台地址是https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keys 管理页在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。创建时建议给 Key 起个能识别的名字比如openclaw-docker方便后面轮换。拿到 Key 后OpenClaw 侧需要配三个东西Base URL、API Key、Model ID。Base URL 填https://taotoken.net/api注意不要带末尾斜杠也不要带/v1——OpenClaw 的 OpenAI 兼容层会自己拼路径。API Key 就是刚才创建的那串。Model ID 填你在 TaoToken 模型列表里看到的名称比如gpt-4o或claude-3-5-sonnet这类。如果你不确定当前有哪些模型可用可以打开模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content先试一条消息确认通道通了再写进配置。这里有个容易忽略的点OpenClaw 的openclaw.json里模型供应商配置和环境变量是两套东西。你可以把apiKey写成${OPENAI_API_KEY}然后在容器的环境变量里注入真实值。这样配置文件可以进 GitKey 不会泄露。下面第 3 节的 Compose 配置里我会把OPENAI_API_BASE和OPENAI_API_KEY都列进 environment 段。如果你后面要跑长期编码或 Agent 任务可以考虑 TaoToken 的 Coding Plan入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。它适合那种需要持续调用、不想每次手动换 Key 的场景。不过对于本文的容器化部署验证先用按量 Key 就够了。3. 可复制配置Docker Compose 环境变量清单这一节是全文的核心直接给你能跑的配置。我假设你已经有一台 Linux 主机装好了 Docker 和 Docker Compose。目录结构建议这样openclaw-docker/ ├── docker-compose.yml ├── .env ├── data/ │ ├── openclaw/ # 挂载到容器 /root/.openclaw │ └── workspace/ # 挂载到容器 /root/.openclaw/workspace └── config/ └── openclaw.json # 挂载到容器 /root/.openclaw/openclaw.json先看docker-compose.yml。这里我用的是官方镜像思路如果你自己构建镜像把image换成你的构建标签即可。version: 3.8 services: openclaw: image: openclaw/gateway:latest container_name: openclaw-gateway restart: unless-stopped ports: - 18789:18789 # Gateway 端口 - 18792:18792 # Browser Relay 端口有头模式才需要 environment: - OPENAI_API_BASEhttps://taotoken.net/api - OPENAI_API_KEY${OPENAI_API_KEY} - OPENCLAW_GATEWAY_TOKEN${OPENCLAW_GATEWAY_TOKEN} - TZAsia/Shanghai volumes: - ./data/openclaw:/root/.openclaw - ./data/workspace:/root/.openclaw/workspace - ./config/openclaw.json:/root/.openclaw/openclaw.json:ro shm_size: 1gb # Chrome 无头模式需要否则容易崩 healthcheck: test: [CMD, curl, -f, http://localhost:18789/health] interval: 30s timeout: 10s retries: 3几个关键点解释一下。shm_size必须给够Chrome 无头模式默认用/dev/shm容器默认只有 64MB页面一复杂就崩报Target closed或Session closed。给 1GB 基本够用。restart: unless-stopped保证宿主机重启后容器自动拉起但注意这也会让“锁文件没清理”的问题在重启后立刻暴露所以第 5 节要专门处理。然后是.env文件不要提交到 GitOPENAI_API_KEYsk-你的TaoTokenKey OPENCLAW_GATEWAY_TOKEN自己生成一串随机字符串OPENCLAW_GATEWAY_TOKEN可以用openssl rand -hex 32生成。这个 token 是节点接入和远程控制用的别用弱口令。接着是config/openclaw.json。这是 OpenClaw 的主配置我挑和容器化最相关的部分{ models: { providers: { openai: { baseUrl: ${OPENAI_API_BASE}, apiKey: ${OPENAI_API_KEY}, model: gpt-4o } } }, browser: { enabled: true, executablePath: /root/.cache/ms-playwright/chromium-1208/chrome-linux64/chrome, headless: true, noSandbox: true, defaultProfile: openclaw }, session: { dmScope: per-channel-peer, maintenance: { mode: enforce, pruneAfter: 30d, resetArchiveRetention: 1d } }, memorySearch: { provider: openai } }注意baseUrl写的是${OPENAI_API_BASE}OpenClaw 启动时会读环境变量替换。executablePath指向 Playwright 装的 Chromium路径里的版本号chromium-1208可能随版本变化你要在容器里ls /root/.cache/ms-playwright/确认一下实际目录名。noSandbox: true在容器里基本是必须的否则 Chrome 会因为权限问题起不来。如果你用 Cline MCP 或 Codex 这类工具连 OpenClaw配置里同样要写全三件套Base URL 填https://taotoken.net/apiKey 填 TaoToken 的 KeyModel ID 填具体模型名。三件套缺一个请求就会 401 或 404。4. 验证请求从容器启动到第一条消息配置写好后按顺序验证别跳步。第一步启动容器docker compose up -d docker compose logs -f openclaw日志里看到Gateway listening on 18789就算起来了。如果卡在Waiting for browser...说明 Chrome 启动有问题先看第 5 节。第二步验证 Gateway 健康检查curl -s http://localhost:18789/health返回{status:ok}即可。如果返回 401说明OPENCLAW_GATEWAY_TOKEN没配对检查.env和容器环境变量是否一致。第三步验证模型通道。OpenClaw 有个命令行可以直接发消息docker exec -it openclaw-gateway openclaw agent --to main --message 你好测试一下如果返回正常文本说明 TaoToken 的 Base URL 和 Key 都生效了。如果报401 Unauthorized去 TaoToken 控制台确认 Key 没过期、额度没用完。如果报model not found检查openclaw.json里的model字段是不是 TaoToken 支持的 Model ID。第四步验证浏览器工具。进容器执行docker exec -it openclaw-gateway openclaw browser open --profile openclaw --url https://example.com docker exec -it openclaw-gateway openclaw browser snapshot --refs aria第二条命令应该返回页面的文本和元素结构。如果报Failed to launch chrome看下一节。第五步验证状态持久化。重启容器docker compose restart重启后再次执行第三步的发消息命令如果之前的会话还在openclaw sessions list能看到说明挂载卷生效了。这一步很多人会漏等到生产环境重启才发现会话全丢。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节对照真实报错逐条给排查路径。第一个401 Unauthorized。最常见的原因是 Key 写错或 Base URL 带了多余路径。检查openclaw.json里baseUrl是不是https://taotoken.net/api不要写成https://taotoken.net/api/v1。另外确认.env里的OPENAI_API_KEY没有引号、没有空格。如果用的是 TaoToken 的 Key去 API Keys 页面确认状态是 active。第二个local proxy failed。这个报错通常出现在容器网络配置有问题时。OpenClaw 内部会起一个本地代理转发请求如果容器 DNS 解析不了taotoken.net就会报这个。排查方法docker exec -it openclaw-gateway curl -v https://taotoken.net/api如果 curl 也失败说明容器网络不通检查宿主机 DNS 和 Docker 的dns配置。如果 curl 通但 OpenClaw 报错检查openclaw.json里有没有多余的proxy字段把它删掉。第三个reading choices相关报错完整信息通常是Cannot read properties of undefined (reading choices)。这是模型返回体不符合预期导致的。原因可能是 Base URL 指向了一个不兼容 OpenAI 协议的端点或者 Model ID 填错导致返回了错误结构。确认 Base URL 是https://taotoken.net/apiModel ID 是 TaoToken 模型列表里的名称。如果还不行用模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content单独测一下这个模型确认通道本身没问题。第四个OAuth 相关报错。如果你在 OpenClaw 里配了需要 OAuth 的通道比如某些企业应用报OAuth token expired或invalid_grant说明 refresh token 失效了。这类问题在容器化场景下更常见因为容器重启后时间戳可能跳变。解决办法是重新走一遍授权流程并把 token 的存储路径也挂载出来别放在容器内。第五个Chrome 锁文件问题。报错长这样Failed to launch chrome: SingletonLock exists。原因是上次容器退出时 Chrome 没正常关闭锁文件残留。解决办法是在容器启动脚本里加一行清理rm -rf /root/.openclaw/browser/openclaw/user-data/Singleton*你可以把这行写进docker-compose.yml的entrypoint覆盖或者写个start.sh在启动 OpenClaw 前执行。我试过在 Compose 里用command覆盖但官方镜像的 entrypoint 会先跑所以更稳的做法是挂载一个自定义脚本进去。第六个pairing required。这是节点接入时的报错说明设备还没配对。去 Gateway 的device/pending.json里找到配对请求批准后移到paired.json。如果你用 CC Switch 或类似工具管理多套配置记得每套配置的 Gateway Token 要一致否则配对会反复失败。6. 语义一致 CTA把通道收口后下一步做什么配置跑通、报错排完你会发现真正省心的地方在于所有模型请求都走同一个 Base URLKey 只有一套换模型只改 Model ID。这就是把 endpoint 收口到 TaoToken 的价值。后面无论你是加新通道、装新技能还是接节点都不用再动 API 配置。如果你还在验证阶段建议先去模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content把要用的模型逐个测一遍确认可用再写进openclaw.json。如果你要长期跑编码或 Agent 任务Coding Plan 入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content适合需要稳定调用的场景。Key 管理在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。Claude Code 相关的 Anthropic 兼容配置参考https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。最后留一个我踩过的坑容器化部署时别把openclaw.json直接写在镜像里。用挂载卷覆盖这样改配置不用重新构建镜像。但挂载时注意文件权限容器内是 root 跑的宿主机上的文件如果属主不对OpenClaw 可能读不了。用chown -R 1000:1000 ./config或者直接在 Compose 里指定user都能解决。跑起来之后先别急着加通道把本文的验证步骤走一遍确认模型、浏览器、持久化三样都正常再往上叠功能。