LeoYeAI/agent-master-skills / skills/bengii-gemini-fix
openclaw
FlaggedComprehensive guide for installing, configuring, operating, and troubleshooting OpenClaw — a self-hosted, multi-channel AI agent gateway. Use when the user asks about OpenClaw setup, configuration, channel management (WhatsApp/Telegram/Discord/Slack/iMessage/etc.), model provider setup, Gateway operations, multi-agent routing, security hardening, troubleshooting, or any maintenance task related to their local OpenClaw installation. Also use when encountering errors from `openclaw` CLI commands or the Gateway daemon.
references/presence_discovery.md
View on GitHub# Presence & Discovery
> Sources:
> - https://docs.openclaw.ai/concepts/presence
> - https://docs.openclaw.ai/gateway/discovery
> - https://docs.openclaw.ai/gateway/bonjour
## Presence
### Presence Fields
Each presence entry contains information about a connected client, node, or the gateway itself.
### Producers (Where Presence Comes From)
1. **Gateway self entry**: Gateway publishes its own presence on start.
2. **WebSocket connect**: Each WS client registers presence on connect.
3. **system-event beacons**: Periodic beacons from clients.
4. **Node connects (`role: node`)**: Nodes register with device info and capabilities.
### Merge + Dedupe Rules
- `instanceId` is the dedup key to prevent duplicate entries.
- Multiple connections from the same instance are merged.
### TTL and Bounded Size
- Entries have a configurable TTL and are pruned when expired.
- Max entries are bounded to prevent memory issues.
### Consumers
- macOS app Instances tab shows connected clients.
- Control UI shows connected clients and nodes.
- CLI: `openclaw system presence`.
---
## Discovery & Transports
### Discovery Inputs
How clients learn where the Gateway is:
#### 1. Bonjour / mDNS (LAN Only)
- Gateway advertises itself on the local network via Bonjour/mDNS.
- macOS and iOS clients auto-discover Gateway on the same LAN.
#### 2. Tailnet (Cross-Network)
- Gateway registers with Tailscale for cross-network access.
- Clients discover Gateway via Tailscale MagicDNS.
#### 3. Manual / SSH Target
- Users manually configure the Gateway address.
- SSH tunnel can be used as transport.
### Transport Selection (Client Policy)
- Clients choose between direct WS and SSH-tunneled WS.
- Direct is preferred when available (LAN/Tailnet).
- SSH fallback for remote access without Tailscale.
### Pairing + Auth (Direct Transport)
- All transports require the standard WS handshake.
- Auth tokens apply regardless of transport type.
### Responsibilities by Component
| Component | Responsibility |
|---|---|
| Gateway | Advertise via Bonjour, accept WS connections |
| macOS App | Discover via Bonjour/Tailnet, connect via WS |
| iOS App | Discover via Bonjour, connect via WS |
| CLI | Manual config, connect via WS |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |