1. 为什么 OpenClaw 值得用 Docker 跑起来OpenClaw 是一个能真正执行任务的 AI 智能体框架你可以用自然语言让它操作文件、跑自动化流程、接管浏览器、对接多平台消息。它和普通聊天机器人的区别在于它不只是回答而是真的去做。适合谁适合想把 AI 从对话框里拽出来、让它替你干脏活累活的开发者尤其是那些手里有台闲置云服务器或 NAS、想搭个私人数字员工的人。但 OpenClaw 直接裸装到宿主机上麻烦事一堆Node 版本冲突、依赖污染、升级后配置丢失、开机不自启。我试过在本地直接跑结果一次系统升级把依赖全搞乱了重装花了半小时。Docker 容器化部署解决的正是这些环境隔离、数据持久化、一键启停、开机自启还能在个人电脑、云服务器、NAS 之间无缝迁移。这篇内容聚焦一件事把 OpenClaw 用 Docker 完整跑起来并且把模型通道统一接到 TaoToken 上。你会拿到可复制的 Dockerfile 与 docker-compose 骨架、config.toml 配置片段以及容器启动后验证服务连通性的具体命令和排查步骤。全程照着做新手也能跑通。2. 部署前把 TaoToken 通道准备好OpenClaw 本身只是执行壳真正干活的是背后的大模型。默认配置下它要你分别填 OpenAI、Anthropic、DeepSeek 等各家 Key管理起来很碎。TaoToken 的作用是把这些模型通道统一成一个入口一个 Key、一个 API 地址OpenClaw 里只配一次后面换模型不用改代码。你需要先拿到两样东西一个 TaoToken API Key在控制台的 API Keys 页面创建格式类似sk-开头的一串字符。统一的 API 基地址https://taotoken.net/api这个地址在容器里作为base_url使用注意不要带任何多余路径。创建 Key 的入口在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_docker注意Key 只在创建时完整显示一次复制后先存到密码管理器或.env文件里别直接写进会提交到 Git 的配置文件。如果你还没决定用哪个模型可以先去模型对话页面试一下不同模型的响应风格确认哪个适合你的任务场景https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_docker对于长期跑编码类任务或 Agent 工作流的场景Coding Plan 的额度模型更划算后面在 config.toml 里换模型名即可通道不用动https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_docker3. 可复制的 Docker 部署骨架这一节给你两套方案一套是快速体验用的docker run一套是长期跑用的docker-compose.yml。两套都基于官方镜像ghcr.io/openclaw/openclaw:latest别用 Docker Hub 上的同名镜像那些不是官方的功能和安全性都没保证。3.1 环境验证与目录准备先确认 Docker 和 Compose 都在docker -v docker compose version版本要求 Docker 20.10、Compose V2。Linux 服务器上顺手把服务设为开机自启sudo systemctl start docker sudo systemctl enable docker然后建数据目录这个目录会挂进容器存配置、对话记录和日志容器删了数据还在mkdir -p ~/.openclaw mkdir -p ~/openclaw-docker/workspace3.2 快速体验docker run 一行起适合先跑起来看看效果。注意OPENCLAW_SECRET_KEY必须给2026 版缺这个容器会秒退docker run -d \ --name openclaw \ --restart unless-stopped \ -p 18789:18789 \ -v ~/.openclaw:/root/.openclaw \ -v ~/openclaw-docker/workspace:/workspace \ -e OPENCLAW_SECRET_KEY$(openssl rand -hex 16) \ -e OPENCLAW_GATEWAY_PORT18789 \ -e NODE_ENVproduction \ -e TZAsia/Shanghai \ ghcr.io/openclaw/openclaw:latest参数里几个关键点--restart unless-stopped保证异常退出自动拉起、开机自启-p 18789:18789左边是宿主机端口被占用就改成18790:18789两个-v分别挂配置目录和工作目录工作目录是智能体实际操作的沙箱范围。3.3 长期使用docker-compose 骨架生产或长期跑用 Compose 把配置固化下来。先建.envcd ~/openclaw-docker touch .env docker-compose.yml.env内容密钥用openssl rand -hex 16生成后替换OPENCLAW_SECRET_KEY替换成你生成的随机密钥 OPENCLAW_GATEWAY_PORT18789 NODE_ENVproduction TZAsia/Shanghaidocker-compose.yml骨架services: openclaw: image: ghcr.io/openclaw/openclaw:latest container_name: openclaw restart: always ports: - ${OPENCLAW_GATEWAY_PORT}:18789 volumes: - ~/.openclaw:/root/.openclaw - ./workspace:/workspace environment: - OPENCLAW_SECRET_KEY${OPENCLAW_SECRET_KEY} - OPENCLAW_GATEWAY_PORT${OPENCLAW_GATEWAY_PORT} - NODE_ENV${NODE_ENV} - TZ${TZ} healthcheck: test: [CMD, curl, -f, http://localhost:18789/health] interval: 30s timeout: 10s retries: 3 start_period: 20s启动docker compose up -d docker compose ps docker compose logs -f openclaw日志里出现Gateway is running on port 18789就说明服务起来了。3.4 把模型通道写进 config.toml容器起来后OpenClaw 的模型配置在~/.openclaw/config.toml。用 TaoToken 统一通道核心是把base_url指向https://taotoken.net/apiapi_key填你的 TaoToken Key[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model claude-sonnet-4-20250514 max_tokens 8192 temperature 0.7 [gateway] port 18789 bind 0.0.0.0这里provider用openai-compatible是因为 TaoToken 走的是兼容 OpenAI 协议的接口OpenClaw 直接按这个协议发请求即可。model字段换成你想用的模型名换模型只改这一行通道不动。改完配置必须重启容器OpenClaw 不支持热加载docker compose down docker compose up -d4. 验证请求与服务连通性配置写完不代表通了得实际验证。分三层查容器活着、网关响应、模型能回话。4.1 容器与网关健康检查docker ps | grep openclaw curl -s http://127.0.0.1:18789/health/health返回{status:ok}之类的 JSON 就说明网关正常。如果 curl 卡住或拒绝连接先看日志docker logs --tail 100 openclaw4.2 用一次真实请求验证模型通道进容器跑一次 onboard 或直接发一条测试指令docker exec -it openclaw openclaw onboard向导里模型供应商选openai-compatibleBase URL 填https://taotoken.net/apiAPI Key 填 TaoToken Key模型名填你要用的。走完向导后在 WebUI 里输入一句列出 /workspace 下的文件如果它能返回文件列表说明模型通道和执行链路都通了。也可以直接用 curl 从宿主机验证 TaoToken 通道本身curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-20250514,messages:[{role:user,content:ping}]}返回带choices的 JSON说明 Key 和通道没问题问题就缩小到 OpenClaw 容器内部了。4.3 访问 WebUI 确认端到端浏览器打开http://你的服务器IP:18789本地就http://127.0.0.1:18789。登录用初始化时生成的 Token密码留空。进去后发一条指令能正常执行就说明整条链路打通了。5. 本篇常见错误排查5.1 容器秒退日志报 secret key missingOPENCLAW_SECRET_KEY没配或为空。检查.env里这行有没有值别留占位符。另外挂载目录权限也可能导致启动失败sudo chown -R 1000:1000 ~/.openclaw sudo chmod 600 ~/openclaw-docker/.env5.2 镜像拉取超时ghcr.io在国内访问不稳定。配置 Docker 镜像加速或者换一台网络通畅的机器先docker pull再导出导入。别在 Docker 里挂手动代理配置容易把拉取流程搞坏。5.3 端口被占用# Linux netstat -tulpn | grep 18789 # Windows netstat -ano | findstr :18789找到占用进程停掉或者把 compose 里的端口映射改成18790:18789访问时用新端口。5.4 登录后提示 401 或模型未配置三个方向查TaoToken Key 是否复制完整、base_url是否写成https://taotoken.net/api别多加/v1之外的路径、改完 config.toml 是否重启了容器。变量名大小写也要核对api_key不是API_KEY。5.5 远程访问提示 PAIRING_REQUIRED这是设备认证机制。查看待批准请求docker exec -it openclaw openclaw devices list docker exec -it openclaw openclaw devices approve 请求ID如果只是个人内网用也可以关掉设备认证docker exec -it openclaw openclaw config set gateway.controlui.dangerouslyDisableDeviceAuth true docker restart openclaw5.6 改了 config.toml 不生效OpenClaw 不热加载配置。任何 config.toml 或环境变量改动都要docker compose down docker compose up -d或docker restart openclaw。这是最高频的改了没用原因。6. 后续运维与通道管理数据备份就备份~/.openclaw和workspace两个目录前者是配置和对话记录后者是智能体操作的文件。版本更新拉新镜像重启即可docker compose pull docker compose up -d模型通道这块因为统一走了 TaoToken你换模型、调额度、加新模型都只在 TaoToken 控制台操作OpenClaw 的 config.toml 最多改一行model字段。接入文档里有完整的参数说明和兼容模型列表遇到协议细节可以对照查https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_docker如果你打算把 OpenClaw 长期挂在服务器上跑编码或自动化任务Coding Plan 的额度模型比按量计费更省心配置方式不变只是 Key 的计费模式不同https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_docker最后提醒一句workspace目录是智能体能碰到的范围别把整个家目录或生产数据挂进去。给它一个独立沙箱目录出问题最多删掉重建不会波及宿主机其他文件。
