注意：

云盘功能目前处于灰度开放阶段，如需使用请联系客户经理申请开通。

云盘是腾讯云智能体开发平台（ADP）提供的跨应用、跨会话的共享文件存储空间：Agent 挂载云盘目录后，即可像访问本地文件一样直接读写。云盘适合代码分析、多人协作等需要长期沉淀和复用同一份资料的场景。

什么是云盘

云盘是团队和 Agent 共用的文件空间。你在资源中心创建云盘并上传资料后，可将云盘的某个目录挂载到 Claw 模式应用，让 Agent 直接读取和使用这批资料；Agent 生成的内容也可以写回云盘，供团队其他成员继续使用。

你可以从以下角度理解云盘：

  • 作为团队的共享资料空间：在资源中心统一管理云盘内的目录与文件，支持新建文件夹、上传、预览、重命名、删除和下载。例如按项目或主题建立目录，集中存放代码、文档和数据集，供团队按需取用。

  • 作为 Agent 的工作目录：将云盘目录挂载到 Claw 模式应用后，Agent 会像访问本地文件一样直接读写该目录，无需在每次会话中重复上传文件。

  • 作为 Agent 的参考资料源：以只读方式挂载后，云盘内容作为参考资料供 Agent 查阅，Agent 只读取、不修改，原始资料不会被误改。

云盘和知识库的区别

文件该放云盘还是知识库？两者都能被 Agent 检索到，但用法和效果截然不同。

维度 云盘（完整文件） 知识库（RAG 检索）
Agent 拿到什么 完整文件，按需通读全文 语义检索出的相关片段
适合场景 需要完整上下文、长文分析、文件还需被修改或多人共用 快速问答、基于片段的事实查询、跨文档综合
检索方式 文件名、路径、关键词匹配 语义理解，找"意思相关"的内容
返回结果 整个文件或指定章节 最相关的几段文字，直接喂给 AI
文件状态 可以是动态更新的活文档 静态切片，需重新入库更新

同一份材料选一个就好：要完整使用放云盘，要按需检索放知识库。

云盘的适用场景

云盘把文件从单次会话中解放出来，成为应用和 Agent 可长期复用的共享存储。以下场景尤其适合使用云盘：

  • 代码分析与协作：把代码仓库放进云盘并挂载到应用，Agent 直接读取和分析代码，团队成员共享同一份代码，无需各自重复上传。

  • 团队协同编辑：将云盘目录作为应用的主工作目录，多人、多会话在同一份代码或文档上协作，改动实时可见。

  • 参考资料辅助创作：把同类文章、模板等资料以只读方式挂载到应用，让 Agent 参考这些材料仿写新内容，原始资料不会被改动。

  • 跨会话沉淀成果：每个会话的过程文件各自独立，需要保留的产出写入云盘，后续会话或其他成员可以直接接着用。

前提条件

  • 已在当前工作空间内，并具备云盘的新建权限。

步骤一：新建云盘

  1. 登录 腾讯云智能体开发平台，在左侧导航栏选择资源中心 > 云盘。

  2. 单击新建云盘，在弹窗中填写云盘名称等信息，单击确定完成创建。

  3. 进入云盘详情页，上传本地文件或文件夹。

    • 上传文件：单击上传 > 上传文件，支持多选。上传后文件来源标记为「用户上传」。

    • 上传文件夹：单击上传 > 上传文件夹，保留原始目录结构整包上传（含嵌套子目录）。

    • 新建文件夹：单击新建文件夹，输入名称并选择目标目录。云盘内无层级限制，根目录及任意层级目录均可新建。

      注意：

      上传限制：单个文件不超过 500 MB；单批次文件数不超过 1000 个（上传文件夹按展开后的文件总数计入）。上传期间请勿关闭或切换当前页面，否则可能导致上传失败。

步骤二：挂载到 Claw 应用

将云盘目录挂载到 Claw 模式应用后，Agent 即可像访问本地文件一样直接读写该目录。

  1. 在应用开发菜单打开目标 Claw 模式应用，左侧应用配置，找到云盘设置项。

  2. 单击添加，在弹窗中选择要挂载的云盘及云盘内的目录。

    1. 设置挂载路径，二选一：
挂载路径 说明 约束
作为主工作目录 云盘目录直接作为 /workdir 使用，替代默认工作目录，Agent 的工作过程与产物都在这里 必须为可读写；每个应用仅可设置一个主工作目录
挂载到独立目录 挂载到 /data 目录下的子目录（如 /data/drive），不影响默认工作目录 只读或可读写均可；路径需以 /data 开头，多个云盘挂载目录不能重复或嵌套

说明：

挂载到独立目录场景下，建议在应用提示词中明确「什么内容读取或写入挂载目录，什么内容写入/workdir」，避免 Agent 把临时文件写进云盘。

  1. 设置 Agent 权限，支持只读和可读写两档：

  • 只读：云盘内容作为参考文件挂载进沙箱，Agent 只读取、不修改。适合模板、规范、知识材料等输入型资料，可避免 Agent 误改原始文件。

  • 可读写：Agent 的修改直接写回云盘，适合需要共享产出的协作场景。

  1. 配置对应使用场景建议
挂载路径 Agent 权限 说明 场景
主工作目录 可读写 应用内所有用户、所有会话共享同一个工作目录 团队协同编辑：多人、多会话在同一代码/文档上协作
独立目录 只读 云盘内容作为参考资料挂载进应用，Agent 只读取、不可修改 模板、规范、知识材料等输入型资料
独立目录 可读写 每个会话暂存隔离，仅写入云盘目录的内容跨会话、跨用户共享 过程文件各自独立，需要共享的产出写入云盘目录

  1. 单击确定完成挂载。一个应用可配置最多5条挂载。

    注意：

    应用的云盘配置更新后，存量会话不会立即生效，将于会话结束 10 分钟后生效。新会话立即生效。对话调试、发布后均按此规则生效。

    如需让新配置立即生效，请在网页端新建对话或清空历史对话，在渠道侧可发送 /new 指令。

步骤三：对话中使用与协作

挂载完成后，Agent 在对话中即可直接读写云盘文件。

  1. 在应用对话中直接向 Agent 提出需求，Agent 会自动读取已挂载云盘目录中的文件，并像操作本地文件一样进行处理。

  2. Agent 生成的成果会写回云盘（可读写挂载时），团队其他成员和其他会话可以看到同一份最新内容。

  3. 如需将代码仓库同步到云盘，可直接在对话中让 Agent 执行 clone 操作，将仓库拉取到已挂载的云盘目录中（需为可读写挂载）。例如：请把 xxx 仓库 clone 到 /data/drive 目录下。

  4. 在云盘详情页可随时查看云盘内的文件，支持预览、下载、重命名和删除等操作。