docs: update README and CHANGELOG with stable SSH tunnel architecture

Co-authored-by: Junie <junie@jetbrains.com>
This commit is contained in:
mw
2026-03-22 11:16:03 +01:00
co-authored by Junie
parent 2281455a33
commit be00d893d2
2 changed files with 33 additions and 21 deletions
+17 -21
View File
@@ -17,9 +17,8 @@ This repository documents the OpenClaw gateway integration for the satware AG Ma
| **OS** | macOS 26.3.1 (Tahoe) |
| **Kernel** | Darwin 25.3.0 (x86_64) |
| **User** | MWsatwareAG |
| **Local IP** | 10.11.206.26 (en0) |
| **Tailscale IP** | 100.64.0.12 |
| **OpenClaw Version** | core v2026.3.8 |
| **Local IP** | 100.64.0.12 (Tailscale) |
| **OpenClaw Version** | core v2026.3.13 |
## Node Configuration
@@ -37,10 +36,10 @@ This repository documents the OpenClaw gateway integration for the satware AG Ma
│ │ │ │
│ OpenClaw Node │ WebSocket │ OpenClaw Gateway │
│ (remote mode) │◄──────────────────►│ (100.64.0.39) │
│ v2026.3.8 │ Port 18789 │ Port 18789 │
│ v2026.3.13 │ Port 18789 │ Port 18789 │
│ │ │ │
│ SSH Client │ SSH Tunnel │ SSH Server │
│──────────────────►│ Port 2222 │
(LaunchAgent) │──────────────────►│ Port 2222 │
└─────────────────────┘ └─────────────────────┘
```
@@ -48,15 +47,11 @@ This repository documents the OpenClaw gateway integration for the satware AG Ma
```json
{
"meta": {
"lastTouchedVersion": "2026.3.8"
"lastTouchedVersion": "2026.3.13"
},
"gateway": {
"mode": "remote",
"remote": {
"url": "ws://100.64.0.39:18789",
"token": "skt3_W8A5AVp...",
"sshTarget": "root@100.64.0.39:2222",
"sshIdentity": "/Users/MWsatwareAG/.ssh/id_ed25519"
"url": "ws://127.0.0.1:18789"
}
}
}
@@ -342,34 +337,35 @@ glab auth login --hostname gitlab.satware.com --token <TOKEN>
## Verification Status
**Last Verified**: 2026-03-11 23:15 CET
**Last Verified**: 2026-03-22 11:30 CET
| Component | Status |
|-----------|--------|
| **Node Connection** | ✅ Paired & Connected |
| **Gateway Health** | ✅ OK (158ms via Tailscale) |
| **Node Connection** | ✅ Paired & Connected (Headless + App) |
| **Gateway Health** | ✅ OK (Transparent via SSH Tunnel) |
| **system.run** | ✅ Working |
| **Vision (Peekaboo)**| ✅ Active |
| **iMessage (imsg)** | ✅ Active |
| **Capabilities** | `browser`, `system`, `peekaboo`, `imsg`, `apple-notes` |
| **Capabilities** | `browser`, `system`, `camera`, `canvas`, `screen`, `location` |
### MacBook launchd Services
| Service | Status | Purpose |
|---------|--------|---------|
| `ai.openclaw.node` | Running | Primary Node service (v2026.3.8) |
| `ai.openclaw.node` | Running | Manages SSH Tunnel and Headless Node (v2026.3.13) |
| `ai.openclaw.gateway` | Unloaded | Disabled (remote node role) |
| `com.satware.openclaw-tunnel` | Running | SSH tunnel to gateway |
| `OpenClaw.app` | Running | macOS Companion App (v2026.3.13) |
### Management Commands (on MacBook)
```bash
# Check service status
launchctl list | grep openclaw
launchctl list | grep ai.openclaw
ps aux | grep openclaw
# Restart SSH tunnel
launchctl unload ~/Library/LaunchAgents/com.satware.openclaw-tunnel.plist
launchctl load ~/Library/LaunchAgents/com.satware.openclaw-tunnel.plist
# Restart Node and Tunnel
launchctl unload ~/Library/LaunchAgents/ai.openclaw.node.plist
launchctl load ~/Library/LaunchAgents/ai.openclaw.node.plist
```
### Verify from Gateway