# Send GPU Bridge to your agent
Use the source page and any available docs to guide the install because the item currently does not return a direct package file.
## Fast path
- Open the source page via Open source listing.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required. Then review README.md for any prerequisites, environment setup, or post-install checks.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need. Then review README.md for any prerequisites, environment setup, or post-install checks.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-gpu-bridge",
    "name": "GPU Bridge",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/homeofe/openclaw-gpu-bridge",
    "canonicalUrl": "https://clawhub.ai/homeofe/openclaw-gpu-bridge",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/openclaw-gpu-bridge",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-gpu-bridge",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CHANGELOG.md",
      "README.md",
      "SKILL.md",
      "gpu-service/README.md",
      "gpu-service/__init__.py",
      "gpu-service/device.py"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "openclaw-gpu-bridge",
      "status": "source_issue",
      "reason": "not_found",
      "recommendedAction": "review_source",
      "checkedAt": "2026-05-01T15:24:31.553Z",
      "expiresAt": "2026-05-02T15:24:31.553Z",
      "httpStatus": 404,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-gpu-bridge",
      "contentType": "text/plain",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-gpu-bridge",
        "contentDisposition": null,
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "openclaw-gpu-bridge"
      },
      "scope": "item",
      "summary": "Known item issue.",
      "detail": "This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.",
      "primaryActionLabel": "Open source listing",
      "primaryActionHref": "https://clawhub.ai/homeofe/openclaw-gpu-bridge"
    },
    "validation": {
      "installChecklist": [
        "Open the source listing and confirm there is a real package or setup artifact available.",
        "Review SKILL.md before asking your agent to continue.",
        "Treat this source as manual setup until the upstream download flow is fixed."
      ],
      "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/openclaw-gpu-bridge",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-gpu-bridge",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-gpu-bridge/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-gpu-bridge/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-gpu-bridge/agent.md"
  }
}
```
## Documentation

### @elvatis_com/openclaw-gpu-bridge

OpenClaw plugin to offload ML tasks (BERTScore + embeddings) to one or many remote GPU hosts.

### v0.2 Highlights

Multi-GPU host pool (hosts[]) with:

round-robin or least-busy load balancing
automatic failover
periodic host health checks


Backward compatibility with v0.1 (serviceUrl / url)
Flexible model selection per request (model / model_type)
GPU service model caching (on-demand loading)
Optional transfer visibility via /status endpoint + batch progress logs

### Tools

gpu_health
gpu_info
gpu_status (new in v0.2)
gpu_bertscore
gpu_embed

### v0.2 (recommended)

{
  "plugins": {
    "@elvatis_com/openclaw-gpu-bridge": {
      "hosts": [
        {
          "name": "rtx-2080ti",
          "url": "http://your-gpu-host:8765",
          "apiKey": "gpu-key-1"
        },
        {
          "name": "rtx-3090",
          "url": "http://your-second-gpu-host:8765",
          "apiKey": "gpu-key-2"
        }
      ],
      "loadBalancing": "least-busy",
      "healthCheckIntervalSeconds": 30,
      "timeout": 45,
      "models": {
        "embed": "all-MiniLM-L6-v2",
        "bertscore": "microsoft/deberta-xlarge-mnli"
      }
    }
  }
}

### v0.1 compatibility

{
  "plugins": {
    "@elvatis_com/openclaw-gpu-bridge": {
      "serviceUrl": "http://your-gpu-host:8765",
      "apiKey": "gpu-key",
      "timeout": 45
    }
  }
}

### Config reference

hosts: array of GPU hosts (v0.2)
serviceUrl / url: legacy single-host config
loadBalancing: round-robin or least-busy
healthCheckIntervalSeconds: host health polling interval
timeout: request timeout for compute endpoints
apiKey: fallback API key for hosts that do not define per-host key
models.embed, models.bertscore: plugin-side default models

### GPU Service (Python) Setup

cd gpu-service
pip install -r requirements.txt
uvicorn gpu_service:app --host 0.0.0.0 --port 8765

Default models are warmed on startup:

Embed: all-MiniLM-L6-v2
BERTScore: microsoft/deberta-xlarge-mnli

Additional models are loaded on-demand and cached in memory.

### Environment variables

API_KEY: require X-API-Key for all endpoints except /health
GPU_MAX_CONCURRENT: max parallel jobs (default 2)
GPU_EMBED_BATCH: embedding chunk size for progress logging (default 32)
MODEL_BERTSCORE: default warm model for BERTScore
MODEL_EMBED: default warm model for embeddings
TORCH_DEVICE: force device (cuda, cpu, cuda:1)

### API Endpoints (GPU Service)

GET /health
GET /info
GET /status (queue + active jobs + progress)
POST /bertscore
POST /embed

### Request-level model override

/bertscore:

{
  "candidates": ["a"],
  "references": ["b"],
  "model_type": "microsoft/deberta-xlarge-mnli"
}

/embed:

{
  "texts": ["hello world"],
  "model": "sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2"
}

### Exposing to the Internet

If you expose your GPU service outside LAN, use defense-in-depth:

Pre-shared key auth (required)

Set API_KEY on service
Configure same key in plugin host config (apiKey)
Requests must include X-API-Key



TLS/HTTPS (required on public internet)

Recommended: nginx reverse proxy with Let’s Encrypt certs
Alternative: run uvicorn with SSL cert/key directly

### nginx reverse proxy example

server {
  listen 443 ssl http2;
  server_name gpu.example.com;

  ssl_certificate /etc/letsencrypt/live/gpu.example.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/gpu.example.com/privkey.pem;

  location / {
    proxy_pass http://127.0.0.1:8765;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}

### uvicorn SSL example

uvicorn gpu_service:app --host 0.0.0.0 --port 8765 \\
  --ssl-keyfile /path/key.pem \\
  --ssl-certfile /path/cert.pem

Optional: WireGuard VPN instead of public exposure

Keep service private behind VPN
Prefer private WireGuard IPs in plugin hosts[].url



Operational hardening

Firewall allowlist only OpenClaw server IP
Rate limiting at reverse proxy
Monitor logs and rotate keys periodically

### Development

npm run build
npm test

TypeScript runs in strict mode.

### License

MIT
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: homeofe
- Version: 0.2.1
## Source health
- Status: source_issue
- Known item issue.
- This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.
- Health scope: item
- Reason: not_found
- Checked at: 2026-05-01T15:24:31.553Z
- Expires at: 2026-05-02T15:24:31.553Z
- Recommended action: Open source listing
## Links
- [Detail page](https://openagent3.xyz/skills/openclaw-gpu-bridge)
- [Send to Agent page](https://openagent3.xyz/skills/openclaw-gpu-bridge/agent)
- [JSON manifest](https://openagent3.xyz/skills/openclaw-gpu-bridge/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/openclaw-gpu-bridge/agent.md)
- [Download page](https://openagent3.xyz/downloads/openclaw-gpu-bridge)