fix(app:macos): 【 OpenClaw ⇄ clawdbot 】- Peekaboo Bridge discovery after the OpenClaw rename by lumpinif · Pull Request #6033 · openclaw/openclaw

lumpinif · 2026-02-01T06:35:53Z

Summary

Fix Peekaboo Bridge discovery after the OpenClaw rename by keeping the canonical socket at ~/Library/Application Support/OpenClaw/bridge.sock.
Create/repair legacy compatibility symlinks at ~/Library/Application Support/clawdbot/bridge.sock and ~/Library/Application Support/clawdis/bridge.sock so older Peekaboo CLI builds keep connecting.
Harden legacy paths by replacing stale entries and enforcing 0700 permissions.

Testing

pnpm lint

AI assistance

AI-assisted (Codex).

greptile-apps

_{1 file reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}

apps/macos/Sources/OpenClaw/PeekabooBridgeHostCoordinator.swift

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e0ea25ac1f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

apps/macos/Sources/OpenClaw/PeekabooBridgeHostCoordinator.swift

lumpinif · 2026-02-01T06:48:49Z

Short update: this fixes a real-world Peekaboo Bridge discovery issue. It keeps OpenClaw as the primary socket path and now repairs the legacy clawdbot symlink if a stale file/dir/wrong link exists. Lint passes (pnpm lint).

greptile-apps

_{1 file reviewed, 2 comments}

_{Edit Code Review Agent Settings | Greptile}

apps/macos/Sources/OpenClaw/PeekabooBridgeHostCoordinator.swift

lumpinif · 2026-02-01T06:57:13Z

@greptile-apps I addressed both points: the legacy directory now sets explicit 0700 permissions, and symlink target comparison is normalized to avoid repeated recreation. Please take another look.

greptile-apps

_{1 file reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}

apps/macos/Sources/OpenClaw/PeekabooBridgeHostCoordinator.swift

greptile-apps

_{No files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}

greptile-apps · 2026-02-01T07:09:34Z

Pull Request Summary

This PR fixes a compatibility issue caused by the OpenClaw rename from "clawdbot". The main problem was that older clients still look for the Peekaboo Bridge socket at the legacy path ~/Library/Application Support/clawdbot/bridge.sock.

What this PR does:

File changed: apps/macos/Sources/OpenClaw/PeekabooBridgeHostCoordinator.swift

Key changes:

Adds legacy socket path support
- Maintains the new socket at ~/Library/Application Support/OpenClaw/bridge.sock
- Creates a symlink at the old location ~/Library/Application Support/clawdbot/bridge.sock pointing to the new socket
Robust legacy path handling
- Creates the legacy directory structure with 0700 permissions
- Replaces any existing files or broken symlinks at the legacy path
- Validates existing symlinks point to the correct target before keeping them
Graceful error handling
- Logs failures but doesn't crash if symlink creation fails
- Uses debug-level logging to avoid noise

Impact:

Ensures backward compatibility for older clients during the transition period
Allows seamless discovery of the Peekaboo Bridge regardless of client version
Hardens the path handling to prevent issues with stale files or incorrect permissions

The implementation is clean and follows Swift best practices with proper error handling and resource management.

greptile-apps · 2026-02-01T07:11:51Z

Here's an updated PR description that better reflects the actual implementation:

Summary

This PR ensures backward compatibility for the Peekaboo Bridge socket after the OpenClaw rename by implementing automatic legacy symlink management.

What Changed

Primary socket location: Maintains the socket at ~/Library/Application Support/OpenClaw/bridge.sock
Legacy compatibility: Automatically creates and manages a symlink at ~/Library/Application Support/clawdbot/bridge.sock
Robust symlink handling:
- Creates the legacy directory structure with proper 0700 permissions
- Validates existing symlinks point to the correct destination
- Removes stale files or incorrect symlinks before creating new ones
- Gracefully handles errors without breaking the bridge startup

Implementation Details

Added legacySocketPath computed property for the old clawdbot socket path
Added ensureLegacySocketSymlink() method called during bridge startup
Uses FileManager APIs for directory creation, symlink validation, and cleanup
Includes error handling with debug logging for troubleshooting

Backwards Compatibility

