Shared runtime steps for VM-based Docker installs such as GCP, Hetzner, and similar VPS providers.<\/p>\n
Installing binaries inside a running container is a trap.
\nAnything installed at runtime will be lost on restart.<\/p>\n
All external binaries required by skills must be installed at image build time.<\/p>\n
The examples below show three common binaries only:<\/p>\n
gog<\/code> for Gmail access<\/li>\ngoplaces<\/code> for Google Places<\/li>\nwacli<\/code> for WhatsApp<\/li>\n<\/ul>\nThese are examples, not a complete list.
\nYou may install as many binaries as needed using the same pattern.<\/p>\n
If you add new skills later that depend on additional binaries, you must:<\/p>\n
\n- Update the Dockerfile<\/li>\n
- Rebuild the image<\/li>\n
- Restart the containers<\/li>\n<\/ol>\n
Example Dockerfile<\/strong><\/p>\n“`dockerfile theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\nFROM node:24-bookworm<\/p>\n
RUN apt-get update && apt-get install -y socat && rm -rf \/var\/lib\/apt\/lists\/*<\/p>\n
Example binary 1: Gmail CLI<\/h1>\n
RUN curl -L https:\/\/github.com\/steipete\/gog\/releases\/latest\/download\/gog_Linux_x86_64.tar.gz
\n | tar -xz -C \/usr\/local\/bin && chmod +x \/usr\/local\/bin\/gog<\/p>\n
Example binary 2: Google Places CLI<\/h1>\n
RUN curl -L https:\/\/github.com\/steipete\/goplaces\/releases\/latest\/download\/goplaces_Linux_x86_64.tar.gz
\n | tar -xz -C \/usr\/local\/bin && chmod +x \/usr\/local\/bin\/goplaces<\/p>\n
Example binary 3: WhatsApp CLI<\/h1>\n
RUN curl -L https:\/\/github.com\/steipete\/wacli\/releases\/latest\/download\/wacli_Linux_x86_64.tar.gz
\n | tar -xz -C \/usr\/local\/bin && chmod +x \/usr\/local\/bin\/wacli<\/p>\n
Add more binaries below using the same pattern<\/h1>\n
WORKDIR \/app
\nCOPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc .\/
\nCOPY ui\/package.json .\/ui\/package.json
\nCOPY scripts .\/scripts<\/p>\n
RUN corepack enable
\nRUN pnpm install –frozen-lockfile<\/p>\n
COPY . .
\nRUN pnpm build
\nRUN pnpm ui:install
\nRUN pnpm ui:build<\/p>\n
ENV NODE_ENV=production<\/p>\n
CMD [“node”,”dist\/index.js”]<\/p>\n
\n<Note>\n The download URLs above are for x86_64 (amd64). For ARM-based VMs (e.g. Hetzner ARM, GCP Tau T2A), replace the download URLs with the appropriate ARM64 variants from each tool's release page.\n<\/Note>\n\n## Build and launch\n\n```bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\ndocker compose build\ndocker compose up -d openclaw-gateway\n<\/code><\/pre>\nIf build fails with Killed<\/code> or exit code 137<\/code> during pnpm install --frozen-lockfile<\/code>, the VM is out of memory.
\nUse a larger machine class before retrying.<\/p>\nVerify binaries:<\/p>\n
“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\ndocker compose exec openclaw-gateway which gog
\ndocker compose exec openclaw-gateway which goplaces
\ndocker compose exec openclaw-gateway which wacli<\/p>\n
\nExpected output:\n\n<\/code><\/pre>\n\/usr\/local\/bin\/gog
\n\/usr\/local\/bin\/goplaces
\n\/usr\/local\/bin\/wacli<\/p>\n
\nVerify Gateway:\n\n```bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\ndocker compose logs -f openclaw-gateway\n<\/code><\/pre>\nExpected output:<\/p>\n
[gateway] listening on ws:\/\/0.0.0.0:18789\n<\/code><\/pre>\nWhat persists where<\/h2>\n
OpenClaw runs in Docker, but Docker is not the source of truth.
\nAll long-lived state must survive restarts, rebuilds, and reboots.<\/p>\n
\n\n\nComponent<\/th>\n Location<\/th>\n Persistence mechanism<\/th>\n 说明s<\/th>\n<\/tr>\n<\/thead>\n \n\nGateway config<\/td>\n \/home\/node\/.openclaw\/<\/code><\/td>\nHost volume mount<\/td>\n Includes openclaw.json<\/code>, tokens<\/td>\n<\/tr>\n\nModel auth profiles<\/td>\n \/home\/node\/.openclaw\/<\/code><\/td>\nHost volume mount<\/td>\n OAuth tokens, API keys<\/td>\n<\/tr>\n \nSkill configs<\/td>\n \/home\/node\/.openclaw\/skills\/<\/code><\/td>\nHost volume mount<\/td>\n Skill-level state<\/td>\n<\/tr>\n \nAgent workspace<\/td>\n \/home\/node\/.openclaw\/workspace\/<\/code><\/td>\nHost volume mount<\/td>\n Code and agent artifacts<\/td>\n<\/tr>\n \nWhatsApp session<\/td>\n \/home\/node\/.openclaw\/<\/code><\/td>\nHost volume mount<\/td>\n Preserves QR login<\/td>\n<\/tr>\n \nGmail keyring<\/td>\n \/home\/node\/.openclaw\/<\/code><\/td>\nHost volume + password<\/td>\n Requires GOG_KEYRING_PASSWORD<\/code><\/td>\n<\/tr>\n\nExternal binaries<\/td>\n \/usr\/local\/bin\/<\/code><\/td>\nDocker image<\/td>\n Must be baked at build time<\/td>\n<\/tr>\n \nNode runtime<\/td>\n Container filesystem<\/td>\n Docker image<\/td>\n Rebuilt every image build<\/td>\n<\/tr>\n \nOS packages<\/td>\n Container filesystem<\/td>\n Docker image<\/td>\n Do not install at runtime<\/td>\n<\/tr>\n \nDocker container<\/td>\n Ephemeral<\/td>\n Restartable<\/td>\n Safe to destroy<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nUpdates<\/h2>\n
To update OpenClaw on the VM:<\/p>\n
bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
\ngit pull
\ndocker compose build
\ndocker compose up -d<\/code><\/p>\n","protected":false},"excerpt":{"rendered":"Docker VM Runtime Shared runtime steps for VM-based Doc […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-616","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/616","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=616"}],"version-history":[{"count":3,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/616\/revisions"}],"predecessor-version":[{"id":770,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/616\/revisions\/770"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=616"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=616"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=616"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}