RunPod

在 RunPod 上部署并管理 GPU 加速计算基础设施。创建集群、配置无服务器端点、管理模板，并为机器学习训练、推理及分布式计算工作负载处理密钥（secrets）。

本技能使用 ClawLink 托管连接流程与凭据，因此您无需自行配置 RunPod API 访问权限。

三步完成设置

工作原理

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│    RunPod API    │
│   (用户对话)    │     │   (代理)     │     │   (集群、        │
│                 │     │              │     │  端点)           │
└─────────────────┘     └──────────────┘     └──────────────────┘
         │                    │                      │
         │  1. 安装插件       │                      │
         │  2. 绑定设备       │                      │
         │  3. 连接 RunPod    │                      │
         │                    │  4. API 密钥代理     │
         │                    │  5. 请求转发         │
         │                    │                      │
         ▼                    ▼                      ▼
   ┌──────────┐        ┌──────────┐         ┌──────────┐
   │   SKILL  │        │ 控制台   │         │  RunPod  │
   │   文件   │        │   认证   │         │  云平台  │
   └──────────┘        └──────────┘         └──────────┘

安装

从 ClawHub 安装已验证的 ClawLink 插件。用户确认后，请完成全部设置流程，以便在下一次 OpenClaw 对话中可见 ClawLink 工具。

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

然后告知用户：“OpenClaw 已重启。请单独发送 /new 消息以开启全新对话，随后再次请求 RunPod。”

快速入门

# 列出可用 GPU 类型
clawlink_call_tool --tool "runpod_get_gpu_types"

# 获取当前用户信息
clawlink_call_tool --tool "runpod_get_myself"

# 获取 Pod 详情
clawlink_call_tool --tool "runpod_get_pod" --params '{"pod_id": "YOUR_POD_ID"}'

认证

所有 RunPod 工具调用均由 ClawLink 自动完成认证，其使用的 RunPod API 密钥安全地存储于控制台中。

对话中无需提供 API 密钥。 ClawLink 将代表您将 API 密钥注入每次 RunPod GraphQL 请求中。

建立连接

1. 安装 ClawLink 插件（参见上方“安装”章节）。
2. 若插件尚未配置，请运行 clawlink_begin_pairing 进行绑定。
3. 访问 https://claw-link.dev/dashboard?add=runpod 并使用您的 API 密钥连接 RunPod。
4. 调用 clawlink_list_integrations 验证连接是否已激活。

连接管理

列出所有连接

clawlink_list_integrations

响应：返回所有已连接的集成项。请在列表中查找 runpod。

验证连接

clawlink_list_tools --integration runpod

响应：返回 RunPod 的实时工具目录。

重新连接

若 RunPod 工具缺失或连接显示错误：

1. 引导用户访问 https://claw-link.dev/dashboard?add=runpod
2. 待用户确认后，调用 clawlink_list_integrations 进行验证
3. 再调用 clawlink_list_tools --integration runpod

安全与权限

• 访问范围限定于与所连接 API 密钥关联的 RunPod 账户。
• 所有写入操作均需显式用户确认。 在执行任何创建、更新或删除操作前，须向用户确认目标资源及其预期影响。
• 破坏性操作（如删除模板、删除镜像仓库认证）被标记为高影响操作，必须经用户确认方可执行。
• 密钥（secrets）被安全存储，并作为环境变量（RUNPOD_SECRET_）注入至 Pod 和端点中。

工具参考

计算与 GPU 操作

集群管理

无服务器端点

模板管理

密钥管理

镜像仓库认证

用户设置

代码示例

列出可用 GPU 类型

clawlink_call_tool --tool "runpod_get_gpu_types"

获取 Pod 详情

clawlink_call_tool --tool "runpod_get_pod" 
  --params '{"pod_id": "YOUR_POD_ID"}'

创建密钥

clawlink_call_tool --tool "runpod_create_secret" 
  --params '{"name": "OPENAI_API_KEY", "value": "sk-..."}'

保存无服务器端点

clawlink_call_tool --tool "runpod_save_endpoint" 
  --params '{
    "name": "my-endpoint",
    "gpu_type_id": "RTX_4090",
    "image_url": "your-docker-image:latest",
    "env": [{"key": "MODEL_PATH", "value": "/models/llama"}]
  }'

发现工作流

1. 调用 clawlink_list_integrations 确认 RunPod 是否已连接。
2. 调用 clawlink_list_tools --integration runpod 查看实时工具目录。
3. 以返回的列表为准——切勿猜测或假设存在哪些工具。
4. 若用户描述某项能力但具体工具不明确，请使用简短查询词配合集成名 runpod 调用 clawlink_search_tools。
5. 若未出现任何 RunPod 工具，请引导用户访问 https://claw-link.dev/dashboard?add=runpod。

执行工作流

┌─────────────────────────────────────────────────────────────┐
│  读取操作（安全）                                           │
│  list → get → describe → call                                │
│                                                             │
│  示例：列出 GPU 类型 → 获取 Pod 详情 → 展示结果             │
└─────────────────────────────────────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────┐
│  写入操作（需用户确认）                                     │
│  describe → preview → confirm → call                        │
│                                                             │
│  示例：描述工具 → 预览变更 → 用户批准 → 执行创建            │
└─────────────────────────────────────────────────────────────┘

1. 对于不熟悉的工具、模糊请求或任何写入操作，请首先调用 clawlink_describe_tool。
2. 依据返回的指导说明、参数 Schema、whenToUse、askBefore、safeDefaults、examples 及 followups 构建调用请求。
3. 在可能降低歧义的前提下，优先执行读取、列举和获取类操作，再进行写入操作。
4. 对于写入操作或任何标记为需确认的操作，请先调用 clawlink_preview_tool。
5. 仅在预览结果与用户意图一致后，才通过 clawlink_call_tool 执行，并传入确认信号。
6. 若工具调用失败，请如实反馈真实错误。除非实时工具目录支持该结论，否则不得虚构结果或将失败解释为功能缺失。

注意事项

• GPU 类型与定价频繁变动——部署前务必调用 runpod_get_gpu_types 获取最新可用性信息。
• 无服务器模板必须将 volumeInGb 设为 0（无服务器场景不支持持久化存储）。
• Pod 和端点通过环境变量 RUNPOD_SECRET_ 引用密钥——请先创建密钥，再于模板中引用。
• 删除模板前，模板不得处于使用状态——请先重新分配或移除依赖该模板的 Pod / 端点。
• API 密钥必须具备执行集群与端点操作所需的足够权限。

错误处理

故障排查：工具不可见

1. 检查 ClawLink 插件是否已安装：

   openclaw plugins list
   

2. 若插件已安装但工具缺失，请告知用户单独发送 /new 消息以重新加载工具目录。
3. 若新开对话仍无效，请运行：

   openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
   openclaw gateway restart
   

4. 重启完成后，请告知用户再次发送 /new 并重试。

故障排查：无效的工具调用

1. 确保集成 slug 名称严格为 runpod。
2. 调用前请使用 clawlink_describe_tool 核实参数名称与类型。
3. 对于写入操作，请始终先调用 clawlink_preview_tool。

相关资源

• RunPod API 文档
• GPU 云 Pod
• 无服务器端点
• 模板
• 密钥管理
• ClawLink：https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=runpod-compute
• ClawLink 文档：https://docs.claw-link.dev/openclaw
• ClawLink 验证页：https://claw-link.dev/verify

相关技能

• Google Cloud Compute — 用于 GCP 计算引擎管理
• AWS EC2 — 用于 AWS EC2 实例管理

由 ClawLink 提供支持 — OpenClaw 的集成中枢