Otter.ai CLI

通过 otter 命令与 Otter.ai 会议笔记和转录稿进行交互的命令行工具。

前置条件

使用以下命令安装：
bash
uv tool install otterai-cli

使用以下命令升级：
bash
uv tool upgrade otterai-cli

使用以下命令进行身份验证：
bash
otter login

凭据通过 keyring 存储在操作系统密钥链中，~/.otterai/config.json 作为备用方案。

您也可以使用环境变量（OTTERAIUSERNAME、OTTERAIPASSWORD），其优先级最高。

命令

发言记录（会议笔记）

bash
otter speeches list # 列出所有发言记录
otter speeches list --days 7 # 最近7天
otter speeches list --folder Work # 按文件夹名称筛选（不区分大小写）
otter speeches list --folder 123456 # 按文件夹ID筛选
otter speeches list --page-size 10 # 限制结果数量
otter speeches list --source owned # 仅显示拥有的发言记录（默认）
otter speeches list --source shared # 仅显示共享的发言记录
otter speeches list --source all # 显示所有发言记录
otter speeches list --json # JSON格式输出

otter speeches get SPEECH_ID # 获取发言详情 + 完整转录稿
otter speeches get SPEECH_ID --json

otter speeches search 关键词 SPEECH_ID # 在发言记录中搜索
otter speeches search 关键词 SPEECH_ID --size 100

otter speeches download SPEECH_ID -f txt # 格式：txt、pdf、mp3、docx、srt、md
otter speeches download SPEECHID -f pdf -o myfile
otter speeches download SPEECH_ID -f md # markdown格式（从转录数据本地生成）
otter speeches download SPEECH_ID -f md -o meeting-notes
otter speeches download SPEECH_ID -f md --frontmatter-fields title,summary,speakers
otter speeches download SPEECH_ID -f md --frontmatter-fields none

otter speeches upload recording.mp4 # 上传音频进行转录

otter speeches rename SPEECH_ID 新标题
otter speeches trash SPEECH_ID # 移至回收站
otter speeches trash SPEECH_ID --yes # 跳过确认

otter speeches move SPEECH_ID --folder Work
otter speeches move ID1 ID2 ID3 --folder Work
otter speeches move SPEECH_ID --folder 新文件夹 --create # 自动创建文件夹

发言人

bash
otter speakers list
otter speakers list --json
otter speakers create 发言人姓名
otter speakers tag SPEECHID SPEAKERID # 列出片段，然后标记
otter speakers tag SPEECHID SPEAKERID -t UUID # 标记特定片段
otter speakers tag SPEECHID SPEAKERID --all # 标记所有片段

文件夹

bash
otter folders list
otter folders list --json
otter folders create 我的文件夹
otter folders create 我的文件夹 --json
otter folders rename FOLDER_ID 新名称

群组

bash
otter groups list
otter groups list --json

身份验证与配置

bash
otter login # 身份验证（保存到密钥链）
otter user # 显示当前用户
otter logout # 清除凭据
otter config show # 显示配置
otter config clear # 清除配置

重要提示：发言记录ID

Otter.ai 的发言记录有两个标识符：

• - speech_id（例如 7KR9X3VNPLQ8JTMS）-- 内部ID，不适用于API
• otid（例如 Xp4mRtK9wLs2vNcQjY7hBfA3eZd）-- 用于所有CLI命令

所有CLI命令均使用 otid。使用 otter speeches list 查找它们，或使用：
bash
otter speeches list --json | jq .speeches[].otid

Markdown 前置元数据

以 md 格式下载时，默认包含YAML前置元数据。使用 --frontmatter-fields 自定义：

bash

使用默认值

选择特定字段

禁用前置元数据

默认字段：title、summary、speakers、starttime、endtime、durationseconds、source、speechid、folder、folder_id

所有可用字段：title、summary、speakers、starttime、endtime、durationseconds、source、speechid、folder、folderid、otid、createdat、transcriptupdatedat、language、transcriptcount、processstatus

注意：前置元数据中的 speechid 是Otter内部的speechid；命令中的 SPEECH_ID 参数仍使用otid。

使用示例

列出最近的会议：
bash
otter speeches list --days 7

获取转录稿：
bash
otter speeches list --days 1 # 查找发言记录ID
otter speeches get SPEECH_ID # 获取完整转录稿

跨会议搜索主题：
bash
otter speeches list --days 30 --json # 查找相关的发言记录ID
otter speeches search 预算 SPEECH_ID

下载为markdown格式：
bash
otter speeches list # 查找发言记录ID
otter speeches download SPEECH_ID -f md

下载为PDF格式：
bash
otter speeches list # 查找发言记录ID
otter speeches download SPEECH_ID -f pdf

按文件夹筛选：
bash
otter speeches list --folder Work

将会议整理到文件夹中：
bash
otter folders create 第一季度规划
otter speeches move SPEECH_ID --folder 第一季度规划

上传录音：
bash
otter speeches upload recording.mp4

注意事项

• - 大多数命令支持 --json 参数以输出机器可读格式。当需要解析或提取特定数据时，建议使用 --json。
• 当需要查找特定会议时，先列出最近的发言记录以找到otid，然后使用 speeches get 检索转录稿。
• 对于跨会议的广泛搜索，先列出发言记录，然后在每个相关记录中进行搜索。
• 下载支持txt、pdf、mp3、docx、srt和md格式。md 格式从转录数据本地生成，包含带有YAML前置元数据的发言人标签。
• speeches list --folder 和 speeches move --folder 都接受文件夹名称（不区分大小写）或数字文件夹ID。使用 otter folders list 查看可用的文件夹及其ID。
• 使用 -n / --page-size 限制结果数量（而不是 --limit）。
• --source 默认为 owned。使用 shared 或 all 以包含共享的发言记录。