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