Update docs for OpenClaw v2026.3.8, peekaboo, and imsg integration
Co-authored-by: Junie <junie@jetbrains.com>
This commit is contained in:
@@ -4,6 +4,20 @@ All notable changes to this repository are documented in this file.
|
|||||||
|
|
||||||
## [Unreleased]
|
## [Unreleased]
|
||||||
|
|
||||||
|
## 2026-03-11
|
||||||
|
|
||||||
|
### Added
|
||||||
|
- Reconfigured OpenClaw Node for remote mode connecting to gateway `100.64.0.39:18789`.
|
||||||
|
- Installed and enabled `peekaboo` v3.0.0-beta3 for UI automation and Vision.
|
||||||
|
- Installed and enabled `imsg` v0.5.0 (built from source as universal binary) for iMessage integration.
|
||||||
|
- Successfully paired and authorized the MacBook node with the remote gateway.
|
||||||
|
- Verified Vision capabilities for background node service via TCC permissions.
|
||||||
|
|
||||||
|
### Changed
|
||||||
|
- Updated `ai.openclaw.node.plist` with optimized `ThrottleInterval` (10s) and environment variables.
|
||||||
|
- Disabled local `ai.openclaw.gateway` service to reduce resource contention.
|
||||||
|
- Upgraded OpenClaw to v2026.3.8 on both local node and remote gateway.
|
||||||
|
|
||||||
## 2026-03-04 (Evening)
|
## 2026-03-04 (Evening)
|
||||||
|
|
||||||
### Added
|
### Added
|
||||||
|
|||||||
@@ -9,12 +9,12 @@ This repository documents the OpenClaw gateway integration for the satware AG Ma
|
|||||||
| Property | Value |
|
| Property | Value |
|
||||||
|----------|-------|
|
|----------|-------|
|
||||||
| **Hostname** | satware-AG-MacBook-Pro.local |
|
| **Hostname** | satware-AG-MacBook-Pro.local |
|
||||||
| **OS** | macOS 26.3 (Tahoe) |
|
| **OS** | macOS 26.3.1 (Tahoe) |
|
||||||
| **Kernel** | Darwin 25.3.0 (x86_64) |
|
| **Kernel** | Darwin 25.3.0 (x86_64) |
|
||||||
| **User** | MWsatwareAG |
|
| **User** | MWsatwareAG |
|
||||||
| **Local IP** | 10.11.206.26 (en0) |
|
| **Local IP** | 10.11.206.26 (en0) |
|
||||||
| **Tailscale IP** | 100.64.0.12 |
|
| **Tailscale IP** | 100.64.0.12 |
|
||||||
| **OpenClaw Version** | core v2026.3.2 |
|
| **OpenClaw Version** | core v2026.3.8 |
|
||||||
|
|
||||||
## Node Configuration
|
## Node Configuration
|
||||||
|
|
||||||
@@ -30,9 +30,9 @@ This repository documents the OpenClaw gateway integration for the satware AG Ma
|
|||||||
│ MacBook Pro │ 100.64.0.x │ Manjaro PC │
|
│ MacBook Pro │ 100.64.0.x │ Manjaro PC │
|
||||||
│ (Tool Node) │◄──────────────────►│ (Gateway Host) │
|
│ (Tool Node) │◄──────────────────►│ (Gateway Host) │
|
||||||
│ │ │ │
|
│ │ │ │
|
||||||
│ OpenClaw.app │ WebSocket │ agent-zero │
|
│ OpenClaw Node │ WebSocket │ OpenClaw Gateway │
|
||||||
│ (remote mode) │◄──────────────────►│ Docker container │
|
│ (remote mode) │◄──────────────────►│ (100.64.0.39) │
|
||||||
│ │ ws://:18789 │ Port 18789 │
|
│ v2026.3.8 │ Port 18789 │ Port 18789 │
|
||||||
│ │ │ │
|
│ │ │ │
|
||||||
│ SSH Client │ SSH Tunnel │ SSH Server │
|
│ SSH Client │ SSH Tunnel │ SSH Server │
|
||||||
│ │──────────────────►│ Port 2222 │
|
│ │──────────────────►│ Port 2222 │
|
||||||
@@ -42,11 +42,17 @@ This repository documents the OpenClaw gateway integration for the satware AG Ma
|
|||||||
### MacBook OpenClaw Config (`~/.openclaw/openclaw.json`)
|
### MacBook OpenClaw Config (`~/.openclaw/openclaw.json`)
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"mode": "remote",
|
"meta": {
|
||||||
"remote": {
|
"lastTouchedVersion": "2026.3.8"
|
||||||
"sshIdentity": "/Users/MWsatwareAG/.ssh/id_ed25519",
|
},
|
||||||
"sshTarget": "root@100.64.0.39:2222",
|
"gateway": {
|
||||||
"url": "ws://100.64.0.39:18789"
|
"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"
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
@@ -80,14 +86,38 @@ This repository documents the OpenClaw gateway integration for the satware AG Ma
|
|||||||
|------------|----------|--------|
|
|------------|----------|--------|
|
||||||
| **system** | `system.run`, `system.run.prepare`, `system.which` | ✅ Working |
|
| **system** | `system.run`, `system.run.prepare`, `system.which` | ✅ Working |
|
||||||
| **browser** | `browser.proxy` | ⚠️ Requires browser session |
|
| **browser** | `browser.proxy` | ⚠️ Requires browser session |
|
||||||
|
| **peekaboo**| `see`, `image`, `app.list`, `clipboard.get/set` | ✅ Active (Vision ready) |
|
||||||
|
| **imsg** | `chats`, `history`, `send` | ✅ Active (Full Disk Access) |
|
||||||
|
| **apple-notes** | `memo` integrations | ✅ Ready |
|
||||||
|
| **apple-reminders** | `remindctl` integrations | ✅ Ready |
|
||||||
| **camera** | `camera.list`, `camera.snap`, `camera.clip` | ❌ Not supported on darwin |
|
| **camera** | `camera.list`, `camera.snap`, `camera.clip` | ❌ Not supported on darwin |
|
||||||
| **screen** | `screen.record` | ❌ Not in allowlist for darwin |
|
| **screen** | `screen.record` | ❌ Not in allowlist for darwin |
|
||||||
| **canvas** | `canvas.snapshot`, `canvas.present`, etc. | ❌ Not supported on darwin |
|
| **canvas** | `canvas.snapshot`, `canvas.present`, etc. | ❌ Not supported on darwin |
|
||||||
|
|
||||||
> **Note**: Camera, screen, and canvas commands are not available on macOS (darwin platform). These features are primarily designed for iOS/mobile nodes.
|
> **Note**: Vision features in `peekaboo` require **Screen Recording** permissions granted to the Node.js binary (`/usr/local/Cellar/node/25.8.0/bin/node`). UI automation (clicks/typing) requires **Accessibility** permissions granted to the same binary.
|
||||||
|
|
||||||
## Tested Commands
|
## Tested Commands
|
||||||
|
|
||||||
|
### peekaboo
|
||||||
|
Advanced UI automation and system introspection.
|
||||||
|
|
||||||
|
| Command | Status | Notes |
|
||||||
|
|---------|--------|-------|
|
||||||
|
| `peekaboo image` | ✅ | Screenshot capture (Vision) |
|
||||||
|
| `peekaboo app list` | ✅ | Lists running applications |
|
||||||
|
| `peekaboo clipboard` | ✅ | Read/write system clipboard |
|
||||||
|
| `peekaboo dock list` | ✅ | Lists items in macOS Dock |
|
||||||
|
| `peekaboo permissions` | ✅ | Diagnostic for TCC permissions |
|
||||||
|
|
||||||
|
### imsg
|
||||||
|
CLI-based iMessage/SMS integration.
|
||||||
|
|
||||||
|
| Command | Status | Notes |
|
||||||
|
|---------|--------|-------|
|
||||||
|
| `imsg chats` | ✅ | Lists recent conversations |
|
||||||
|
| `imsg history` | ✅ | Retrieves message history |
|
||||||
|
| `imsg send` | ✅ | Sends messages via Messages.app |
|
||||||
|
|
||||||
### system.run
|
### system.run
|
||||||
Execute shell commands on the MacBook node.
|
Execute shell commands on the MacBook node.
|
||||||
|
|
||||||
@@ -109,9 +139,11 @@ docker exec agent-zero openclaw nodes invoke \
|
|||||||
| `ls -la /Users/MWsatwareAG` | ✅ | Full filesystem access |
|
| `ls -la /Users/MWsatwareAG` | ✅ | Full filesystem access |
|
||||||
| `/sbin/ifconfig en0` | ✅ | Network interface info |
|
| `/sbin/ifconfig en0` | ✅ | Network interface info |
|
||||||
| `/usr/bin/curl -s https://httpbin.org/ip` | ✅ | External network access |
|
| `/usr/bin/curl -s https://httpbin.org/ip` | ✅ | External network access |
|
||||||
| `node --version` | ✅ | Node.js available at `/usr/local/bin/node` |
|
| `node --version` | ✅ | Node.js v25.8.0 at `/usr/local/bin/node` |
|
||||||
| `python3 --version` | ✅ | Python3 at `/usr/bin/python3` |
|
| `python3 --version` | ✅ | Python3 at `/usr/bin/python3` |
|
||||||
| `git --version` | ✅ | Git at `/usr/local/bin/git` |
|
| `git --version` | ✅ | Git at `/usr/local/bin/git` |
|
||||||
|
| `peekaboo --version` | ✅ | v3.0.0-beta3 (Universal) |
|
||||||
|
| `imsg --version` | ✅ | v0.5.0 (Universal, locally built) |
|
||||||
|
|
||||||
#### Known Issues
|
#### Known Issues
|
||||||
|
|
||||||
@@ -305,23 +337,24 @@ glab auth login --hostname gitlab.satware.com --token <TOKEN>
|
|||||||
|
|
||||||
## Verification Status
|
## Verification Status
|
||||||
|
|
||||||
**Last Verified**: 2026-03-04 20:27 CET
|
**Last Verified**: 2026-03-11 23:15 CET
|
||||||
|
|
||||||
| Component | Status |
|
| Component | Status |
|
||||||
|-----------|--------|
|
|-----------|--------|
|
||||||
| **Node Connection** | ✅ Connected |
|
| **Node Connection** | ✅ Paired & Connected |
|
||||||
| **Gateway Health** | ✅ OK (33ms) |
|
| **Gateway Health** | ✅ OK (158ms via Tailscale) |
|
||||||
| **system.run** | ✅ Working |
|
| **system.run** | ✅ Working |
|
||||||
| **Capabilities** | `browser`, `system` |
|
| **Vision (Peekaboo)**| ✅ Active |
|
||||||
|
| **iMessage (imsg)** | ✅ Active |
|
||||||
|
| **Capabilities** | `browser`, `system`, `peekaboo`, `imsg`, `apple-notes` |
|
||||||
|
|
||||||
### MacBook launchd Services
|
### MacBook launchd Services
|
||||||
|
|
||||||
| Service | Status | Purpose |
|
| Service | Status | Purpose |
|
||||||
|---------|--------|---------|
|
|---------|--------|---------|
|
||||||
|
| `ai.openclaw.node` | Running | Primary Node service (v2026.3.8) |
|
||||||
|
| `ai.openclaw.gateway` | Unloaded | Disabled (remote node role) |
|
||||||
| `com.satware.openclaw-tunnel` | Running | SSH tunnel to gateway |
|
| `com.satware.openclaw-tunnel` | Running | SSH tunnel to gateway |
|
||||||
| `com.satware.openclaw-node` | Loaded | OpenClaw node process |
|
|
||||||
| `ai.openclaw.node` | Running | Node service |
|
|
||||||
| `ai.openclaw.gateway` | Running | Gateway service |
|
|
||||||
|
|
||||||
### Management Commands (on MacBook)
|
### Management Commands (on MacBook)
|
||||||
|
|
||||||
@@ -382,4 +415,4 @@ ssh -o BatchMode=yes -o ConnectTimeout=10 MWsatwareAG@100.64.0.12 'netstat -anv
|
|||||||
4. Add an automated daily health snapshot job and keep results in this repository.
|
4. Add an automated daily health snapshot job and keep results in this repository.
|
||||||
|
|
||||||
---
|
---
|
||||||
*Last updated: 2026-03-04*
|
*Last updated: 2026-03-11*
|
||||||
|
|||||||
Reference in New Issue
Block a user