chore(orchestrator): MS21 complete — UI-001-QA and TEST-004 done

docker/openclaw-instances/README.md

@@ -0,0 +1,47 @@
+# OpenClaw Agent Instance Setup
+
+Each service in the OpenClaw fleet reads:
+
+- A per-agent environment file: `docker/openclaw-instances/<agent>.env`
+- A per-agent JSON5 config: `docker/openclaw-instances/<agent>.json`
+
+## 1. Fill in API keys in `.env` files
+
+Set `ZAI_API_KEY` in each instance env file:
+
+- `jarvis-main.env`
+- `jarvis-projects.env`
+- `jarvis-research.env`
+- `jarvis-operations.env`
+
+## 2. Generate unique gateway tokens per agent
+
+Generate one token per instance:
+
+```bash
+openssl rand -hex 32
+```
+
+Set a different `OPENCLAW_GATEWAY_TOKEN` in each `.env` file.
+
+## 3. Deploy the Docker Swarm stack
+
+From repository root:
+
+```bash
+docker stack deploy -c docker/openclaw-compose.yml jarvis
+```
+
+## 4. First-time auth (if needed)
+
+If an instance requires first-time login, exec into the running container and run:
+
+```bash
+openclaw auth
+```
+
+This uses OpenClaw's headless OAuth device-code flow.
+
+## 5. Use Mosaic WebUI terminal for auth
+
+You can complete the device-code auth flow from the Mosaic WebUI terminal (xterm.js) attached to the service container.

docker/openclaw-instances/jarvis-main.env

@@ -0,0 +1,3 @@
+OPENCLAW_CONFIG_PATH=/config/openclaw.json
+ZAI_API_KEY=REPLACE_WITH_ZAI_API_KEY
+OPENCLAW_GATEWAY_TOKEN=REPLACE_WITH_UNIQUE_GATEWAY_TOKEN

docker/openclaw-instances/jarvis-main.json

@@ -0,0 +1,41 @@
+{
+  "gateway": {
+    "mode": "local",
+    "port": 18789,
+    "bind": "lan",
+    "auth": { "mode": "token" },
+    "http": {
+      "endpoints": {
+        "chatCompletions": { "enabled": true }
+      }
+    }
+  },
+  "agents": {
+    "defaults": {
+      "workspace": "/home/node/workspace",
+      "model": { "primary": "zai/glm-5" }
+    }
+  },
+  // Z.ai is built in and uses ZAI_API_KEY.
+  // Ollama is configured for optional local reasoning fallback.
+  "models": {
+    "mode": "merge",
+    "providers": {
+      "ollama": {
+        "baseUrl": "http://10.1.1.42:11434/v1",
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "cogito",
+            "name": "Cogito (Local Reasoning)",
+            "reasoning": false,
+            "input": ["text"],
+            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
+            "contextWindow": 128000,
+            "maxTokens": 8192
+          }
+        ]
+      }
+    }
+  }
+}

docker/openclaw-instances/jarvis-operations.env

@@ -0,0 +1,3 @@
+OPENCLAW_CONFIG_PATH=/config/openclaw.json
+ZAI_API_KEY=REPLACE_WITH_ZAI_API_KEY
+OPENCLAW_GATEWAY_TOKEN=REPLACE_WITH_UNIQUE_GATEWAY_TOKEN

docker/openclaw-instances/jarvis-operations.json

@@ -0,0 +1,40 @@
+{
+  "gateway": {
+    "mode": "local",
+    "port": 18789,
+    "bind": "lan",
+    "auth": { "mode": "token" },
+    "http": {
+      "endpoints": {
+        "chatCompletions": { "enabled": true }
+      }
+    }
+  },
+  "agents": {
+    "defaults": {
+      "workspace": "/home/node/workspace",
+      "model": { "primary": "ollama/cogito" }
+    }
+  },
+  // Operations uses local Ollama Cogito as the primary model.
+  "models": {
+    "mode": "merge",
+    "providers": {
+      "ollama": {
+        "baseUrl": "http://10.1.1.42:11434/v1",
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "cogito",
+            "name": "Cogito (Local Reasoning)",
+            "reasoning": false,
+            "input": ["text"],
+            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
+            "contextWindow": 128000,
+            "maxTokens": 8192
+          }
+        ]
+      }
+    }
+  }
+}

docker/openclaw-instances/jarvis-projects.env

@@ -0,0 +1,3 @@
+OPENCLAW_CONFIG_PATH=/config/openclaw.json
+ZAI_API_KEY=REPLACE_WITH_ZAI_API_KEY
+OPENCLAW_GATEWAY_TOKEN=REPLACE_WITH_UNIQUE_GATEWAY_TOKEN

docker/openclaw-instances/jarvis-projects.json

@@ -0,0 +1,39 @@
+{
+  "gateway": {
+    "mode": "local",
+    "port": 18789,
+    "bind": "lan",
+    "auth": { "mode": "token" },
+    "http": {
+      "endpoints": {
+        "chatCompletions": { "enabled": true }
+      }
+    }
+  },
+  "agents": {
+    "defaults": {
+      "workspace": "/home/node/workspace",
+      "model": { "primary": "zai/glm-5" }
+    }
+  },
+  "models": {
+    "mode": "merge",
+    "providers": {
+      "ollama": {
+        "baseUrl": "http://10.1.1.42:11434/v1",
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "cogito",
+            "name": "Cogito (Local Reasoning)",
+            "reasoning": false,
+            "input": ["text"],
+            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
+            "contextWindow": 128000,
+            "maxTokens": 8192
+          }
+        ]
+      }
+    }
+  }
+}

docker/openclaw-instances/jarvis-research.env

@@ -0,0 +1,3 @@
+OPENCLAW_CONFIG_PATH=/config/openclaw.json
+ZAI_API_KEY=REPLACE_WITH_ZAI_API_KEY
+OPENCLAW_GATEWAY_TOKEN=REPLACE_WITH_UNIQUE_GATEWAY_TOKEN

docker/openclaw-instances/jarvis-research.json

@@ -0,0 +1,39 @@
+{
+  "gateway": {
+    "mode": "local",
+    "port": 18789,
+    "bind": "lan",
+    "auth": { "mode": "token" },
+    "http": {
+      "endpoints": {
+        "chatCompletions": { "enabled": true }
+      }
+    }
+  },
+  "agents": {
+    "defaults": {
+      "workspace": "/home/node/workspace",
+      "model": { "primary": "zai/glm-5" }
+    }
+  },
+  "models": {
+    "mode": "merge",
+    "providers": {
+      "ollama": {
+        "baseUrl": "http://10.1.1.42:11434/v1",
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "cogito",
+            "name": "Cogito (Local Reasoning)",
+            "reasoning": false,
+            "input": ["text"],
+            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
+            "contextWindow": 128000,
+            "maxTokens": 8192
+          }
+        ]
+      }
+    }
+  }
+}