清小搭：学校自己的 AI 助手

先说清楚这一页是什么：清小搭是清华大学自己的 AI 助手，不是本站的功能。 本站不代它提供入口、不调它的接口，只负责讲清楚它是干什么的、什么时候该用它、 想自己搭智能体该看哪份文档 —— 剩下的你自己点过去。

它和站内问答是两件事，分工见下面那张表。

它是什么

一句话：清小搭是学校官方的学生 AI 助手，问答的根据是学校自己的知识库，不是网上搜来的东西。

• 2024 年 8 月 14 日上线，也就是 2024 级本科新生开学第一天，最早以微信小程序的形式提供 24 小时在线服务。
• 用学校的话说，它依托清华自研的大模型和知识增强生成技术，做的是「智能问答 + 智能伴学」。
• 技术文档站的说法是：底座是清华团队自研的千亿参数大模型，算法服务基于 UltraRAG 框架，实现了知识库问答、智能摘录、工具调用和智能体等功能。
• 个人隐私敏感数据由学校信息办数据中台建设、存储和管理，学校官方的说法是师生信息「不出校」。这一点和本站无关，但你如果在意数据流向，这是官方给的承诺。

官方列出的能力

能力	具体是什么
大模型智能问答	校园生活、课程学习、入学手续这类问题；相当于「清华百事通」
智能伴学工具箱	文档解读、数据分析、PPT 辅助制作、学业智能提醒、课程答疑资源匹配、智慧日历
个人成长云盘	记录学习成果与成长轨迹，结合清华云盘做成个人成长档案
学业志趣自测	填一份问卷，从六个维度给选课建议
智能体广场	别人搭好的各种智能体，直接拿来用；也是你想自己搭东西的地方
具体功能的更新	例如「模拟卷助手」（2026-06 上线，覆盖 11 门课程）、图书馆座位预约快捷入口（2026-06 上线）

来源分开看：智能问答、智能伴学工具箱、个人成长云盘、智能体广场四项来自 学生学习与发展指导中心页面； 「学业志趣自测」来自清华官网的上线报道； 最后一行来自官方动态页的更新记录。

规模数字的口径很乱，别当成一个数

不同来源、不同时间的数字对不上，这里照实列，不要把它们当成同一个口径：

时间	数字	来源
2024-09-20	注册 2893 人，提问 4.1 万个，准确率 90% 以上	清华官网新闻
2026-04-10	440 门课程 AI 赋能、构建 415 个「清小搭」智能体	教育部发布会（校长李路明介绍）
2026-05-26	注册用户 2.4 万人，累计提问超 72 万条，准确率 98% 以上	教育部新闻办推介
2026-07-29	知识库 5.8 万余份文档，智能体 400 余个	第三方公众号拆解

「智能体数量」尤其容易混：有 400+ 的口径，也有 415 个的口径，还有 2025 年首届大赛时 「44 个院系部处搭建的 100 余个智能体」这种校内自建的口径。看数字先看它是哪一年、谁统计的。

你现在能用吗

这是最容易过时、也最该自己确认的一件事。

• 学生学习与发展指导中心的页面至今写着 「目前处于试运行阶段，仅面向 2024 级本科生开放」。
• 清小搭站内的《用户协议》也把服务对象写成「清华大学 2024 级本科新生或被清华大学允许的试用或测试用户」， 并写明账号仅限本人使用、在清华就学期间享有使用权，不得转让、借用、售卖或授权给第三方。
• 但官方动态页显示：2026 年 4 月起清小搭面向全体教职工开放（小程序 + Web 双端，中英双语）； 2026 年 5 月面向国际学生的版本进入试运行，当时说「预计秋季学期正式上线」。

也就是说，文本上它还写着限定范围，实际上早就扩到了教职工和国际学生。 别拿任何页面的「仅面向 XX 开放」当准——包括这一页。最可靠的办法是直接去登录一次。

怎么开始用

入口	地址 / 怎么找
网页版	www.xiaoda.tsinghua.edu.cn
智能体广场（需登录）	xiaoda.tsinghua.edu.cn/login?redirect=/square
微信小程序	微信里搜「清华大学学生成长助手清小搭」，或搜「清小搭」
Pro 桌面端	官网首页提供 macOS（Apple 芯片 / Intel 通用）与 Windows 10/11 下载
官方 CLI（终端 / IDE）	xiaoda.tsinghua.edu.cn/cli —— 在终端和主流 AI 编程工具里调用清小搭
官方动态	www.xiaoda.tsinghua.edu.cn/news

登录用的是清华统一身份认证，也就是说它面向的是清华在校师生，不是你转发给校外朋友就能用的东西。 登录方式、反馈邮箱这类操作细节，云上清华的「1911 星球与清小搭」一节写得更细，这里不重复。

本站不代它提供入口，也不代它转发

这一页只放链接，不做嵌入、不做转发、不做代登录、不代调接口。不是懒，是三重原因叠在一起：

