Grafana

通过托管凭证，使用 Grafana HTTP API 访问 Grafana。可查看仪表板、文件夹、数据源、告警规则、团队及可观测性资源。

本技能使用 ClawLink 实现托管连接流程与凭证管理，您无需自行配置 Grafana API 访问权限。

三步完成配置

工作原理

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│     Grafana      │
│   (用户聊天)    │     │   (OAuth)    │     │   (HTTP API)     │
└─────────────────┘     └──────────────┘     └──────────────────┘
         │                       │                       │
         │  1. 安装插件          │                       │
         │  2. 绑定设备          │                       │
         │  3. 连接 Grafana      │                       │
         │                       │  4. 获取安全令牌      │
         │                       │  5. 代理请求          │
         │                       │                       │
         ▼                       ▼                       ▼
   ┌──────────┐           ┌──────────┐           ┌──────────┐
   │  SKILL   │           │ 仪表板   │           │  Grafana │
   │  文件    │           │ 认证     │           │  Cloud   │
   └──────────┘           └──────────┘           └──────────┘

安装

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

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

随后告知用户：“OpenClaw 已重启。请单独发送 /new 消息以开启全新对话，然后再次询问 Grafana 相关功能。”

快速入门

# 列出所有仪表板
clawlink_call_tool --tool "grafana_list_dashboards" --params '{}'

# 获取指定仪表板
clawlink_call_tool --tool "grafana_get_dashboard" --params '{"uid": "YOUR_DASHBOARD_UID"}'

# 列出所有文件夹
clawlink_call_tool --tool "grafana_list_folders" --params '{}'

认证机制

所有 Grafana 工具调用均由 ClawLink 自动完成认证，所用凭证为已配置的 Grafana 凭据（API 密钥或服务账号令牌）。

聊天中无需提供 API 密钥。 ClawLink 安全地存储凭证，并代表用户将凭证注入每一次 Grafana API 请求。

建立连接

1. 安装 ClawLink 插件（参见上方“安装”章节）。
2. 若插件尚未配置，请运行 clawlink_begin_pairing 启动配对流程。
3. 访问 https://claw-link.dev/dashboard?add=grafana 并连接 Grafana。
4. 调用 clawlink_list_integrations 验证连接是否已激活。

连接管理

列出所有连接

clawlink_list_integrations

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

验证连接状态

clawlink_list_tools --integration grafana

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

重新连接

若 Grafana 工具缺失或连接显示错误，请执行以下操作：

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

安全与权限

• 访问范围受限于所配置 Grafana API 密钥或服务账号所能访问的资源。
• 所有写入操作均需显式获得用户确认。 在执行任何创建、更新或删除操作前，须向用户明确说明目标资源及其预期影响。
• 破坏性操作（如删除仪表板、删除文件夹、删除告警规则）被标记为高影响操作，必须经用户确认后方可执行。

工具参考

仪表板操作

文件夹管理

数据源

告警规则

告警实例

团队

管理员与组织

代码示例

列出仪表板

clawlink_call_tool --tool "grafana_list_dashboards" 
  --params '{
    "limit": 50
  }'

获取仪表板

clawlink_call_tool --tool "grafana_get_dashboard" 
  --params '{
    "uid": "YOUR_DASHBOARD_UID"
  }'

创建新仪表板

clawlink_call_tool --tool "grafana_create_dashboard" 
  --params '{
    "dashboard": {
      "title": "Service Health Overview",
      "tags": ["health", "overview"],
      "timezone": "browser",
      "panels": []
    },
    "folderUid": "YOUR_FOLDER_UID"
  }'

列出文件夹

clawlink_call_tool --tool "grafana_list_folders" 
  --params '{}'

列出数据源

clawlink_call_tool --tool "grafana_list_datasources" 
  --params '{}'

创建告警规则

clawlink_call_tool --tool "grafana_create_alert_rule" 
  --params '{
    "title": "High Error Rate",
    "condition": "C",
    "data": [
      {"refId": "A", "queryType": "prometheus"},
      {"refId": "B", "queryType": "reduce"},
      {"refId": "C", "queryType": "threshold"}
    ],
    "folderUID": "YOUR_FOLDER_UID"
  }'

发现工作流

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

执行工作流

┌─────────────────────────────────────────────────────────────┐
│  读取操作（安全）                                           │
│  list → get → call                                          │
│                                                             │
│  示例：列出仪表板 → 获取详情 → 展示结果                   │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  写入操作（需用户确认）                                    │
│  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. 若工具调用失败，请如实反馈原始错误信息。不得虚构结果，也不得将失败简单归因为“能力缺失”，除非实时目录明确支持该结论。

注意事项

• Grafana 支持 Grafana Cloud 及自托管实例（OSS/Enterprise）。
• API 访问需具备适当角色的 API 密钥或服务账号令牌。
• 仪表板 UID 是用于共享与 API 调用的稳定标识符。
• 文件夹 UID 用于组织仪表板与告警规则。
• 告警规则必须置于某个文件夹中，并引用一个数据源。
• 可通过配置仪表板与文件夹的权限来控制访问范围。

错误处理

排查：工具不可见

1. 确认 ClawLink 插件已安装：

   openclaw plugins list
   

2. 若插件已安装但工具仍不可见，请提示用户单独发送 /new 消息以重新加载工具目录。
3. 若新建对话仍未解决问题，请运行：

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

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

排查：无效的工具调用

1. 确保集成 slug 精确为 grafana。
2. 调用前请使用 clawlink_describe_tool 验证参数名与类型。
3. 对于写入操作，请始终先调用 clawlink_preview_tool。

相关资源

• Grafana HTTP API 文档
• 仪表板 API
• 告警 API
• ClawLink：https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=grafana-monitoring
• ClawLink 文档：https://docs.claw-link.dev/openclaw
• ClawLink 验证页：https://claw-link.dev/verify

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