github/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-04-19 04:47:26 +00:00
Code Issues Packages Projects Releases Wiki Activity

refactor: rename to openclaw

Browse Source
This commit is contained in:
Peter Steinberger
2026-01-30 03:15:10 +01:00
parent 4583f88626
commit 9a7160786a
2357 changed files with 16688 additions and 16788 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
docs/platforms/macos.md
View File

@@ -1,12 +1,12 @@
---
summary: "Moltbot macOS companion app (menu bar + gateway broker)"
summary: "OpenClaw macOS companion app (menu bar + gateway broker)"
read_when:
- Implementing macOS app features
- Changing gateway lifecycle or node bridging on macOS
---
# Moltbot macOS Companion (menu bar + gateway broker)
# OpenClaw macOS Companion (menu bar + gateway broker)
The macOS app is the **menu‑bar companion** for Moltbot. It owns permissions,
The macOS app is the **menu‑bar companion** for OpenClaw. It owns permissions,
manages/attaches to the Gateway locally (launchd or manual), and exposes macOS
capabilities to the agent as a node.
@@ -19,12 +19,12 @@ capabilities to the agent as a node.
- Exposes macOS‑only tools (Canvas, Camera, Screen Recording, `system.run`).
- Starts the local node host service in **remote** mode (launchd), and stops it in **local** mode.
- Optionally hosts **PeekabooBridge** for UI automation.
- Installs the global CLI (`moltbot`) via npm/pnpm on request (bun not recommended for the Gateway runtime).
- Installs the global CLI (`openclaw`) via npm/pnpm on request (bun not recommended for the Gateway runtime).
## Local vs remote mode
- **Local** (default): the app attaches to a running local Gateway if present;
otherwise it enables the launchd service via `moltbot gateway install`.
otherwise it enables the launchd service via `openclaw gateway install`.
- **Remote**: the app connects to a Gateway over SSH/Tailscale and never starts
a local process.
The app starts the local **node host service** so the remote Gateway can reach this Mac.
@@ -33,7 +33,7 @@ The app does not spawn the Gateway as a child process.
## Launchd control
The app manages a per‑user LaunchAgent labeled `bot.molt.gateway`
(or `bot.molt.<profile>` when using `--profile`/`CLAWDBOT_PROFILE`; legacy `com.clawdbot.*` still unloads).
(or `bot.molt.<profile>` when using `--profile`/`OPENCLAW_PROFILE`; legacy `com.openclaw.*` still unloads).
```bash
launchctl kickstart -k gui/$UID/bot.molt.gateway
@@ -43,7 +43,7 @@ launchctl bootout gui/$UID/bot.molt.gateway
Replace the label with `bot.molt.<profile>` when running a named profile.
If the LaunchAgent isn’t installed, enable it from the app or run
`moltbot gateway install`.
`openclaw gateway install`.
## Node capabilities (mac)
@@ -74,7 +74,7 @@ Gateway -> Node Service (WS)
Security + ask + allowlist are stored locally on the Mac in:
```
~/.clawdbot/exec-approvals.json
~/.openclaw/exec-approvals.json
```
Example:
@@ -105,14 +105,14 @@ Notes:
## Deep links
The app registers the `moltbot://` URL scheme for local actions.
The app registers the `openclaw://` URL scheme for local actions.
### `moltbot://agent`
### `openclaw://agent`
Triggers a Gateway `agent` request.
```bash
open 'moltbot://agent?message=Hello%20from%20deep%20link'
open 'openclaw://agent?message=Hello%20from%20deep%20link'
```
Query parameters:
@@ -129,7 +129,7 @@ Safety:
## Onboarding flow (typical)
1) Install and launch **Moltbot.app**.
1) Install and launch **OpenClaw.app**.
2) Complete the permissions checklist (TCC prompts).
3) Ensure **Local** mode is active and the Gateway is running.
4) Install the CLI if you want terminal access.
@@ -137,7 +137,7 @@ Safety:
## Build & dev workflow (native)
- `cd apps/macos && swift build`
- `swift run Moltbot` (or Xcode)
- `swift run OpenClaw` (or Xcode)
- Package app: `scripts/package-mac-app.sh`
## Debug gateway connectivity (macOS CLI)
@@ -147,8 +147,8 @@ logic that the macOS app uses, without launching the app.
```bash
cd apps/macos
swift run moltbot-mac connect --json
swift run moltbot-mac discover --timeout 3000 --json
swift run openclaw-mac connect --json
swift run openclaw-mac discover --timeout 3000 --json
```
Connect options:
@@ -163,7 +163,7 @@ Discovery options:
- `--timeout <ms>`: overall discovery window (default: `2000`)
- `--json`: structured output for diffing
Tip: compare against `moltbot gateway discover --json` to see whether the
Tip: compare against `openclaw gateway discover --json` to see whether the
macOS app’s discovery pipeline (NWBrowser + tailnet DNS‑SD fallback) differs from
the Node CLI’s `dns-sd` based discovery.