国内应用接入
语雀 MCP 接入：让 AI 读写您的知识库
连接语雀 Personal Access Token 后，机器人可以列出您的知识库、读取文档正文，并把整理好的内容作为新的 Markdown 文档写回语雀。
语雀接入解决什么问题？
很多团队的资料都沉在语雀里，模型看不到。语雀接入让机器人能列知识库、读文档，并把会议纪要、周报、调研结论直接写成语雀文档，省去复制粘贴。
连接使用语雀官方开放接口和您自己的 Personal Access Token。Token 加密保存在 OpenClaw Launch 服务端，不会写进机器人容器；机器人拿到的是解析后的结果，除文档正文外还包括知识库与文档的名称、路径等元信息。
接入后可以做什么？
- 列出知识库：返回您账号下知识库的 namespace 与名称，作为后续读写的定位依据。
- 列出文档：按 namespace 列出某个知识库下的文档清单。
- 读取文档：读取单篇文档的 Markdown 正文。
- 新建文档：在指定知识库下创建 Markdown 文档，默认私有。
如何创建语雀 Token？
需要一个语雀 Personal Access Token。请注意：创建 Token 需要语雀超级会员。
- 确认账号权限 — 语雀要求超级会员才能创建 Personal Access Token；没有该权限时无法完成连接。
- 创建 Token — 访问 www.yuque.com/settings/tokens 创建 Token 并复制。
- 部署您的 AI Agent — 在 OpenClaw Launch 创建 OpenClaw 或 Hermes Agent，等待实例进入可用状态。
- 连接并定位知识库 — 在国内应用列表连接语雀，先让机器人列出知识库拿到 namespace，再进行读取或写入。
连接后可以直接这样问
- “列出我在语雀的知识库”
- “把这次会议纪要整理成文档写进我的“团队周报”知识库”
- “读一下语雀里那篇产品需求文档，并总结要点”
使用前必须知道的限制
自 2022 年起，语雀个人 Token 只能读写该账号自己拥有的文档，不能浏览任意公开文档。语雀开放接口没有全文搜索端点，因此本连接提供的是知识库/文档列表、读取和创建，而不是搜索。
写入前让机器人先给出标题和正文，确认后再创建。新建文档默认私有，公开前请自行检查内容。
托管连接还是自己搭工具？
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接语雀的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 自行创建并保管 Token，自建接口客户端、参数校验与错误处理，并跟进语雀接口变更。 |
自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读养龙虾入门指南。
语雀接入常见问题
语雀接入需要付费吗？
语雀要求超级会员才能创建 Personal Access Token，这部分费用按语雀规则计算；OpenClaw Launch 的托管价格另计。
机器人能搜索语雀全文吗？
不能。语雀开放接口没有公开的全文搜索端点，机器人只能列出知识库和文档、读取指定文档。
能读别人公开的语雀文档吗？
不能。个人 Token 只能读写该账号自己拥有的文档。
新建的文档是公开的吗？
默认私有。需要公开时请自行到语雀中调整权限。