1. 為什么要在阿里云 ECS 上用 Docker 跑 OpenClawOpenClaw 是一個開源的 AI 自動化代理平臺它能理解自然語言指令然后在你的服務器上真正執(zhí)行任務讀寫文件、跑腳本、整理目錄、調用外部 API、把結果推回聊天通道。簡單說它把「對話」變成了「行動」適合想搭個人助理、團隊自動化工作流或者做開發(fā)輔助的開發(fā)者。但很多人第一次部署會卡在環(huán)境上。直接在 ECS 宿主機裝 Node.js 22、再裝一堆系統(tǒng)依賴跑起來容易和已有服務搶端口、搶全局包升級 Node 版本還可能把別的項目搞崩。我試過在阿里云 ECS 上把 OpenClaw 容器化用 Docker 封裝運行時再通過 TaoToken 統(tǒng)一 Key 接入模型通道整條鏈路干凈、可復制、可回滾。這篇就聚焦這條鏈路阿里云 ECS Node.js 運行時 Docker 容器化 TaoToken 統(tǒng)一 Key/API 通道。你會拿到可直接復制的 Dockerfile、docker-compose.yml、環(huán)境變量配置以及容器啟動后驗證 API 連通性的具體命令和預期返回。適合已經有一臺 ECS、想用容器方式長期跑 OpenClaw 的人。先說清楚 TaoToken 在這里的角色。它是一個統(tǒng)一的大模型 API 接入層把不同模型的調用收斂成一套 Base URL Key Model ID 的配置方式。OpenClaw 需要調用大模型來理解指令、規(guī)劃動作TaoToken 就是它背后的模型通道。官網(wǎng)入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不帶 UTM 參數(shù)。為什么強調容器化因為 OpenClaw 會執(zhí)行文件操作、跑腳本容器能給它一個隔離的執(zhí)行環(huán)境降低依賴沖突和誤操作風險。同時 Docker 讓「本地能跑、服務器也能跑」變成同一份配置遷移成本幾乎為零。下面從 ECS 準備開始一步步走完。2. 阿里云 ECS 準備與 Node.js 運行時配置在阿里云控制臺創(chuàng)建 ECS 實例時鏡像選 Ubuntu 22.04 LTS 比較省心Docker 和 Node.js 的安裝文檔都全。規(guī)格上 2 核 4G 起步OpenClaw 本身不重但模型請求和文件操作并發(fā)起來內存留點余量更穩(wěn)。安全組先放行 22 端口用于 SSH8080 端口留給 OpenClaw 后臺等確認服務跑起來再決定是否對公網(wǎng)開放。登錄 ECS 后先更新系統(tǒng)包再裝 Node.js 22。這里有個坑Ubuntu 自帶的 apt 源里 Node 版本偏舊直接apt install nodejs大概率是 18 甚至更低OpenClaw 要求 22所以用 NodeSource 的源來裝。# 更新系統(tǒng) sudo apt update sudo apt upgrade -y # 安裝 NodeSource 源并安裝 Node.js 22 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs # 驗證版本 node -v # 預期輸出 v22.x.x npm -v # 預期輸出 10.x.x裝完 Node 后裝 Docker。用官方腳本最省事它會自動處理依賴和 systemd 服務注冊。# 安裝 Docker curl -fsSL https://get.docker.com | sudo sh # 把當前用戶加入 docker 組避免每條命令都 sudo sudo usermod -aG docker $USER # 重新登錄使組權限生效然后驗證 docker version docker compose version # 預期輸出 Docker Compose version v2.x.x注意usermod之后必須重新登錄 SSH 會話組權限才會生效否則docker ps還是會報 permission denied。這一步很多人會忽略然后以為是 Docker 裝壞了。接下來準備項目目錄。我習慣把配置和數(shù)據(jù)分開數(shù)據(jù)用 volume 掛出來容器刪了數(shù)據(jù)還在。mkdir -p ~/openclaw/{config,data,logs} cd ~/openclaw目錄結構說明config放環(huán)境變量和模型配置data放 OpenClaw 的持久化數(shù)據(jù)logs放運行日志。這樣即使重建容器只要這三個目錄在服務狀態(tài)就能恢復。Node.js 運行時配置到這里就完成了。你可能會問既然用 Docker為什么還要在宿主機裝 Node因為我們要用 Node 來跑 OpenClaw 的初始化命令生成配置或者在某些調試場景下直接跑源碼。容器里也會裝 Node兩者不沖突。如果你完全走容器路線宿主機這步可以跳過但建議保留方便排障。3. 可復制的 Dockerfile 與 docker-compose 配置這一節(jié)是核心直接給可復制的配置。先寫 Dockerfile基于官方 Node 22 鏡像裝 OpenClaw暴露 8080 端口。# Dockerfile FROM node:22-slim # 安裝基礎工具OpenClaw 執(zhí)行腳本時會用到 RUN apt-get update apt-get install -y \ curl \ git \ python3 \ rm -rf /var/lib/apt/lists/* # 全局安裝 OpenClaw RUN npm install -g openclaw # 工作目錄 WORKDIR /app # 復制配置目錄 COPY config /app/config # 暴露后臺端口 EXPOSE 8080 # 啟動命令 CMD [openclaw, start, --config, /app/config/config.json]這里用node:22-slim而不是完整版鏡像小、啟動快。python3是給 OpenClaw 執(zhí)行某些腳本任務用的如果你的場景不涉及可以去掉。然后是 docker-compose.yml把環(huán)境變量、端口、volume 都編排好。# docker-compose.yml version: 3.8 services: openclaw: build: . container_name: openclaw restart: unless-stopped ports: - 8080:8080 environment: - NODE_ENVproduction - OPENCLAW_API_BASEhttps://taotoken.net/api - OPENCLAW_API_KEY${OPENCLAW_API_KEY} - OPENCLAW_MODEL_ID${OPENCLAW_MODEL_ID} - OPENCLAW_LOG_LEVELinfo volumes: - ./data:/app/data - ./logs:/app/logs - ./config:/app/config healthcheck: test: [CMD, curl, -f, http://localhost:8080/health] interval: 30s timeout: 10s retries: 3關鍵點說明。OPENCLAW_API_BASE指向 TaoToken 的 API 地址https://taotoken.net/api這是統(tǒng)一入口。OPENCLAW_API_KEY和OPENCLAW_MODEL_ID從.env文件讀取不寫死在 compose 里避免密鑰進版本庫。在~/openclaw下創(chuàng)建.env文件# .env OPENCLAW_API_KEY你的TaoToken_Key OPENCLAW_MODEL_ID你的模型IDTaoToken 的 Key 在控制臺創(chuàng)建入口是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 管理頁在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。創(chuàng)建后復制 Key填進.env。Model ID 按你實際要用的模型填比如某個通用對話模型或代碼模型。再寫一個 OpenClaw 的配置文件config/config.json把模型通道指向 TaoToken{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: ${OPENCLAW_API_KEY}, modelId: ${OPENCLAW_MODEL_ID} }, server: { port: 8080, host: 0.0.0.0 }, security: { confirmHighRisk: true } }provider用openai-compatible因為 TaoToken 提供的是兼容 OpenAI 協(xié)議的接口Base URL 填https://taotoken.net/apiKey 和 Model ID 通過環(huán)境變量注入。confirmHighRisk打開高風險操作人工確認刪除文件、執(zhí)行危險命令前會先問你這個建議保持開啟。三件套齊了Base URL Key Model ID。任何一處不對后面驗證都會失敗所以先核對清楚再啟動。4. 啟動容器并驗證 API 連通性配置就緒后構建并啟動容器。cd ~/openclaw # 構建鏡像 docker compose build # 后臺啟動 docker compose up -d # 查看容器狀態(tài) docker compose ps預期看到openclaw容器狀態(tài)是Uphealthcheck 顯示healthy。如果狀態(tài)是Restarting說明啟動命令有問題用docker compose logs openclaw看日志。容器起來后先驗證后臺端口是否響應curl -s http://localhost:8080/health預期返回類似{status:ok}。如果返回連接拒絕檢查端口映射和容器是否真的在跑。接下來驗證最關鍵的一步模型 API 通道是否連通。OpenClaw 內部會調用 TaoToken我們可以直接在容器里發(fā)一個測試請求確認 Base URL、Key、Model ID 三件套都正確。docker compose exec openclaw curl -s -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $OPENCLAW_API_KEY \ -H Content-Type: application/json \ -d { model: $OPENCLAW_MODEL_ID, messages: [{role: user, content: ping}], max_tokens: 10 }預期返回一個 JSON包含choices數(shù)組里面有模型回復內容。只要看到choices字段和內容說明通道打通了。如果返回 401是 Key 問題返回 404多半是 Base URL 或路徑不對返回model not found是 Model ID 填錯。你也可以用 TaoToken 的模型對話頁面先單獨驗證 Key 是否可用入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 在頁面上發(fā)一條消息能正?；貜途驼f明 Key 和模型沒問題再去排 OpenClaw 的配置。最后做一次端到端測試在 OpenClaw 后臺或綁定的聊天通道發(fā)一條指令比如「列出 /app/data 目錄下的文件」看它是否執(zhí)行并返回結果。這一步成功整條鏈路就算跑通了。如果你打算長期跑編碼類或 Agent 類任務可以了解下 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 適合持續(xù)性的開發(fā)輔助場景。5. 常見報錯排查401、local proxy failed 與 reading choices部署過程中高頻報錯就那么幾個逐個對照排查效率最高。401 Unauthorized。這是最常見的說明 Key 沒被正確識別。先確認.env里的OPENCLAW_API_KEY沒有多余空格或換行然后確認容器里讀到的環(huán)境變量是對的docker compose exec openclaw env | grep OPENCLAW如果 Key 顯示為空說明.env沒被 compose 加載檢查.env是否和docker-compose.yml在同一目錄。如果 Key 正確但依然 401去 TaoToken 控制臺確認這個 Key 是否啟用、是否有可用額度。local proxy failed。這個報錯通常出現(xiàn)在容器內請求外部 API 時網(wǎng)絡不通。先確認 ECS 安全組出方向沒有限制再在容器里測一下基礎連通性docker compose exec openclaw curl -s -o /dev/null -w %{http_code} https://taotoken.net/api預期返回 200 或 401取決于是否帶 Key如果返回 000 或超時是網(wǎng)絡層問題。注意不要在配置里寫任何本地代理地址容器直連即可。reading choices of undefined。這個報錯說明代碼在解析響應時響應體里沒有choices字段。原因通常是 Base URL 路徑不對比如把https://taotoken.net/api寫成了帶/v1或漏了/v1。TaoToken 的 Base URL 就是https://taotoken.net/api具體路徑由 SDK 拼接。另一個可能是 Model ID 填錯服務端返回了錯誤對象而不是正常響應。用第 4 節(jié)的 curl 命令單獨測一次看原始返回是什么。OAuth 相關報錯。如果你在配置里啟用了某些需要 OAuth 的通道比如綁定第三方協(xié)作平臺報錯會提示授權失敗。這類問題先確認回調地址配置正確再確認授權賬號狀態(tài)正常。如果只是跑模型通道可以先不啟用 OAuth 相關功能把核心鏈路跑通再逐步加。容器啟動后立即退出。用docker compose logs openclaw看最后幾行。常見原因是config/config.json格式錯誤JSON 少個逗號或多括號都會導致解析失敗。用python3 -m json.tool config/config.json校驗一下格式。端口 8080 被占用。ECS 上可能已經有別的服務占了 8080。改 compose 里的端口映射比如8081:8080然后訪問 8081。排查時記住一個原則先分層定位。網(wǎng)絡層用 curl 測連通性認證層看 401協(xié)議層看返回體結構配置層校驗 JSON 格式。一層層排除比盲目改配置快得多。6. 把 OpenClaw 長期跑穩(wěn)的幾個實用設置容器跑起來只是開始長期穩(wěn)定運行還需要幾個設置。第一日志輪轉。OpenClaw 跑久了日志會撐大磁盤在 compose 里加日志限制logging: driver: json-file options: max-size: 10m max-file: 3這樣單個日志文件最大 10MB保留 3 個不會無限增長。第二數(shù)據(jù)備份。data目錄是核心定期打包備份到對象存儲或另一臺機器?？梢詫憘€ cron# 每天凌晨 3 點備份 0 3 * * * tar -czf ~/backup/openclaw-data-$(date \%F).tar.gz ~/openclaw/data第三鏡像更新。OpenClaw 迭代快定期重建鏡像拉取新版本cd ~/openclaw docker compose build --no-cache docker compose up -d--no-cache確保拉到最新的 npm 包。更新前先備份 data 目錄萬一新版本有兼容問題可以回滾。第四安全加固。高風險操作確認保持開啟容器不要用 root 跑可以在 Dockerfile 里加USER node安全組只放行必要端口。如果 OpenClaw 要執(zhí)行文件操作把操作范圍限制在掛載的data目錄內不要掛載整個宿主機根目錄。第五監(jiān)控。用 healthcheck 配合阿里云的云監(jiān)控容器不健康時告警。也可以簡單點寫個腳本定時 curl/health失敗就發(fā)通知。這套組合下來OpenClaw 在阿里云 ECS 上就能穩(wěn)定長期運行。核心鏈路是ECS 提供算力Docker 提供隔離和可移植性TaoToken 提供統(tǒng)一的模型通道。三件套 Base URL Key Model ID 配對剩下的就是按需擴展技能和通道。接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到配置細節(jié)可以對照查。如果你用 Claude Code 類工具做開發(fā)輔助Anthropic 兼容通道的說明在 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 配置邏輯和本文一致都是 Base URL Key Model ID 三件套。最后留一個我踩過的坑.env文件里的值不要加引號OPENCLAW_API_KEYabc123這樣寫就行寫成OPENCLAW_API_KEYabc123在某些 compose 版本里會把引號也當成值的一部分導致 401。這個細節(jié)排查起來很費時間提前避開。