This ensures older clients that still reference the clawdbot socket path can continue working without modification while the app uses its new OpenClaw branding.

Testing

pnpm lint

AI assistance

AI-assisted (Codex)

openclaw-barnacle · 2026-02-15T04:08:30Z

This pull request has been automatically marked as stale due to inactivity.
Please add updates or it will be closed.

…ter the OpenClaw rename (#6033) * fix(mac): keep OpenClaw bridge socket and harden legacy symlink * fix(mac): add clawdis legacy Peekaboo bridge symlink * macos: include moltbot in PeekabooBridge legacy socket paths * changelog: note peekaboo legacy socket compatibility paths --------- Co-authored-by: Vincent Koc <vincentkoc@ieee.org>

…ter the OpenClaw rename (openclaw#6033) * fix(mac): keep OpenClaw bridge socket and harden legacy symlink * fix(mac): add clawdis legacy Peekaboo bridge symlink * macos: include moltbot in PeekabooBridge legacy socket paths * changelog: note peekaboo legacy socket compatibility paths --------- Co-authored-by: Vincent Koc <vincentkoc@ieee.org>

openclaw-barnacle bot added the app: macos App: macos label Feb 1, 2026

greptile-apps bot reviewed Feb 1, 2026

View reviewed changes

apps/macos/Sources/OpenClaw/PeekabooBridgeHostCoordinator.swift Outdated Show resolved Hide resolved

chatgpt-codex-connector bot reviewed Feb 1, 2026

View reviewed changes

apps/macos/Sources/OpenClaw/PeekabooBridgeHostCoordinator.swift Outdated Show resolved Hide resolved

lumpinif changed the title ~~mac: keep OpenClaw bridge socket and add legacy symlink~~ fix(mac): keep OpenClaw bridge socket and add legacy symlink Feb 1, 2026

lumpinif force-pushed the fix/peekaboo-bridge-symlink branch 2 times, most recently from d3613da to 3e310ee Compare February 1, 2026 06:42

greptile-apps bot reviewed Feb 1, 2026

View reviewed changes

apps/macos/Sources/OpenClaw/PeekabooBridgeHostCoordinator.swift Outdated Show resolved Hide resolved

apps/macos/Sources/OpenClaw/PeekabooBridgeHostCoordinator.swift Show resolved Hide resolved

fix(mac): keep OpenClaw bridge socket and harden legacy symlink

d7a7b8e

lumpinif force-pushed the fix/peekaboo-bridge-symlink branch from d111003 to d7a7b8e Compare February 1, 2026 06:56

greptile-apps bot reviewed Feb 1, 2026

View reviewed changes

apps/macos/Sources/OpenClaw/PeekabooBridgeHostCoordinator.swift Show resolved Hide resolved

greptile-apps bot reviewed Feb 1, 2026

View reviewed changes

lumpinif changed the title ~~fix(mac): keep OpenClaw bridge socket and add legacy symlink~~ fix(mac): bridge socket legacy rename compatibility (OpenClaw ⇄ clawdbot) Feb 1, 2026

lumpinif changed the title ~~fix(mac): bridge socket legacy rename compatibility (OpenClaw ⇄ clawdbot)~~ fix(mac): (OpenClaw ⇄ clawdbot) bridge socket legacy rename compatibility Feb 1, 2026

lumpinif changed the title ~~fix(mac): (OpenClaw ⇄ clawdbot) bridge socket legacy rename compatibility~~ fix(mac): 「 OpenClaw ⇄ clawdbot 」- bridge socket legacy rename compatibility Feb 1, 2026

lumpinif changed the title ~~fix(mac): 「 OpenClaw ⇄ clawdbot 」- bridge socket legacy rename compatibility~~ fix(mac): 【 OpenClaw ⇄ clawdbot 】- bridge socket legacy rename compatibility Feb 1, 2026

lumpinif changed the title ~~fix(mac): 【 OpenClaw ⇄ clawdbot 】- bridge socket legacy rename compatibility~~ fix(mac): 【 OpenClaw ⇄ clawdbot 】- Peekaboo Bridge discovery after the OpenClaw rename Feb 1, 2026

lumpinif changed the title ~~fix(mac): 【 OpenClaw ⇄ clawdbot 】- Peekaboo Bridge discovery after the OpenClaw rename~~ fix(app:macos): 【 OpenClaw ⇄ clawdbot 】- Peekaboo Bridge discovery after the OpenClaw rename Feb 1, 2026

lumpinif and others added 9 commits February 1, 2026 15:35

fix(mac): add clawdis legacy Peekaboo bridge symlink

13df28f

Merge branch 'main' into fix/peekaboo-bridge-symlink

d8ad892

Merge branch 'main' into fix/peekaboo-bridge-symlink

3e247de

Merge branch 'main' into fix/peekaboo-bridge-symlink

f4c7215

Merge branch 'main' into fix/peekaboo-bridge-symlink

f9bb4bd

Merge branch 'main' into fix/peekaboo-bridge-symlink

cc9cf1f

Merge branch 'main' into fix/peekaboo-bridge-symlink

78edb6a

Merge branch 'main' into fix/peekaboo-bridge-symlink

8c99ce2

Merge branch 'main' into fix/peekaboo-bridge-symlink

4774671

lumpinif added 4 commits February 3, 2026 13:33

Merge branch 'main' into fix/peekaboo-bridge-symlink

2b6523d

Merge branch 'main' into fix/peekaboo-bridge-symlink

aa59244

Merge branch 'main' into fix/peekaboo-bridge-symlink

a064f87

Merge branch 'main' into fix/peekaboo-bridge-symlink

5cf7981

lumpinif mentioned this pull request Feb 3, 2026

[Bug]: Mac OS openclaw - Peekaboo Bridge discovery after the OpenClaw rename #8044

Open

lumpinif added 6 commits February 4, 2026 00:45

Merge branch 'main' into fix/peekaboo-bridge-symlink

06aefc9

Merge branch 'main' into fix/peekaboo-bridge-symlink

346f7da

Merge branch 'main' into fix/peekaboo-bridge-symlink

dc0401c

Merge branch 'main' into fix/peekaboo-bridge-symlink

e8240a4

Merge branch 'main' into fix/peekaboo-bridge-symlink

a1f29d1

Merge branch 'main' into fix/peekaboo-bridge-symlink

d1c9193

openclaw-barnacle bot added the stale Marked as stale due to inactivity label Feb 15, 2026

Merge branch 'main' into fix/peekaboo-bridge-symlink

dcd5613

openclaw-barnacle bot added the size: S label Feb 15, 2026

thewilloftheshadow force-pushed the main branch from bfc1ccb to f92900f Compare February 15, 2026 18:46

openclaw-barnacle bot removed the stale Marked as stale due to inactivity label Feb 16, 2026

Merge branch 'main' into fix/peekaboo-bridge-symlink

6f04a5b

This comment was marked as spam.

Sign in to view

lumpinif and others added 4 commits March 1, 2026 23:56

Merge branch 'main' into fix/peekaboo-bridge-symlink

d47d926

macos: include moltbot in PeekabooBridge legacy socket paths

e61ef60

changelog: note peekaboo legacy socket compatibility paths

eb51a0f

Merge branch 'main' into fix/peekaboo-bridge-symlink

eb48225

vincentkoc merged commit f1cd3ea into openclaw:main Mar 2, 2026
9 checks passed

Uh oh!

Conversation

lumpinif commented Feb 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Testing

AI assistance

Uh oh!

greptile-apps bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

lumpinif commented Feb 1, 2026

Uh oh!

greptile-apps bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

lumpinif commented Feb 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

greptile-apps bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

greptile-apps bot left a comment

Choose a reason for hiding this comment

Uh oh!

greptile-apps bot commented Feb 1, 2026

Pull Request Summary

What this PR does:

Key changes:

Impact:

Uh oh!

greptile-apps bot commented Feb 1, 2026

Summary

What Changed

Implementation Details

Backwards Compatibility

Testing

AI assistance

Uh oh!

openclaw-barnacle bot commented Feb 15, 2026

Uh oh!

This comment was marked as spam.

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

lumpinif commented Feb 1, 2026 •

edited

Loading

lumpinif commented Feb 1, 2026 •

edited

Loading