let5see/clawdbot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: make remote host examples generic

Browse Source
This commit is contained in:
Peter Steinberger
2026-01-12 02:11:33 +00:00
parent 4ced7b886e
commit d97c211e82
8 changed files with 14 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/cli/gateway.md
View File

@@ -92,7 +92,7 @@ The macOS app “Remote over SSH” mode uses a local port-forward so the remote
CLI equivalent: CLI equivalent:
```bash ```bash
clawdbot gateway status --ssh steipete@peters-mac-studio-1 clawdbot gateway status --ssh user@gateway-host
``` ```
Options: Options:

2
docs/experiments/research/memory.md
View File

@@ -192,7 +192,7 @@ Offline-friendly alternatives (in increasing complexity):
- SuCo (research-grade; attractive if there’s a solid implementation you can embed) - SuCo (research-grade; attractive if there’s a solid implementation you can embed)
Open question: Open question:
- what’s the **best** offline embedding model for “personal assistant memory” on your machines (MacBook + Castle)? - what’s the **best** offline embedding model for “personal assistant memory” on your machines (laptop + desktop)?
- if you already have Ollama: embed with a local model; otherwise ship a small embedding model in the toolchain. - if you already have Ollama: embed with a local model; otherwise ship a small embedding model in the toolchain.
## Smallest useful pilot ## Smallest useful pilot

2
docs/gateway/configuration.md
View File

@@ -1726,7 +1726,7 @@ Notes:
### Local models (LM Studio) — recommended setup ### Local models (LM Studio) — recommended setup
Best current local setup (what we’re running): **MiniMax M2.1** on a beefy Mac Studio Best current local setup (what we’re running): **MiniMax M2.1** on a powerful local machine
via **LM Studio** using the **Responses API**. via **LM Studio** using the **Responses API**.
```json5 ```json5

4
docs/gateway/remote-gateway-readme.md
View File

@@ -11,7 +11,7 @@ Clawdbot.app uses SSH tunneling to connect to a remote gateway. This guide shows
``` ```
┌─────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────┐
│ MacBook │ │ Client Machine │
│ │ │ │
│ Clawdbot.app ──► ws://127.0.0.1:18789 (local port) │ │ Clawdbot.app ──► ws://127.0.0.1:18789 (local port) │
│ │ │ │ │ │
@@ -150,4 +150,4 @@ launchctl bootout gui/$UID/com.clawdbot.ssh-tunnel
| `KeepAlive` | Automatically restarts tunnel if it crashes | | `KeepAlive` | Automatically restarts tunnel if it crashes |
| `RunAtLoad` | Starts tunnel when the agent loads | | `RunAtLoad` | Starts tunnel when the agent loads |
Clawdbot.app connects to `ws://127.0.0.1:18789` on your MacBook. The SSH tunnel forwards that connection to port 18789 on the remote machine where the Gateway is running. Clawdbot.app connects to `ws://127.0.0.1:18789` on your client machine. The SSH tunnel forwards that connection to port 18789 on the remote machine where the Gateway is running.

2
docs/gateway/remote.md
View File

@@ -5,7 +5,7 @@ read_when:
--- ---
# Remote access (SSH, tunnels, and tailnets) # Remote access (SSH, tunnels, and tailnets)
This repo supports “remote over SSH” by keeping a single Gateway (the master) running on a host (e.g., your Mac Studio) and connecting clients to it. This repo supports “remote over SSH” by keeping a single Gateway (the master) running on a dedicated host (desktop/server) and connecting clients to it.
- For **operators (you / the macOS app)**: SSH tunneling is the universal fallback. - For **operators (you / the macOS app)**: SSH tunneling is the universal fallback.
- For **nodes (iOS/Android and future devices)**: prefer the Gateway **Bridge** when on the same LAN/tailnet (see [Discovery](/gateway/discovery)). - For **nodes (iOS/Android and future devices)**: prefer the Gateway **Bridge** when on the same LAN/tailnet (see [Discovery](/gateway/discovery)).

2
docs/platforms/mac/remote.md
View File

@@ -6,7 +6,7 @@ read_when:
# Remote Clawdbot (macOS ⇄ remote host) # Remote Clawdbot (macOS ⇄ remote host)
This flow lets the macOS app act as a full remote control for a Clawdbot gateway running on another host (e.g. a Mac Studio). All features—health checks, Voice Wake forwarding, and Web Chat—reuse the same remote SSH configuration from *Settings → General*. This flow lets the macOS app act as a full remote control for a Clawdbot gateway running on another host (desktop/server). All features—health checks, Voice Wake forwarding, and Web Chat—reuse the same remote SSH configuration from *Settings → General*.
## Modes ## Modes
- **Local (this Mac)**: Everything runs on the laptop. No SSH involved. - **Local (this Mac)**: Everything runs on the laptop. No SSH involved.

6
docs/plugins/voice-call.md
View File

@@ -22,6 +22,12 @@ Quick mental model:
- Configure under `plugins.entries.voice-call.config` - Configure under `plugins.entries.voice-call.config`
- Use `clawdbot voicecall …` or the `voice_call` tool - Use `clawdbot voicecall …` or the `voice_call` tool
## Where it runs (local vs remote)
The Voice Call plugin runs **inside the Gateway process**.
If you use a remote Gateway, install/configure the plugin on the **machine running the Gateway**, then restart the Gateway to load it.
## Install ## Install
### Option A: install from npm (recommended) ### Option A: install from npm (recommended)

2
docs/providers/minimax.md
View File

@@ -123,7 +123,7 @@ Configure via CLI:
**Best for:** local inference with LM Studio. **Best for:** local inference with LM Studio.
We have seen strong results with MiniMax M2.1 on powerful hardware (e.g. a We have seen strong results with MiniMax M2.1 on powerful hardware (e.g. a
beefy Mac Studio) using LM Studio's local server. desktop/server) using LM Studio's local server.
Configure via CLI: Configure via CLI:
- Run `clawdbot configure` - Run `clawdbot configure`