Alexa CLI

🔊 命令行掌控全屋 Alexa 生态

iot榜 #5

通过非官方 Alexa API 从命令行控制 Echo 设备及智能家居,支持语音播报、设备控制、LLM 对话及历史查询,需定期重新认证。

收藏
19.7k
安装
4k
版本
1.2.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Alexa CLI(alexacli)是一款开源命令行工具,通过逆向的 Amazon 非官方 API 实现对 Echo 设备的全功能操控。主要能力包括:

  • 设备发现:列出所有 Echo 设备并获取 JSON 格式数据
  • 语音播报:通过 speak 命令在指定设备或全局广播语音消息
  • 智能家居控制:使用自然语言 command 控制灯光、温控器、门锁、音乐播放等
  • 双向交互ask 命令发送询问并捕获 Alexa 的文本回复
  • Alexa+ LLM 对话askplus 支持多轮对话上下文保留
  • 音频播放:通过 SSML 播放指定 HTTPS MP3(需 48kbps/22050Hz)
  • 活动历史:查询近期语音交互记录

认证采用浏览器 OAuth 流程,Token 有效期约 14 天,配置存储于本地 ~/.alexa-cli/config.json。支持多区域账号(amazon.de/co.uk 等)。

显著优点

1. 自动化集成友好:纯 CLI 设计,便于脚本化、CI/CD 流水线及 AI Agent 调用
2. 自然语言控制:无需记忆具体设备 ID,直接说"turn off the living room lights"

3. 双向数据流ask/askplus 支持获取响应数据,突破传统单向控制的局限

4. 跨平台安装:支持 Homebrew 和 Go 两种安装方式

5. LLM 原生支持:内置 Alexa+ 对话管理,可处理多轮上下文

潜在缺点与局限性

  • 非官方 API 风险:依赖 Amazon 未公开的内部接口,随时可能因平台变更而失效
  • 认证频繁:14 天 Token 有效期需定期人工或脚本化重新认证
  • 音频格式受限:MP3 播放有严格的码率和采样率要求
  • 无官方 SLA:无企业级支持,功能稳定性取决于维护者持续逆向投入
  • 隐私顾虑:凭证存储于本地明文 JSON,历史查询可能暴露敏感语音记录

适合人群

  • 智能家居自动化爱好者及 Home Assistant 进阶用户
  • 需要语音通知集成的开发者(构建完成、服务器告警等场景)
  • AI Agent 构建者,希望赋予系统物理世界交互能力
  • 多 Echo 家庭用户,厌烦频繁打开 Alexa App 操作

常规风险

  • 账号安全:非官方工具需授予 Amazon 账户权限,存在凭证泄露或滥用的理论风险
  • 服务中断:Amazon 可随时封禁或变更 API,导致工具突然失效
  • 数据残留:本地存储的认证令牌和历史记录需手动清理
  • 区域限制:部分功能可能因 Amazon 区域策略差异而表现不一致

Alexa CLI 内容

手动下载zip · 2.1 kB
skill.mdtext/markdown
请选择文件