腾讯会议 CLI TencentCloud/tencentmeeting-cli

tencentmeeting-cli

腾讯会议命令行工具（CLI），基于腾讯会议开放平台 OAuth2 授权，支持会议管理、录制管理、参会报告等功能。

功能特性

- 🔐 OAuth2 授权登录 — 设备码授权流程，安全无密码
- 📅 会议管理 — 创建、查询、更新、取消会议，支持周期性会议，管理受邀成员
- 🎬 录制管理 — 查询录制列表、获取下载地址、智能纪要、智能待办、转写详情与搜索、按分享链接查询转写与纪要、录制权限申请、分享设置与授权成员管理、智能录制配置查询与修改
- 📊 参会报告 — 查询参会人列表、等候室成员记录
- 👥 通讯录 — 按用户名/职位/部门检索企业通讯录成员
- 🛠️ 问题排查 — 导出本地日志，支持按时间范围过滤，打包为 zip 文件
- 🔒 安全存储 — 凭证使用 AES-256-GCM 加密，明文不落盘
- 🖥️ 跨平台 — 支持 macOS、Linux、Windows

安装

第一步：安装 CLI

方式一：通过 npm 安装（推荐）

npm install -g @tencentcloud/tmeet

安装完成后即可直接使用 tmeet 命令。

💡 如果提示 npm: command not found，说明尚未安装 Node.js。请前往 Node.js 官网 下载并安装 LTS 版本（已包含 npm）。

方式二：从源码构建

git clone https://github.com/TencentCloud/tencentmeeting-cli
cd tencentmeeting-cli
go build -ldflags "-X tmeet/cmd.Version=v1.0.0" -o tmeet .
或
make build VERSION=v1.0.0

第二步：安装 CLI-SKILL

npx skills add TencentCloud/tencentmeeting-cli -y -g

卸载

方式一：通过 npm 安装的用户

先运行官方卸载脚本完成清理（停止守护进程 → 清除凭证 → 删除 ~/.tmeet/），然后卸载 npm 包：

node $(npm root -g)/@tencentcloud/tmeet/scripts/uninstall.js
npm uninstall -g @tencentcloud/tmeet
npx skills remove TencentCloud/tencentmeeting-cli -g # 可选：同时卸载 CLI-SKILL

方式二：从源码构建的用户

依次手动清理守护进程、凭证、配置目录和自建的二进制：

tmeet event stop --force
tmeet auth logout
rm -rf ~/.tmeet
rm -f /usr/local/bin/tmeet # 替换为你的二进制实际路径

快速开始

1. 登录授权

tmeet auth login

执行后会自动尝试打开系统默认浏览器跳转到授权 URL；若无默认浏览器，则输出授权 URL，手动在浏览器中打开完成扫码授权。CLI 自动轮询结果（超时 5 分钟），凭证加密保存到本地。

如需禁用自动打开浏览器，可使用 --no-browser 参数：tmeet auth login --no-browser

2. 创建会议

tmeet meeting create \
--subject "周例会" \
--start "2026-04-10T10:00+08:00" \
--end "2026-04-10T11:00+08:00"

3. 查询会议列表

查询进行中/即将开始的会议 tmeet meeting list

查询已结束的会议
tmeet meeting list-ended \
--start "2026-04-01T00:00+08:00" \
--end "2026-04-30T23:59+08:00"

4. 登出

tmeet auth logout

全局标志

所有命令均支持以下全局标志：

| 标志 | 简写 | 默认值 | 说明 |
| --format | — | json | 输出格式：json（紧凑格式）\| json-pretty（缩进格式） |
| --compact | — | false | 精简输出模式：仅保留关键字段，过滤冗余字段以降低响应体积，适用于查询/列表类命令 |
| --version | -V | — | 查看版本号 |

示例：

查看版本号 tmeet -V

以缩进格式输出响应 tmeet meeting get --meeting-id "6953553464429888300" --format json-pretty

以精简模式输出查询结果（仅保留关键字段） tmeet record search --meeting-id "6953553464429888300" --compact

分页参数说明

自 v1.0.5 起，所有支持分页的命令统一采用 --page-token + --page-size 方案。原先的 --page / --pos / --size 参数被标记为 deprecated，仍可使用但不再推荐，未来版本可能移除。

说明：record content --action transcript 的 --pid / --limit 是该分支用于段落定位的独立参数，不属于通用分页参数，未被弃用。

统一用法：

| 参数 | 类型 | 说明 |
| --page-token | string | 分页游标。首次查询不传；后续翻页请将上一次响应中的 next_page_token 传入 |
| --page-size | int | 每页大小，不同命令默认值与上限不同，详见各命令说明 |

典型分页流程：

1) 首次查询（不传 page-token） tmeet record search --meeting-id "6953553464429888300" --page-size 30

2) 从响应中取出 next_page_token，用于下一页
tmeet record search \
--meeting-id "6953553464429888300" \
--page-size 30 \
--page-token "<next_page_token>"

3) 重复直到 next_page_token 为空，即已到最后一页

各命令 --page-size 默认值/最大值速查：

