Skip to content
Back to search

tencentmeeting-cli

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tencentcloud--tencentmeeting-cli/badge.svg)](/listings/tencentcloud--tencentmeeting-cli)

HTML

<a href="/listings/tencentcloud--tencentmeeting-cli"><img src="/api/listings/tencentcloud--tencentmeeting-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

第一步:安装 CLI

方式一:通过 npm 安装(推荐)

npm install -g @tencentcloud/tmeet

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

> 💡 如果提示 `npm: command not found`,说明尚未安装 Node.js。请前往 [Node.js 官网](https://nodejs.org/) 下载并安装 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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 291 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # tencentmeeting-cli
  2. [English](README_EN.md) | 中文
  3. 腾讯会议命令行工具(CLI),基于腾讯会议开放平台 OAuth2 授权,支持会议管理、录制管理、参会报告等功能。
  4. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  5. [![Go Version](https://img.shields.io/badge/Go-1.22+-blue.svg)](https://golang.org)
  6. ## 功能特性
  7. - 🔐 **OAuth2 授权登录** — 设备码授权流程,安全无密码
  8. - 📅 **会议管理** — 创建、查询、更新、取消会议,支持周期性会议,管理受邀成员
  9. - 🎬 **录制管理** — 查询录制列表、获取下载地址、智能纪要、智能待办、转写详情与搜索、按分享链接查询转写与纪要、录制权限申请、分享设置与授权成员管理、智能录制配置查询与修改
  10. - 📊 **参会报告** — 查询参会人列表、等候室成员记录
  11. - 👥 **通讯录** — 按用户名/职位/部门检索企业通讯录成员
  12. - 🛠️ **问题排查** — 导出本地日志,支持按时间范围过滤,打包为 zip 文件
  13. - 🔒 **安全存储** — 凭证使用 AES-256-GCM 加密,明文不落盘
  14. - 🖥️ **跨平台** — 支持 macOS、Linux、Windows
  15. ## 安装
  16. ### 第一步:安装 CLI
  17. #### 方式一:通过 npm 安装(推荐)
  18. ```bash
  19. npm install -g @tencentcloud/tmeet
  20. ```
  21. 安装完成后即可直接使用 `tmeet` 命令。
  22. > 💡 如果提示 `npm: command not found`,说明尚未安装 Node.js。请前往 [Node.js 官网](https://nodejs.org/) 下载并安装 LTS 版本(已包含 npm)。
  23. #### 方式二:从源码构建
  24. ```bash
  25. git clone https://github.com/TencentCloud/tencentmeeting-cli
  26. cd tencentmeeting-cli
  27. go build -ldflags "-X tmeet/cmd.Version=v1.0.0" -o tmeet .
  28. # 或
  29. make build VERSION=v1.0.0
  30. ```
  31. ### 第二步:安装 CLI-SKILL
  32. ```bash
  33. npx skills add TencentCloud/tencentmeeting-cli -y -g
  34. ```
  35. ## 卸载
  36. ### 方式一:通过 npm 安装的用户
  37. 先运行官方卸载脚本完成清理(停止守护进程 → 清除凭证 → 删除 `~/.tmeet/`),然后卸载 npm 包:
  38. ```bash
  39. node $(npm root -g)/@tencentcloud/tmeet/scripts/uninstall.js
  40. npm uninstall -g @tencentcloud/tmeet
  41. npx skills remove TencentCloud/tencentmeeting-cli -g # 可选:同时卸载 CLI-SKILL
  42. ```
  43. ### 方式二:从源码构建的用户
  44. 依次手动清理守护进程、凭证、配置目录和自建的二进制:
  45. ```bash
  46. tmeet event stop --force
  47. tmeet auth logout
  48. rm -rf ~/.tmeet
  49. rm -f /usr/local/bin/tmeet # 替换为你的二进制实际路径
  50. ```
  51. ## 快速开始
  52. ### 1. 登录授权
  53. ```bash
  54. tmeet auth login
  55. ```
  56. 执行后会自动尝试打开系统默认浏览器跳转到授权 URL;若无默认浏览器,则输出授权 URL,手动在浏览器中打开完成扫码授权。CLI 自动轮询结果(超时 5 分钟),凭证加密保存到本地。
  57. > 如需禁用自动打开浏览器,可使用 `--no-browser` 参数:`tmeet auth login --no-browser`
  58. ### 2. 创建会议
  59. ```bash
  60. tmeet meeting create \
  61. --subject "周例会" \
  62. --start "2026-04-10T10:00+08:00" \
  63. --end "2026-04-10T11:00+08:00"
  64. ```
  65. ### 3. 查询会议列表
  66. ```bash
  67. # 查询进行中/即将开始的会议
  68. tmeet meeting list
  69. # 查询已结束的会议
  70. tmeet meeting list-ended \
  71. --start "2026-04-01T00:00+08:00" \
  72. --end "2026-04-30T23:59+08:00"
  73. ```
  74. ### 4. 登出
  75. ```bash
  76. tmeet auth logout
  77. ```
  78. ---
  79. ## 全局标志
  80. 所有命令均支持以下全局标志:
  81. | 标志 | 简写 | 默认值 | 说明 |
  82. |------|------|--------|------|
  83. | `--format` | — | `json` | 输出格式:`json`(紧凑格式)\| `json-pretty`(缩进格式) |
  84. | `--compact` | — | `false` | 精简输出模式:仅保留关键字段,过滤冗余字段以降低响应体积,适用于查询/列表类命令 |
  85. | `--version` | `-V` | — | 查看版本号 |
  86. **示例:**
  87. ```bash
  88. # 查看版本号
  89. tmeet -V
  90. # 以缩进格式输出响应
  91. tmeet meeting get --meeting-id "6953553464429888300" --format json-pretty
  92. # 以精简模式输出查询结果(仅保留关键字段)
  93. tmeet record search --meeting-id "6953553464429888300" --compact
  94. ```
  95. ---
  96. ## 分页参数说明
  97. 自 `v1.0.5` 起,所有支持分页的命令统一采用 **`--page-token` + `--page-size`** 方案。原先的 `--page` / `--pos` / `--size` 参数被标记为 **deprecated**,仍可使用但不再推荐,未来版本可能移除。
  98. > 说明:`record content --action transcript` 的 `--pid` / `--limit` 是该分支用于段落定位的独立参数,**不属于**通用分页参数,未被弃用。
  99. **统一用法:**
  100. | 参数 | 类型 | 说明 |
  101. |------|------|------|
  102. | `--page-token` | string | 分页游标。**首次查询不传**;后续翻页请将上一次响应中的 `next_page_token` 传入 |
  103. | `--page-size` | int | 每页大小,不同命令默认值与上限不同,详见各命令说明 |
  104. **典型分页流程:**
  105. ```bash
  106. # 1) 首次查询(不传 page-token)
  107. tmeet record search --meeting-id "6953553464429888300" --page-size 30
  108. # 2) 从响应中取出 next_page_token,用于下一页
  109. tmeet record search \
  110. --meeting-id "6953553464429888300" \
  111. --page-size 30 \
  112. --page-token "<next_page_token>"
  113. # 3) 重复直到 next_page_token 为空,即已到最后一页
  114. ```
  115. **各命令 `--page-size` 默认值/最大值速查:**
  116. | 命令 | 默认值 | 最大值 | 旧参数(已弃用) |
  117. |------|:---:|:------:|------|
  118. | `meeting list` | 20 | 20 | — |
  119. | `meeting list-ended` | 30 | 30 | `--page` |
  120. | `meeting search` | 30 | 30 | — |
  121. | `meeting invitees-list` | 30 | 30 | `--pos` |
  122. | `record search` | 30 | 30 | — |
  123. | `record access --action address` | 30 | 30 | — |
  124. | `record content --action minutes --share-url` | 5 | 5 | — |
  125. | `record content --action transcript --share-url` | 5 | 5 | — |
  126. | `report participants` | 100 | 100 | `--pos` / `--size` |
  127. | `report waiting-room-log` | 100 | 100 | `--page` |
  128. | `minutes search` | 20 | 50 | — |
  129. | `minutes get` | 10 | 30 | — |
  130. > `record content --action transcript`(transcript details / search 分支)与 `record content --action paragraphs` 暂不支持基于 `--page-token` 的新分页方案。
  131. >
  132. > 兼容性说明:当未传入 `--page-token` 且同时传入了旧分页参数(如 `--page`、`--pos`)时,CLI 会按旧模式发起请求(`page_type=0`);否则一律按新模式(`page_type=1`)发起请求。
  133. ---
  134. ## 命令总览
  135. ```
  136. tmeet [--format json|json-pretty] [--compact] [-V]
  137. ├── auth
  138. │ ├── login # OAuth 授权登录
  139. │ ├── logout # 登出并清除凭证
  140. │ └── status # 查看当前登录状态
  141. ├── meeting
  142. │ ├── create # 创建会议(支持普通/周期性)
  143. │ ├── update # 更新会议信息
  144. │ ├── cancel # 取消会议
  145. │ ├── get # 获取会议详情
  146. │ ├── list # 获取进行中/即将开始的会议列表
  147. │ ├── list-ended # 获取已结束的会议列表
  148. │ ├── search # 按关键词/会议号/时间范围搜索会议
  149. │ ├── invitees-list # 获取会议受邀者列表
  150. │ ├── invitees-add # 添加会议受邀者
  151. │ ├── invitees-remove # 移除会议受邀者
  152. │ └── invitees-replace # 替换会议受邀者列表
  153. ├── contact
  154. │ ├── search # 搜索企业通讯录成员
  155. │ ├── lookup-by-email # 通过邮箱反查用户信息
  156. │ └── lookup-by-phone # 通过手机号反查用户信息
  157. ├── record
  158. │ ├── search # 按关键词/会议号/会议ID/时间范围/文件类型搜索或列出录制
  159. │ ├── content # 读内容:--action minutes|todos|transcript|paragraphs|timeline
  160. │ ├── access # 查访问:--action address|sharing|members|settings
  161. │ ├── share-set # 修改录制分享设置与授权成员(写操作,执行前确认)
  162. │ ├── settings-set # 修改录制文件智能录制配置(写操作,执行前确认)
  163. │ └── permission-apply # 录制权限申请:--action prepare|commit(默认 prepare 预览)
  164. ├── report
  165. │ ├── participants # 获取参会人列表
  166. │ ├── waiting-room-log # 获取等候室成员列表
  167. │ ├── participants-export # 导出参会成员明细(异步任务)
  168. │ └── job-result # 获取异步任务结果
  169. ├── control
  170. │ ├── call # 呼叫成员入会(会中邀请呼叫)
  171. │ ├── kick # 将成员踢出会议(会中踢人)
  172. │ └── waiting-room # 等候室管理(移入会议/移回等候室/移出)
  173. ├── minutes
  174. │ ├── search # 按关键词/时间搜索元宝纪要
  175. │ └── get # 查询元宝纪要详情
  176. ├── tshoot
  177. │ ├── log # 导出本地日志(支持按时间范围过滤,可选 --upload 上传至服务器)
  178. │ └── feedback # 上报问题排查反馈到服务器
  179. ├── app
  180. │ ├── get # 获取当前 CLI 应用信息
  181. │ └── set # 设置当前 CLI 应用信息
  182. ├── event
  183. │ ├── list # 列出可订阅的 EventKey
  184. │ ├── schema # 查看 EventKey 的参数 / 输出 schema
  185. │ ├── consume # 订阅 EventKey,按 NDJSON 流式输出事件
  186. │ ├── status # 查看本机 bus 守护进程状态
  187. │ └── stop # 停止本机 bus 守护进程(可选 --force 清理残留)
  188. └── update
  189. ├── check # 查询是否有新版本
  190. ├── get # 查看更新偏好
  191. ├── set # 设置更新偏好(remind | never_remind)
  192. └── run # 下载并替换为最新版 CLI
  193. ```
  194. ---
  195. ## 命令参考
  196. 各子命令的完整参数说明、示例与响应字段请参阅:👉 [docs/command.md](docs/command.md)
  197. ---
  198. ## 安全与风险提示(使用前必读)
  199. ---
  200. **腾讯会议 CLI 工具接入 OpenClaw 等AI Agent 并获得您的授权后,AI 将会获得你在腾讯会议的数据访问权限(包括但不限于您的详细用户信息、管理和查询会议、录制和纪要等文件查询导出),并以您的用户身份在授权范围内执行操作。尽管工具有安全防护,AI仍可能因模型幻觉、提示词注入、投毒攻击、执行偏差不可控等原因,导致数据泄露、越权操作等执行非预期操作的高风险后果,请您谨慎操作和使用,并遵循你所在企业的数据安全等内部管理要求,避免造成数据丢失、泄露等损失。若怀疑泄露或需停用,请立即执行登出命令 `tmeet auth logout`。**
  201. **请您充分理解并接受上述风险后再使用本工具,安装使用CLI后即视为您自愿承担相关责任。**
  202. ---
  203. ## 配置说明
  204. 配置文件默认存储在 `~/.tmeet/` 目录下,支持通过环境变量覆盖:
  205. | 环境变量 | 说明 | 默认值 |
  206. |----------|------|--------|
  207. | `TMEET_CLI_CONFIG_DIR` | 配置文件目录 | `~/.tmeet/` |
  208. | `TMEET_CLI_DATA_DIR` | 加密数据目录 | 平台相关默认路径 |
  209. > **注意**:所有时间参数均使用 **ISO 8601** 格式,例如 `2026-04-10T14:00+08:00`。响应中的时间戳字段会自动转换为 ISO 8601 格式展示。
  210. ## 贡献指南
  211. 欢迎提交 Issue 和 Pull Request,请先阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。
  212. ## 安全
  213. 如发现安全漏洞,请参阅 [SECURITY.md](SECURITY.md) 了解如何私下报告。
  214. ## 许可证
  215. 本项目基于 [MIT License](LICENSE) 开源。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.