运行时依赖
安装命令
点击复制本土化适配说明
Yandex 天气智能家居 安装说明: 安装命令:["openclaw skills install yandex-weather-smarthome"] 支持国内镜像加速,使用 --registry https://cn.longxiaskill.com 参数可加速下载
技能文档
Yandex Weather SmartHome 目的 使用此技能快速返回用户配置的家乡坐标的当前天气和短期预报。 数据源:Yandex Weather API(https://api.weather.yandex.ru/v2/forecast) 激活规则 当用户询问以下内容时自动激活: 当前天气("какая погода"、"погода сейчас"、"weather now") 短期预报("погода на сегодня"、"погода на завтра"、"forecast today/tomorrow") 天气状况("температура"、"ветер"、"осадки"、"condition"、"wind") 如果请求明显是关于天气的,但位置未指定,则使用环境变量中的配置的家乡坐标(除非用户明确请求其他城市/位置,否则不询问坐标)。 安全和保密 永远不要打印或暴露 YANDEX_WEATHER_KEY。 永远不要在文件中存储 API 密钥。 仅从环境变量中读取凭据。 如果密钥/配置缺失,解释哪个变量缺失的一句话。 执行工作流 运行本地脚本:python3 ~/.nanobot/workspace/skills/yandex-weather-smarthome/weather.py 如果用户要求结构化/原始输出,则运行:python3 ~/.nanobot/workspace/skills/yandex-weather-smarthome/weather.py --json 使用精确的固定多行模板返回天气结果,不要改述、压缩或重写标签/句子。 响应样式 非技术用户面向文本:除非用户询问,否则不提及标题、端点或内部实现。 始终包括:当前温度、感觉、状况、风速 当可用时包括今天/明天的预报。 使用清晰的单位(°C、м/с)。 严格输出契约 输出必须匹配相同的部分名称和字段标签: Сейчас -> Температура、Ощущается как、Погода、Ветер Сегодня -> Днём、Ночью、Описание Завтра -> Днём、Ночью、Описание 不要在标题中添加额外的单词(禁止:Сейчас дома、Сейчас у вас)。 不要合并多个字段到一个句子中。 不要改述为叙事风格。 如果值缺失,请保留相同的标签并打印 нет данных。 所需输出格式(使用确切的结构和标签): Сейчас: Температура:9 °C Ощущается как:4 °C Погода:облачно с прояснениями Ветер:4 м/с Сегодня: Днём:12 °C Ночью:1 °C Описание:пасмурно Завтра: Днём:18 °C Ночью:7 °C Описание:небольшой дождь 错误处理 如果所需的环境变量缺失:返回一个短的操作导向消息,命名缺失的变量。 如果 HTTP/API 错误:重试一次。 如果仍然失败,返回:"Не удалось получить погоду сейчас. Попробуйте чуть позже." 如果脚本返回部分数据:保留相同的模板并用 нет данных 填充缺失的值。 所需环境变量 YANDEX_WEATHER_KEY= YANDEX_WEATHER_LAT= YANDEX_WEATHER_LON= 如何获取 API 密钥(简短) 打开 Yandex Weather SmartHome 页面并进入个人柜台注册。 使用电话号码注册并接受用户协议。 注册后,从个人柜台复制 API 密钥。 将密钥导出为 YANDEX_WEATHER_KEY。 官方页面,包含 FAQ 和入门指南:https://yandex.ru/pogoda/b2b/smarthome 示例:export YANDEX_WEATHER_KEY="your_key" export YANDEX_WEATHER_LAT="52.721" export YANDEX_WEATHER_LON="41.452" 注释 脚本已经将天气状况本地化为俄语。 默认行为是文本输出;仅当需要结构化输出时使用 --json。