From d8410179fe4e9c35b01d3a43bccbd85e7ff54fae Mon Sep 17 00:00:00 2001
From: OpenClaw <openclaw@local>
Date: Tue, 17 Mar 2026 15:52:10 +0000
Subject: [PATCH] docs: add deployment guide and helper scripts

---
 DEPLOY.md                   | 38 +++++++++++++++++++++++++++++++++++++
 docker-compose.override.yml |  8 ++++++++
 start.sh                    |  6 ++++++
 3 files changed, 52 insertions(+)
 create mode 100644 DEPLOY.md
 create mode 100644 docker-compose.override.yml
 create mode 100755 start.sh

diff --git a/DEPLOY.md b/DEPLOY.md
new file mode 100644
index 0000000..ea049a3
--- /dev/null
+++ b/DEPLOY.md
@@ -0,0 +1,38 @@
+# Déploiement — OpenClaw Dashboard
+
+Le dashboard doit tourner dans le conteneur Docker OpenClaw (LXC 145) car il accède
+directement aux fichiers de sessions `/home/node/.openclaw/agents/`.
+
+## Étapes
+
+### 1. Mapper le port sur le LXC host (192.168.1.145)
+
+Créer ou compléter `~/openclaw/docker-compose.override.yml` sur le LXC :
+
+```yaml
+services:
+  openclaw-gateway:
+    ports:
+      - "3850:3850"
+```
+
+Puis relancer : `~/openclaw/oc-up.sh`
+
+### 2. Lancer le dashboard dans le conteneur
+
+```bash
+docker exec openclaw-openclaw-gateway-1 bash -c "
+  cd /home/node/.openclaw/workspace/projets/openclaw-dashboard &&
+  npm install --silent &&
+  SESSIONS_DIR=/home/node/.openclaw/agents PORT=3850 node server.js &
+"
+```
+
+### 3. Accès
+- Local : http://192.168.1.145:3850
+- Tailscale : http://100.64.255.3:3850
+
+### 4. Persistance (optionnel)
+Pour que le dashboard redémarre automatiquement avec OpenClaw, ajouter dans le
+docker-compose.override.yml un service dédié, ou utiliser le HEARTBEAT.md pour
+le relancer périodiquement.
diff --git a/docker-compose.override.yml b/docker-compose.override.yml
new file mode 100644
index 0000000..8803c45
--- /dev/null
+++ b/docker-compose.override.yml
@@ -0,0 +1,8 @@
+# À placer dans ~/openclaw/docker-compose.override.yml sur le LXC host
+# (fusionner avec l'éventuel override existant)
+services:
+  openclaw-gateway:
+    ports:
+      - "3850:3850"
+    environment:
+      DASHBOARD_PORT: "3850"
diff --git a/start.sh b/start.sh
new file mode 100755
index 0000000..a286260
--- /dev/null
+++ b/start.sh
@@ -0,0 +1,6 @@
+#!/bin/bash
+# Lance le dashboard OpenClaw en arrière-plan dans le conteneur
+cd /home/node/.openclaw/workspace/projets/openclaw-dashboard
+npm install --silent 2>/dev/null
+SESSIONS_DIR=/home/node/.openclaw/agents PORT=3850 node server.js &
+echo "Dashboard lancé sur http://0.0.0.0:3850"