diff --git a/CHANGELOG.md b/CHANGELOG.md
index b2167df9f18..d55eb676c89 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -23,6 +23,7 @@ Docs: https://docs.openclaw.ai
 - Agents/process: tell agents to inspect background sessions with `process log` before sending interactive input and to use `waitingForInput`/`stdinWritable` hints from `log`/`poll`.
 - CLI/onboarding: improve setup, onboarding, configure, and channel command wayfinding so terminal flows explain the next useful command instead of relying on terse setup labels.
 - Agents/Codex: remove the configurable Codex dynamic-tools profile so Codex app-server always owns workspace, edit, patch, exec, process, and plan tools while OpenClaw integration tools remain available.
+- macOS app: update the Peekaboo bridge dependency to Peekaboo 3.0.0.
 
 ### Fixes
 
diff --git a/apps/macos/Package.resolved b/apps/macos/Package.resolved
index d495eb24b48..53cfd25cac2 100644
--- a/apps/macos/Package.resolved
+++ b/apps/macos/Package.resolved
@@ -1,5 +1,5 @@
 {
-  "originHash" : "45e1ade868f67cf9cac4811c3b8c8b7dab7cef3f932ddebac6e292fdf9d6973c",
+  "originHash" : "284269c447b94311beae65318f1912f813261bfdc559185028fc1233ce288efa",
   "pins" : [
     {
       "identity" : "axorcist",
@@ -42,8 +42,8 @@
       "kind" : "remoteSourceControl",
       "location" : "https://github.com/steipete/Peekaboo.git",
       "state" : {
-        "revision" : "bb57c83935ebc27aae69a23042a9f9fe6ca8e404",
-        "version" : "3.0.0-beta4"
+        "revision" : "41180ca7e391c2a05e7cfa9eb6390812805d4f22",
+        "version" : "3.0.0"
       }
     },
     {
diff --git a/apps/macos/Package.swift b/apps/macos/Package.swift
index 1a487e71456..36690db4208 100644
--- a/apps/macos/Package.swift
+++ b/apps/macos/Package.swift
@@ -19,7 +19,7 @@ let package = Package(
         .package(url: "https://github.com/swiftlang/swift-subprocess.git", from: "0.4.0"),
         .package(url: "https://github.com/apple/swift-log.git", from: "1.10.1"),
         .package(url: "https://github.com/sparkle-project/Sparkle", from: "2.9.0"),
-        .package(url: "https://github.com/steipete/Peekaboo.git", exact: "3.0.0-beta4"),
+        .package(url: "https://github.com/steipete/Peekaboo.git", exact: "3.0.0"),
         .package(path: "../shared/OpenClawKit"),
         .package(path: "../swabble"),
     ],