Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

GCP, Hetzner ve benzeri VPS sağlayıcıları gibi VM tabanlı Docker kurulumları için paylaşılan çalışma zamanı adımları.

​
Gerekli ikili dosyaları imaja dahil edin

Çalışan bir konteynerin içine ikili dosya kurmak tuzaktır. Çalışma zamanında kurulan her şey yeniden başlatmada kaybolur. Skills tarafından gereken tüm harici ikili dosyalar imaj derleme zamanında kurulmalıdır. Aşağıdaki örnekler yalnızca üç yaygın ikili dosyayı gösterir:
  • Gmail erişimi için gog (gogcli kaynağından)
  • Google Places için goplaces
  • WhatsApp için wacli
Bunlar örnektir, eksiksiz bir liste değildir. Aynı deseni kullanarak gerektiği kadar çok ikili dosya kurabilirsiniz. Daha sonra ek ikili dosyalara bağımlı yeni Skills eklerseniz şunları yapmanız gerekir:
  1. Dockerfile’ı güncelleyin
  2. İmajı yeniden derleyin
  3. Konteynerleri yeniden başlatın
Örnek 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"]
Yukarıdaki URL’ler örnektir. ARM tabanlı VM’ler için arm64 varlıklarını seçin. Tekrarlanabilir derlemeler için sürümlenmiş yayın URL’lerini sabitleyin.

​
Derleyin ve başlatın

docker compose build
docker compose up -d openclaw-gateway
Derleme pnpm install --frozen-lockfile sırasında Killed veya exit code 137 ile başarısız olursa VM’nin belleği yetersizdir. Yeniden denemeden önce daha büyük bir makine sınıfı kullanın. İkili dosyaları doğrulayın: 
docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli
Beklenen çıktı: 
/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli
Gateway’i doğrulayın: 
docker compose logs -f openclaw-gateway
Beklenen çıktı: 
[gateway] listening on ws://0.0.0.0:18789

​
Ne nerede kalıcı olur

OpenClaw Docker içinde çalışır, ancak Docker doğruluk kaynağı değildir. Tüm uzun ömürlü durum yeniden başlatmalardan, yeniden derlemelerden ve yeniden başlatılan makinelerden sonra korunmalıdır.
BileşenKonumKalıcılık mekanizmasıNotlar
Gateway yapılandırması/home/node/.openclaw/Ana makine volume mountopenclaw.json, .env içerir
Model kimlik doğrulama profilleri/home/node/.openclaw/agents/Ana makine volume mountagents/<agentId>/agent/auth-profiles.json (OAuth, API anahtarları)
Kimlik doğrulama profili anahtarı/home/node/.config/openclaw/Ana makine volume mountOAuth kimlik doğrulama profili token materyali için yerel şifreleme anahtarı
Skill yapılandırmaları/home/node/.openclaw/skills/Ana makine volume mountSkill düzeyinde durum
Agent çalışma alanı/home/node/.openclaw/workspace/Ana makine volume mountKod ve agent yapıtları
WhatsApp oturumu/home/node/.openclaw/Ana makine volume mountQR oturum açmayı korur
Gmail anahtarlığı/home/node/.openclaw/Ana makine volume + parolaGOG_KEYRING_PASSWORD gerektirir
Plugin paketleri/home/node/.openclaw/npm, /home/node/.openclaw/gitAna makine volume mountİndirilebilir plugin paketi kökleri
Harici ikili dosyalar/usr/local/bin/Docker imajıDerleme zamanında imaja dahil edilmelidir
Node çalışma zamanıKonteyner dosya sistemiDocker imajıHer imaj derlemesinde yeniden derlenir
OS paketleriKonteyner dosya sistemiDocker imajıÇalışma zamanında kurmayın
Docker konteyneriGeçiciYeniden başlatılabilirYok etmek güvenlidir

​
Güncellemeler

VM üzerindeki OpenClaw’ı güncellemek için: 
git pull
docker compose build
docker compose up -d

​
İlgili