ring

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Ring Skill

Overview

概述

Enables Claude to interact with Ring for viewing doorbell and camera feeds, managing Ring Alarm, checking event history, and configuring device settings.

让Claude能够与Ring交互，查看门铃和摄像头画面、管理Ring Alarm、查看事件历史记录以及配置设备设置。

Quick Install

快速安装

bash

curl -sSL https://canifi.com/skills/ring/install.sh | bash

Or manually:

bash

cp -r skills/ring ~/.canifi/skills/

bash

curl -sSL https://canifi.com/skills/ring/install.sh | bash

或者手动安装：

bash

cp -r skills/ring ~/.canifi/skills/

Setup

设置

Configure via canifi-env:

bash

undefined

通过canifi-env进行配置：

bash

undefined

First, ensure canifi-env is installed:

首先，确保已安装canifi-env：

curl -sSL https://canifi.com/install.sh | bash

canifi-env set RING_EMAIL "your-email@example.com"

undefined

canifi-env set RING_EMAIL "your-email@example.com"

undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.

你的凭证，由你掌控。 Canifi LifeOS尊重你的隐私。

Option 1: Manual Browser Login (Recommended)

选项1：手动浏览器登录（推荐）

If you prefer not to share credentials with Claude Code:

Complete the Browser Automation Setup using CDP mode
Login to the service manually in the Playwright-controlled Chrome window
Claude will use your authenticated session without ever seeing your password

如果你不想与Claude Code共享凭证：

使用CDP模式完成浏览器自动化设置
在Playwright控制的Chrome窗口中手动登录该服务
Claude将使用你的已认证会话，全程不会获取你的密码

Option 2: Environment Variables

选项2：环境变量

If you're comfortable sharing credentials, you can store them locally:

bash

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.

如果你愿意共享凭证，可以将其存储在本地：

bash

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

注意：存储在canifi-env中的凭证仅能在你的本地设备上访问，绝不会被传输。

Capabilities

功能特性

View live camera and doorbell feeds
Check motion and ring event history
Manage Ring Alarm system
Configure motion zones and sensitivity
View and download video clips

查看摄像头和门铃的实时画面
查看移动侦测和门铃触发的事件历史
管理Ring Alarm系统
配置移动侦测区域和灵敏度
查看并下载视频片段

Usage Examples

使用示例

Example 1: Check Doorbell

示例1：查看门铃记录

User: "Who rang the doorbell while I was out?"
Claude: I'll check the Ring doorbell history for recent visitors.

用户：“我外出期间谁按了门铃？”
Claude：我将查看Ring门铃的近期访客历史记录。

Example 2: Alarm Control

示例2：报警系统控制

User: "Arm the Ring alarm in home mode"
Claude: I'll set your Ring Alarm to Home mode.

用户：“将Ring报警系统设置为在家模式”
Claude：我会将你的Ring Alarm设置为在家模式。

Example 3: Camera Status

示例3：摄像头状态检查

User: "Are all my Ring cameras online?"
Claude: I'll check the status of all your Ring cameras.

用户：“我的所有Ring摄像头都在线吗？”
Claude：我将检查所有Ring摄像头的状态。

Authentication Flow

认证流程

Navigate to ring.com via Playwright MCP
Click "Log In" button
Enter Ring credentials
Handle 2FA via email or text
Maintain session for subsequent requests

通过Playwright MCP导航至ring.com
点击“登录”按钮
输入Ring凭证
通过邮件或短信处理双因素认证（2FA）
维持会话以用于后续请求

Error Handling

错误处理

Login Failed: Retry authentication up to 3 times, then notify via iMessage
Session Expired: Re-authenticate automatically
2FA Required: Wait for code via email/SMS
Rate Limited: Implement exponential backoff
Device Offline: Report device connectivity

登录失败：最多重试3次认证，随后通过iMessage通知用户
会话过期：自动重新认证
需要双因素认证：等待邮件/短信验证码
请求受限：实现指数退避策略
设备离线：报告设备连接状态

Self-Improvement Instructions

自我改进说明

When encountering new UI patterns:

Document Ring app/web changes
Update selectors for new layouts
Track new device features
Monitor subscription changes

遇到新的UI模式时：

记录Ring应用/网页的变更
更新针对新布局的选择器
追踪新的设备功能
监控订阅服务的变更

Notes

注意事项

Ring Protect plan for video history
Neighbors app for community alerts
Alexa integration available
Professional monitoring optional

需订阅Ring Protect计划以查看视频历史
Neighbors应用可获取社区警报
支持与Alexa集成
可选专业监控服务