| 命令 | 默认值 | 最大值 | 旧参数（已弃用） |
| meeting list | 20 | 20 | — |
| meeting list-ended | 30 | 30 | --page |
| meeting search | 30 | 30 | — |
| meeting invitees-list | 30 | 30 | --pos |
| record search | 30 | 30 | — |
| record access --action address | 30 | 30 | — |
| record content --action minutes --share-url | 5 | 5 | — |
| record content --action transcript --share-url | 5 | 5 | — |
| report participants | 100 | 100 | --pos / --size |
| report waiting-room-log | 100 | 100 | --page |
| minutes search | 20 | 50 | — |
| minutes get | 10 | 30 | — |

record content --action transcript（transcript details / search 分支）与 record content --action paragraphs 暂不支持基于 --page-token 的新分页方案。

兼容性说明：当未传入 --page-token 且同时传入了旧分页参数（如 --page、--pos）时，CLI 会按旧模式发起请求（page_type=0）；否则一律按新模式（page_type=1）发起请求。

命令总览

tmeet [--format json|json-pretty] [--compact] [-V]
├── auth
│ ├── login # OAuth 授权登录 │ ├── logout # 登出并清除凭证 │ └── status # 查看当前登录状态 ├── meeting │ ├── create # 创建会议（支持普通/周期性） │ ├── update # 更新会议信息 │ ├── cancel # 取消会议 │ ├── get # 获取会议详情 │ ├── list # 获取进行中/即将开始的会议列表 │ ├── list-ended # 获取已结束的会议列表 │ ├── search # 按关键词/会议号/时间范围搜索会议 │ ├── invitees-list # 获取会议受邀者列表 │ ├── invitees-add # 添加会议受邀者 │ ├── invitees-remove # 移除会议受邀者 │ └── invitees-replace # 替换会议受邀者列表 ├── contact │ ├── search # 搜索企业通讯录成员 │ ├── lookup-by-email # 通过邮箱反查用户信息 │ └── lookup-by-phone # 通过手机号反查用户信息 ├── record │ ├── search # 按关键词/会议号/会议ID/时间范围/文件类型搜索或列出录制 │ ├── content # 读内容：--action minutes|todos|transcript|paragraphs|timeline │ ├── access # 查访问：--action address|sharing|members|settings │ ├── share-set # 修改录制分享设置与授权成员（写操作，执行前确认） │ ├── settings-set # 修改录制文件智能录制配置（写操作，执行前确认） │ └── permission-apply # 录制权限申请：--action prepare|commit（默认 prepare 预览） ├── report │ ├── participants # 获取参会人列表 │ ├── waiting-room-log # 获取等候室成员列表 │ ├── participants-export # 导出参会成员明细（异步任务） │ └── job-result # 获取异步任务结果 ├── control │ ├── call # 呼叫成员入会（会中邀请呼叫） │ ├── kick # 将成员踢出会议（会中踢人） │ └── waiting-room # 等候室管理（移入会议/移回等候室/移出） ├── minutes │ ├── search # 按关键词/时间搜索元宝纪要 │ └── get # 查询元宝纪要详情 ├── tshoot │ ├── log # 导出本地日志（支持按时间范围过滤，可选 --upload 上传至服务器） │ └── feedback # 上报问题排查反馈到服务器 ├── app │ ├── get # 获取当前 CLI 应用信息 │ └── set # 设置当前 CLI 应用信息 ├── event │ ├── list # 列出可订阅的 EventKey │ ├── schema # 查看 EventKey 的参数 / 输出 schema │ ├── consume # 订阅 EventKey，按 NDJSON 流式输出事件 │ ├── status # 查看本机 bus 守护进程状态 │ └── stop # 停止本机 bus 守护进程（可选 --force 清理残留） └── update ├── check # 查询是否有新版本 ├── get # 查看更新偏好 ├── set # 设置更新偏好（remind | never_remind） └── run # 下载并替换为最新版 CLI

命令参考

各子命令的完整参数说明、示例与响应字段请参阅：👉 docs/command.md

安全与风险提示（使用前必读）

腾讯会议 CLI 工具接入 OpenClaw 等 AI 智能体并获得你的授权后，AI 将获得你在腾讯会议的数据访问权限（包括但不限于你的详细用户信息、管理和查询会议、录制和纪要等文件查询导出），并以你的用户身份在授权范围内执行操作。尽管工具有安全防护，AI 仍可能因模型幻觉、提示词注入、投毒攻击、执行偏差不可控等原因，导致数据泄露、越权操作等执行非预期操作的高风险后果，请你谨慎操作和使用，并遵循你所在企业的数据安全等内部管理要求，避免造成数据丢失、泄露等损失。若怀疑泄露或需停用，请立即执行登出命令 tmeet auth logout。

请你充分理解并接受上述风险后再使用本工具，安装使用 CLI 后即视为你自愿承担相关责任。

配置说明

配置文件默认存储在 ~/.tmeet/ 目录下，支持通过环境变量覆盖：

| 环境变量 | 说明 | 默认值 |
| TMEET_CLI_CONFIG_DIR | 配置文件目录 | ~/.tmeet/ |
| TMEET_CLI_DATA_DIR | 加密数据目录 | 平台相关默认路径 |

注意：所有时间参数均使用 ISO 8601 格式，例如 2026-04-10T14:00+08:00。响应中的时间戳字段会自动转换为 ISO 8601 格式展示。

贡献指南

欢迎提交 Issue 和 Pull Request，请先阅读 CONTRIBUTING.md。

安全

如发现安全漏洞，请参阅 SECURITY.md 了解如何私下报告。

许可证

本项目基于 MIT License 开源。