GoHome服务管理

技能简介

GoHome 是面向智能家居系统的 gRPC 服务管理工具，支持服务发现、插件检查、RPC 方法调用及 Prometheus 指标采集。

业务背景

GoHome服务管理帮助运维团队统一管理智能家居设备的gRPC服务。通过单一入口即可掌握全屋设备注册状态、快速排查插件异常，并直接调用设备指令完成调试或控制，同时自动输出标准化监控数据对接Grafana，实现设备健康度可视化。

落地案例：某家庭场景下，管理员登录GoHome查看当前在线的Roborock扫地机器人与Tado温控区域服务状态，发现客厅温控插件加载异常后重启服务；随后在安全授权下调用写入类RPC将卧室温度调至24℃，并通过抓取/gohome/metrics端点数据，在Grafana面板中实时追踪各设备响应延迟与调用成功率。

能做什么

• 列出已注册的服务与加载的插件
• 查看并调用 RPC 方法（含只读与写入操作）
• 管理 Roborock 扫地机器人与 Tado 温控区域
• 抓取 /gohome/metrics 端点数据供 Grafana 展示

使用说明

安装与配置

# Nix 插件安装
{ plugin = "github:joshp123/gohome"; systems = [ "x86_64-linux" "aarch64-linux" ]; }

环境变量设置

export GOHOME_HTTP_BASE="http://gohome:8080"
export GOHOME_GRPC_ADDR="gohome:9000"

基础用法

# 列出所有服务
gohome-cli services

# 查看插件详情
gohome-cli plugins

# 列出 RPC 方法
gohome-cli methods

# 调用具体 RPC
gohome-cli call <method>

# 验证指标输出
curl -s "${GOHOME_HTTP_BASE}/gohome/metrics" | rg -n "gohome_"

状态变更限制：写入类 RPC 须在用户明确授权后执行。

输入与输出

见下方输入与输出表格。

风险提示

• 写入操作可能导致设备状态变更，需二次确认
• gRPC 地址配置错误将导致连接失败
• metrics 端点暴露需配合网络隔离策略

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/local/gohome/SKILL.md
来源类型：GitHub 仓库