मुख्य सामग्री पर जाएं
GCP, Hetzner और समान VPS प्रदाताओं जैसे VM-आधारित Docker इंस्टॉलेशन के लिए साझा runtime चरण।

आवश्यक बाइनरीज़ को इमेज में बेक करें

चलते हुए कंटेनर के अंदर बाइनरीज़ इंस्टॉल करना एक जाल है। runtime पर इंस्टॉल की गई कोई भी चीज़ restart पर खो जाएगी। Skills के लिए आवश्यक सभी बाहरी बाइनरीज़ इमेज build time पर इंस्टॉल होनी चाहिए। नीचे दिए गए उदाहरण केवल तीन सामान्य बाइनरीज़ दिखाते हैं:
  • Gmail access के लिए gog (gogcli से)
  • Google Places के लिए goplaces
  • WhatsApp के लिए wacli
ये उदाहरण हैं, पूरी सूची नहीं। आप इसी पैटर्न का उपयोग करके जितनी ज़रूरत हो उतनी बाइनरीज़ इंस्टॉल कर सकते हैं। यदि आप बाद में नई Skills जोड़ते हैं जो अतिरिक्त बाइनरीज़ पर निर्भर करती हैं, तो आपको:
  1. Dockerfile अपडेट करना होगा
  2. इमेज फिर से बनानी होगी
  3. कंटेनरों को restart करना होगा
उदाहरण Dockerfile
FROM node:24-bookworm

RUN apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/*

# Example binary 1: Gmail CLI (gogcli — installs as `gog`)
# Copy the current Linux asset URL from https://github.com/steipete/gogcli/releases
RUN curl -L https://github.com/steipete/gogcli/releases/latest/download/gogcli_linux_amd64.tar.gz \
  | tar -xzO gog > /usr/local/bin/gog; \
  chmod +x /usr/local/bin/gog

# Example binary 2: Google Places CLI
# Copy the current Linux asset URL from https://github.com/steipete/goplaces/releases
RUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_linux_amd64.tar.gz \
  | tar -xzO goplaces > /usr/local/bin/goplaces; \
  chmod +x /usr/local/bin/goplaces

# Example binary 3: WhatsApp CLI
# Copy the current Linux asset URL from https://github.com/steipete/wacli/releases
RUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli-linux-amd64.tar.gz \
  | tar -xzO wacli > /usr/local/bin/wacli; \
  chmod +x /usr/local/bin/wacli

# Add more binaries below using the same pattern

WORKDIR /app
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
COPY ui/package.json ./ui/package.json
COPY scripts ./scripts

RUN corepack enable
RUN pnpm install --frozen-lockfile

COPY . .
RUN pnpm build
RUN pnpm ui:install
RUN pnpm ui:build

ENV NODE_ENV=production

CMD ["node","dist/index.js"]
ऊपर दिए गए URL उदाहरण हैं। ARM-आधारित VM के लिए, arm64 assets चुनें। पुनरुत्पादनीय builds के लिए, versioned release URL pin करें।

Build और launch

docker compose build
docker compose up -d openclaw-gateway
यदि pnpm install --frozen-lockfile के दौरान build Killed या exit code 137 के साथ विफल होता है, तो VM में memory कम है। फिर से कोशिश करने से पहले बड़ी machine class का उपयोग करें। बाइनरीज़ सत्यापित करें:
docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli
अपेक्षित output:
/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli
Gateway सत्यापित करें:
docker compose logs -f openclaw-gateway
अपेक्षित output:
[gateway] listening on ws://0.0.0.0:18789

क्या कहाँ persist होता है

OpenClaw Docker में चलता है, लेकिन Docker सत्य का स्रोत नहीं है। सभी long-lived state को restarts, rebuilds और reboots के बाद भी बने रहना चाहिए।
घटकस्थानpersistence mechanismनोट्स
Gateway config/home/node/.openclaw/होस्ट volume mountopenclaw.json, .env शामिल हैं
Model auth profiles/home/node/.openclaw/agents/होस्ट volume mountagents/<agentId>/agent/auth-profiles.json (OAuth, API keys)
Auth profile key/home/node/.config/openclaw/होस्ट volume mountOAuth auth profile token material के लिए स्थानीय encryption key
Skill configs/home/node/.openclaw/skills/होस्ट volume mountSkill-level state
Agent workspace/home/node/.openclaw/workspace/होस्ट volume mountcode और agent artifacts
WhatsApp session/home/node/.openclaw/होस्ट volume mountQR login को सुरक्षित रखता है
Gmail keyring/home/node/.openclaw/होस्ट volume + passwordGOG_KEYRING_PASSWORD आवश्यक है
Plugin packages/home/node/.openclaw/npm, /home/node/.openclaw/gitहोस्ट volume mountdownloadable Plugin package roots
External binaries/usr/local/bin/Docker imagebuild time पर बेक करना आवश्यक है
Node runtimeकंटेनर filesystemDocker imageहर image build पर फिर से बनता है
OS packagesकंटेनर filesystemDocker imageruntime पर इंस्टॉल न करें
Docker containerअस्थायीrestartableनष्ट करना सुरक्षित है

Updates

VM पर OpenClaw अपडेट करने के लिए:
git pull
docker compose build
docker compose up -d

संबंधित