# Send LobsterLAN to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "lobsterlan",
    "name": "LobsterLAN",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/danielithomas/lobsterlan",
    "canonicalUrl": "https://clawhub.ai/danielithomas/lobsterlan",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/lobsterlan",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=lobsterlan",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "config/peers.example.json",
      "scripts/lobsterlan.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "lobsterlan",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T10:44:57.258Z",
      "expiresAt": "2026-05-07T10:44:57.258Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=lobsterlan",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=lobsterlan",
        "contentDisposition": "attachment; filename=\"lobsterlan-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "lobsterlan"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/lobsterlan"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/lobsterlan",
    "downloadUrl": "https://openagent3.xyz/downloads/lobsterlan",
    "agentUrl": "https://openagent3.xyz/skills/lobsterlan/agent",
    "manifestUrl": "https://openagent3.xyz/skills/lobsterlan/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/lobsterlan/agent.md"
  }
}
```
## Documentation

### LobsterLAN — Agent-to-Agent Communication

Talk to other OpenClaw agents on your LAN.

### Setup

Copy config/peers.example.json to config/peers.json
Fill in peer hostnames, ports, and tokens
Ensure target agents have the required APIs enabled (see below)
Set up a secure transport (see Network Transport below)

### Required Config on Target Agent

For sync ask (chat completions):

// Target agent's openclaw.json — keep bind as "loopback"!
{
  "gateway": {
    "http": {
      "endpoints": {
        "chatCompletions": { "enabled": true }
      }
    }
  }
}

⚠️ Do NOT set gateway.bind to "lan" — OpenClaw will refuse to start if the gateway is exposed on a non-loopback address without TLS. Use a secure transport instead (see below).

For async delegate (webhooks):

{
  "hooks": {
    "enabled": true,
    "token": "a-secure-shared-secret"
  }
}

### Network Transport

OpenClaw gateways default to bind: loopback and will not start with plaintext on non-loopback addresses. You need a secure transport layer for cross-host communication:

ApproachComplexityBest ForSSH Tunnel ⭐LowHome LANs, simple setupsReverse Proxy (TLS)MediumEnvironments with existing Caddy/nginxTailscale ServeMediumMulti-site or remote agents

For simple LANs, SSH tunneling is recommended. Both gateways stay on loopback, the SSH tunnel provides encryption, and no gateway config changes are needed.

### SSH Tunnel Example

Forward a local port to the remote agent's loopback gateway:

ssh -N -L 18790:127.0.0.1:18790 user@remote-agent-host

Then in peers.json, point the peer to 127.0.0.1:18790 (the local tunnel endpoint).

For persistence, use a systemd user service with Restart=always. See the full setup guide in docs/setup.md.

### Ask (synchronous — wait for reply)

scripts/lobsterlan.sh ask scotty "What is the CPU temperature?"

Use for quick questions where you need the answer now.

### Delegate (async — fire and forget)

scripts/lobsterlan.sh delegate scotty "Generate 5 zen wallpapers and push to the file share"

Use for long-running tasks. The peer processes independently.

### Status check

scripts/lobsterlan.sh status scotty

### List peers

scripts/lobsterlan.sh peers

### Agent Usage (from within OpenClaw)

Run via exec tool:

cd ~/.openclaw/workspace/skills/lobsterlan && scripts/lobsterlan.sh ask scotty "status report"

### Security

Three layers protect communication:

Network: LAN-only (firewall blocks external access to gateway port)
Gateway token: Bearer auth on every request
Agent ID header (optional): X-LobsterLAN-Agent sent with self-ID

The gateway token is the real security boundary. The agent ID header is defense-in-depth for environments where you want explicit identity verification.

### Environment Variables

LOBSTERLAN_CONFIG — path to peers.json (default: ../config/peers.json relative to script)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: danielithomas
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T10:44:57.258Z
- Expires at: 2026-05-07T10:44:57.258Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/lobsterlan)
- [Send to Agent page](https://openagent3.xyz/skills/lobsterlan/agent)
- [JSON manifest](https://openagent3.xyz/skills/lobsterlan/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/lobsterlan/agent.md)
- [Download page](https://openagent3.xyz/downloads/lobsterlan)