Update docs for OpenClaw v2026.3.8, peekaboo, and imsg integration
Co-authored-by: Junie <junie@jetbrains.com>
This commit is contained in:
Junie
@@ -4,6 +4,20 @@ All notable changes to this repository are documented in this file.
|
||||
|
||||
## [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)
|
||||
|
||||
### Added
|
||||
|
||||
@@ -9,12 +9,12 @@ This repository documents the OpenClaw gateway integration for the satware AG Ma
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Hostname** | satware-AG-MacBook-Pro.local |
|
||||
| **OS** | macOS 26.3 (Tahoe) |
|
||||
| **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.2 |
|
||||
| **OpenClaw Version** | core v2026.3.8 |
|
||||
|
||||
## 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 │
|
||||
│ (Tool Node) │◄──────────────────►│ (Gateway Host) │
|
||||
│ │ │ │
|
||||
│ OpenClaw.app │ WebSocket │ agent-zero │
|
||||
│ (remote mode) │◄──────────────────►│ Docker container │
|
||||
│ │ ws://:18789 │ Port 18789 │
|
||||
│ OpenClaw Node │ WebSocket │ OpenClaw Gateway │
|
||||
│ (remote mode) │◄──────────────────►│ (100.64.0.39) │
|
||||
│ v2026.3.8 │ Port 18789 │ Port 18789 │
|
||||
│ │ │ │
|
||||
│ SSH Client │ SSH Tunnel │ SSH Server │
|
||||
│ │──────────────────►│ Port 2222 │
|
||||
@@ -42,11 +42,17 @@ This repository documents the OpenClaw gateway integration for the satware AG Ma
|
||||
### MacBook OpenClaw Config (`~/.openclaw/openclaw.json`)
|
||||
```json
|
||||
{
|
||||
"mode": "remote",
|
||||
"remote": {
|
||||
"sshIdentity": "/Users/MWsatwareAG/.ssh/id_ed25519",
|
||||
"sshTarget": "root@100.64.0.39:2222",
|
||||
"url": "ws://100.64.0.39:18789"
|
||||
"meta": {
|
||||
"lastTouchedVersion": "2026.3.8"
|
||||
},
|
||||
"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"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
@@ -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 |
|
||||
| **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 |
|
||||
| **screen** | `screen.record` | ❌ Not in allowlist for 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
|
||||
|
||||
### 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
|
||||
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 |
|
||||
| `/sbin/ifconfig en0` | ✅ | Network interface info |
|
||||
| `/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` |
|
||||
| `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
|
||||
|
||||
@@ -305,23 +337,24 @@ glab auth login --hostname gitlab.satware.com --token <TOKEN>
|
||||
|
||||
## Verification Status
|
||||
|
||||
**Last Verified**: 2026-03-04 20:27 CET
|
||||
**Last Verified**: 2026-03-11 23:15 CET
|
||||
|
||||
| Component | Status |
|
||||
|-----------|--------|
|
||||
| **Node Connection** | ✅ Connected |
|
||||
| **Gateway Health** | ✅ OK (33ms) |
|
||||
| **Node Connection** | ✅ Paired & Connected |
|
||||
| **Gateway Health** | ✅ OK (158ms via Tailscale) |
|
||||
| **system.run** | ✅ Working |
|
||||
| **Capabilities** | `browser`, `system` |
|
||||
| **Vision (Peekaboo)**| ✅ Active |
|
||||
| **iMessage (imsg)** | ✅ Active |
|
||||
| **Capabilities** | `browser`, `system`, `peekaboo`, `imsg`, `apple-notes` |
|
||||
|
||||
### MacBook launchd Services
|
||||
|
||||
| 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-node` | Loaded | OpenClaw node process |
|
||||
| `ai.openclaw.node` | Running | Node service |
|
||||
| `ai.openclaw.gateway` | Running | Gateway service |
|
||||
|
||||
### 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.
|
||||
|
||||
---
|
||||
*Last updated: 2026-03-04*
|
||||
*Last updated: 2026-03-11*
|
||||
|
||||
Reference in New Issue
Block a user