1. 平台自己的规则不允许。 清小搭站内《用户协议》4.3 条明确禁止： 「反向工程、反向汇编、编译或者以其他方式获取本服务的源代码或基础数据」、 「以批量注册账号、外挂、插件、爬虫、作弊等方式影响本服务正常经营秩序」、 「未经我们同意，将本服务用于商业目的，无论您是否从该等行为中获得收益」。 4.4 条还禁止去除生成内容里的水印、标志、技术指纹。
2. 登录态是你个人的身份。 协议 3.3 条写明账号仅限本人使用， 不得转让、赠与、借用、售卖、授权或租用给第三方。把它放进一个对外公开的站点， 等于把你的清华身份借给所有访客用。
3. 它的内容归学校。 本站是学生自己写的经验站，没资格也没必要替学校做入口。

所以「把清小搭接到第三方网站上」这条路，本站不走，也不推荐。 想用就自己点过去，这是这一页唯一的使用方式。

官方确实有编程接口，但它是给你本人用的

清小搭官方提供了 CLI（xiaoda.tsinghua.edu.cn/cli）， 可以在终端和主流 AI 编程工具里调用它，这是最接近「API」的官方形态。

但注意两点：它的授权绑定你自己的账号（协议 3.3 条：账号仅限本人使用）； 协议 4.3 条又明文禁止把服务转给第三方或用于商业目的。 所以它是个人效率工具，不是「给你的网站做后端」的通道 —— 这两件事差得很远。

它和站内问答的分工

两边都是「问一句答一段」，但依据完全不同，用错地方会拿到错的答案。

	站内问答（本站）	清小搭（学校）
谁做的	本站维护者	清华大学
依据什么	站内 60 多篇经验帖	学校知识库（官方文档、常用域名、校内公众号）
答的是	学长学姐踩过的坑	学校的官方口径与事务办理
站里没写的	直接拒答，不编	不适用（它答的是学校的事）
给出处吗	每句标到具体文章与章节	不标到本站
入口	就在本站	要登录，自己过去

简单说：想知道「规定是什么、手续去哪办」，去清小搭；想知道「实际会踩什么坑、别人怎么过来的」，留在本站。 两边的结论冲突时，以学校官方为准——这也是本站免责声明里的原则。

清小搭也是 AI，别把它当红头文件

它的回答同样是模型生成的。本站整理清小搭问答精选时就发现， 不少条目没有日期、年份混杂，制度细节也没法逐条对上官方文件。

所以它是一条比网上搜索靠谱得多的线索，但不是依据：办事、交材料之前， 仍以官方通知、院系口径和现场公示为准。这一点和本站问答是同一种诚实——都别当文件用。

站内已有的清小搭内容

清小搭在本站不是新面孔，下面这些页面已经在用它，别重复找：

页面	那里有什么
常见问题速查：清小搭问答精选	把清小搭导出的 197 条常见问答筛成约 90 条「一句一答」。办事前扫一眼最实用，但整页标注为待核对
云上清华 §1911 星球与清小搭	登录方式（统一身份认证）与反馈邮箱
报到第一周清单、军训	2026 年新生入学教育安排的日期，来源是清小搭的通知汇总

想自己搭一个智能体

以上是给使用者的。下面这段给想自己动手搭智能体的同学——比如参加清华大学人工智能创新大赛， 或者只是想在智能体广场放一个自己的东西。

大赛每年一届（2026 年那届的赛期是 6 月至 9 月，报名 7 月底截止），具体时间以官方通知为准； 非赛期也照样可以自己搭了上架，不必等比赛。

三条路，按投入从低到高

1. 在平台上直接搭。 用清小搭内置的智能体共创平台（BISHENG 是清小搭侧用于智能体构建和配置的平台）， 或者用扣子（Coze）、扣子开源版（产品界面里叫 Coze Studio，大赛 FAQ 里写作「OpenCoze」）、 智谱清言等外部平台搭好，再通过「平台接入」同步到清小搭。智谱清言支持 OAuth 与 API Key 两种授权方式。 代价：官方 FAQ 明确提醒，第三方平台会持续更新，平台无法保证所有 Coze 接口模式和版本都兼容， 对话流模式、OAuth 未授权插件是常见的坑。
2. 上传 Skill 技能包。 打包成标准 ZIP 上传，让别的智能体调用你的技能。 官方要求：README 里写清运行环境、依赖项、版本和配置方法；关键依赖要给替代方案或异常提示； 遵循权限最小化和数据最小化；依赖来源要清晰、稳定、合法合规。
3. 自己写代码，按 OpenAI 兼容标准协议接入。 最通用，也最可控。下面是它的契约。

第 3 条路：最小接入契约

核心思路一句话：把你的服务写成一个「长得像 OpenAI」的 HTTP 服务，网关由清小搭提供，你不用管。 官方接入指南的原话是「你不需要实现平台网关的任何东西」。

必须实现两个端点：

端点	必须	用途
POST {baseUrl}/chat/completions	✅ 必须	对话（流式 SSE + 非流式 JSON 都要）
GET {baseUrl}/models	🟡 强烈建议	连通性与凭证校验（不实现也行，平台会用最小对话兜底）

