国内应用接入
声网 Agora MCP 接入：查询开发者项目列表
使用声网 RESTful API 的 Customer ID 与 Customer Secret，让机器人读取当前开发者账号下的项目列表。当前不创建项目，也不管理频道、录制或实时音视频会话。
为什么让机器人读取声网项目？
团队同时维护多个声网项目时，项目名称与 App ID 容易散落在控制台、配置文件和交接文档中。连接后，机器人可以获取账号下的官方项目列表，帮助做部署前核对或资产盘点。
当前集成只调用 api.agora.io 的开发者项目列表接口，并使用 HTTP Basic Authentication。它不是声网全套运维工具，不会创建、删除或修改项目，也不读取频道内用户和媒体内容。
接入后可以做什么？
- 读取项目清单：查询当前 Customer ID 所属开发者账号可见的声网项目列表。
- 核对项目标识：让机器人从官方结果中整理项目名称、App ID 等实际返回字段，用于配置检查。
- 辅助资产盘点：把项目清单与内部环境名称对照，识别需要人工确认的重复或未知项目。
声网 Customer ID 与 Customer Secret 怎么获取？
需要声网控制台“设置→RESTful API”中生成的一组 Customer ID 和 Customer Secret。这不是项目 App ID、App Certificate 或临时 Token。
- 登录声网控制台 — 进入声网控制台并确认当前账号能看到需要盘点的项目。
- 创建 RESTful API 密钥 — 打开“设置→RESTful API”，添加密钥并下载保存 Customer ID 与 Customer Secret。
- 保护一次性密钥文件 — Customer Secret 下载后不会再次显示，请保存到密码管理器并限制团队访问。
- 连接声网 Agora — 在国内应用列表填写 Customer ID 与 Customer Secret，完成服务端校验。
- 核对项目清单 — 查询一次项目列表，并与声网控制台和部署配置中的 App ID 交叉核对。
连接后可以直接这样问
- “列出当前声网开发者账号可见的项目，并整理项目名称和 App ID”
- “把声网项目列表按名称排序，标出名称相似的项目”
- “核对这份部署清单里的 App ID 是否出现在声网官方项目列表中”
使用前必须知道的限制
当前只有 projects 一个只读动作。它不创建、更新或删除项目，不查询频道、用户、用量、录制任务、账单、Token 或实时音视频内容。返回字段、账号可见范围和频率由声网 RESTful API 控制。
项目列表中的 App ID 和名称属于基础设施信息，不应无目的公开。Customer Secret 是账号级 RESTful API 凭证，应最小化共享、定期轮换，并在人员离职或疑似泄露时立即撤销。
托管连接还是自己搭工具？
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接声网 Agora的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 自行保护 Customer Secret，维护 Basic Authentication、项目 API、凭证轮换、限流、资产映射与访问审计。 |
自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读养龙虾入门指南。
声网 Agora接入常见问题
Customer ID 等于项目 App ID 吗？
不等于。Customer ID 与 Customer Secret 是访问 RESTful API 的账号级凭证，项目 App ID 是具体项目标识。
可以用这个连接创建声网项目吗？
不可以。当前只读取项目列表，不提供创建、修改或删除操作。
能查询频道里的在线用户吗？
不能。当前没有频道、用户、录制或媒体会话相关动作。
Customer Secret 忘记后能再次查看吗？
声网官方提示密钥只能下载一次；如果遗失，应在控制台创建新密钥并撤销旧密钥。