硬性要求（任何一条不满足，平台的探测就不通过）：

1. HTTP/HTTPS，Content-Type: application/json；流式响应用 text/event-stream。
2. 支持 Authorization: Bearer <credential> 鉴权（或 x-api-key / 自定义请求头）；无效凭证返回 401。
3. 请求与响应都按 OpenAI 风格（messages / choices 那一套）。
4. stream: true 时返回 SSE，以 data: [DONE] 结尾。
5. finish_reason 只用官方那五个值之一。
6. 返回 usage（token 用量）字段，统计不了就填 0。

baseUrl 填到哪个位置

填到版本段为止，例如 https://your.host/v1。网关会自己拼 baseUrl + /chat/completions， 不做 /v1 去重 —— 所以你多写或少写一个 /v1，探测都会失败。

进阶可选能力（不影响纯文本对话接入）：音频输入 input_audio、文件输入 file（pdf/word 等）、 文件产物输出 x_soda.attachments（返回 PDF/PPT/Word）。

上架流程：四步

1. 平台信息 —— 选「标准协议接入」，填 API 地址与 API 密钥；需要自定义鉴权头时展开高级配置。
2. 测试验证 —— 平台自动探测 /models 与 /chat/completions，给出四项检查结果；通过后可以直接试聊。
3. 完善信息 —— 头像、智能体名称、描述、开场白、上架分类、引导问题。
4. 审核上线 —— 提交审核，通过后上架智能体广场。

第二步出红叉怎么排查：凭证校验 对应密钥或鉴权方式；发起最小对话 对应 /chat/completions； 校验响应格式 对应响应结构不像 OpenAI。对着上面那六条硬性要求逐条核对，通常就在里面。

一条不能碰的红线

官方 FAQ 写得很明确：不统一开放课程表、借阅记录等涉及个人隐私或校内敏感信息的数据接口， 也不得通过绕过权限的方式访问校内私有数据。作品需要数据能力时，只能用公开数据、 已获授权的数据、安全可访问的外部数据库或 MCP 服务，并做好脱敏与最小化采集。

本站的态度

「绕开权限拿校内数据」这件事，本站不写教程、不提供思路、不链接任何相关工具。 这不是技术问题，是会不会出事的问题。

官方文档与参考链接

链接	讲什么	适合谁
清小搭官网	入口、Pro 桌面端下载	想用的人
官方动态	功能更新、活动、外部报道汇总	所有人
智能体广场	找别人搭好的智能体	使用者
自研 Agent 接入指南（官方）	标准协议接入的完整契约、探测规则、音频/文件能力	要写代码接入的人
SkillHub 安装指导手册（官方）	技能包的目录结构（SKILL.md）与三种安装方式	要打包或安装 Skill 的人
智能体社区接入指南（官方）	让 AI 编程工具接入清小搭社区的规则（默认只读、发言主体边界）	用 Claude Code / Cursor 这类工具的人
清小搭技术团队文档站	算法原理：知识问答、检索模型、智能摘录、评测框架	想懂它背后怎么做的
↳ 知识问答（RAG）	检索增强生成的流程	同上
↳ 检索模型	检索用的向量模型	同上
↳ 智能摘录	网页/文档摘录能力	同上
↳ 评测框架	怎么评的准确率	同上
↳ 学术论文 · 开源项目	团队论文与开源	同上
清华官网新闻：清小搭上线	2024 年上线时的官方报道与早期数据	想了解来龙去脉的
学生学习与发展指导中心 · 清小搭	服务内容与使用方式（开放范围那句偏旧，见上文）	使用者
人工智能创新大赛	赛事信息、三类接入途径	想参赛的
大赛常见问题（飞书）	接入途径、Skill 要求、数据红线、报销	想参赛/搭智能体的

两个容易误会的点

• 技术文档站不是「搭建教程」。 qingxiaoda.github.io/docs 讲的是算法（检索、摘录、评测），不是「怎么点按钮搭一个智能体」。 要动手搭，看的是平台的「标准协议接入」向导和上面那份官方接入指南。
• 官方那几份指南都是 .md 文件，浏览器可能直接下载而不是打开。 下载后用任意文本编辑器打开就行， 它们是纯 Markdown，没有排版也能读。

事实来源与时效

这一页会过时，而且会比本站别的页面过时得快

本页信息核对于 2026-10-06，来源是上面「参考链接」里列出的官方页面、官方技术文档站， 以及清小搭官方的开发者指南与大赛 FAQ。

清小搭在 2026 年一年里经历了「面向 2024 级本科生」→「面向全体教职工」→「面向国际学生试运行」 的多次范围变化，功能也在按月更新。上面任何一个具体事实——尤其是开放范围、入口地址、 接入契约的字段要求——都可能已经变了。

以你打开时官方页面上写的为准。如果发现这一页和官方对不上， 直接改比什么都强 —— 流程见怎么贡献一篇经验帖。