首页 产品 为什么选 OCTO 解决方案 文档 关于
文档中心 / 用户手册 / 普通用户快速上手
← 返回文档中心

普通用户快速上手

OCTO 文档中心 · 用户手册
  • 01-product/OCTO是什么.md v1.0（产品定义与核心能力）
  • 01-product/核心能力概览.md v2.0（16个能力域）
  • 01-product/端侧功能支持矩阵.md v0.1（端侧功能覆盖）
  • 01-product/模块说明/各模块v0.2-v0.3文档
  • 00-inbox/product-bot-answers/2026-09-20-P0-API鉴权-Q2~Q4回答.md（Bot权限/消息/群/Thread/文件）
  • 02-architecture/安全权限与鉴权-v0.1.md（权限边界、卡片安全）
  • 03-deployment-ops/OCTO部署形态总览.md v1.1（客户端入口端口、内部模块部署）
  • 售前交付/openclaw-channel-octo卡片能力正式口径-v1.0.md（卡片交互、降级）
  • 04-user-manual/02-first-bot-walkthrough.md（Bot创建流程，供开发者参考）

普通用户快速上手指南 v0.2

面向非技术最终用户——日常聊天、传文件、用AI助手，看这一篇就够了。

UI 菜单名称/按钮位置可能因版本不同略有差异，以实际产品为准。

一、登录与进入

  1. 打开客户端：Web/PC 浏览器访问公司给的OCTO地址（默认HTTP 28080/HTTPS 28443），或用iOS/Android App。
  2. 登录账号：账号由管理员创建，或通过公司SSO单点登录（具体方式问IT管理员）。OCTO默认不开放自助注册。
  3. 忘记密码：联系管理员重置，没有公开的自助找回流程。
  4. 管理后台：地址是 `/admin/`，只有管理员能进，普通用户不用管。

二、发消息（聊天基础）

  1. 发文本：在底部输入框打字，回车/点发送按钮发出去；支持富文本/Markdown格式。
  2. @某人：输入 `@` 会弹出成员列表，选要@的人；被@的人会收到特别提醒。
  • @所有人 需要权限，不要滥用（legacy @所有人可能不再触发Bot响应）。
  1. 回复某条消息：长按/右键消息选"回复"，对方会看到你在回复哪条。
  2. 表情/贴图：输入框旁有表情按钮，支持系统表情和自定义贴图（贴纸单张限制1MB/512×512）。
  3. 正在输入/已读：对方在打字时你会看到typing提示，消息已读会有已读回执。

三、发文件/图片

  1. 发文件/图片：点输入框旁的附件/图片按钮，选择文件发送；也可直接拖拽到聊天窗口。
  2. 文件大小：默认单文件最大100MB（管理员可调整）；超出限制会提示失败。
  3. 文件类型：常见格式都支持；扩展名和真实文件内容会双重校验（改后缀伪装文件类型会被拦截）。
  4. 下载文件：收到的文件点一下就下载，大文件/图片是直接从文件存储下载的，不经过聊天服务器代理，所以需要公司网络能访问文件存储地址（如果下载不了联系IT检查网络策略）。

四、群聊与子区（Thread）

群聊

  • 建群：点"+"或"新建群"，选成员创建。
  • 群公告：群主/管理员可以设置群公告（支持Markdown格式）。
  • 加人/踢人：群主/管理员可操作；普通成员可以邀请人进群（以实际权限设置为准）。
  • Bot也是群成员：群里的AI助手（Bot）加进来后和普通成员一样，只能在自己加入的群里发消息，不是"超管"，不能跨群、不能偷偷看别的群。

子区/话题（Thread）

  • 什么时候用Thread：一个群里聊多个话题容易乱，可以开子区（Thread）讨论特定话题，不打扰主群。
  • 怎么开Thread：在某条消息上选"开子区"/"回复到子区"，或群侧边栏点"新建子区"。
  • 怎么发到子区：子区是独立的"小群"，进去发消息就只会在子区内可见；在主群@某人引到子区是常用操作。
  • 归档子区：讨论结束后可以归档子区，不再接收新消息。

五、搜索消息和文件

  • 搜索框：顶部搜索框可搜消息历史、文件、联系人（如果公司开启了搜索功能）。
  • 注意：消息搜索功能需要管理员在服务端开启（开启后依赖Kafka+OpenSearch），默认关闭；没开的话搜索可能只搜本地/最近消息。

六、和 AI Bot（AI助手）聊天

  1. 怎么找Bot：群成员列表里带头像/机器人标识的就是Bot，比如"产品管家""知识库助手"。
  2. 怎么唤起Bot：在群里 `@Bot名字 + 你的问题`，Bot就会回复；也可以直接私聊Bot一对一对话。
  3. Bot会发"卡片"：Bot的回复可能不只是文字，还会带：
  • 展示卡：结构化信息、按钮、链接
  • 进度卡：显示Bot正在思考/处理
  • 交互卡：有按钮/选项，点一下Bot会继续处理
  • 如果你的客户端版本太旧看不到卡片，会自动降级为纯文字，不会丢消息。
  1. 使用Bot的注意事项：
  • Bot的回答是AI生成的，涉及公司制度/客户数据/商务决策的重要信息，务必人工核实
  • Bot发消息走的是程序接口，频率有限（限流），不要故意高频@Bot刷消息
  • Bot也需要被拉进群才能在群里回复，没在群里的Bot你@不到

六点五、内部版功能使用入口（v0.2新增）

⚠️ 以下功能为OCTO内部版独有能力（需管理员开启对应模块），开源版不一定包含。标注了端侧限制的功能请特别注意。

📄 文档协同（仅Web端，移动端待确认）

  • 入口：Web左侧导航栏「📄 文档」图标，进入独立文档空间（非群内嵌）
  • 5类文档表面：
  • 富文本文档：Block-based富文本编辑，支持标题/列表/表格/代码块/图片
  • 表格 Sheet：在线表格，支持区域保护、查找替换、行列增删
  • 白板 Board：Excalidraw手绘白板（Web v2026.08.03+）
  • HTML 文档：独立HTML文档服务，支持发布/版本/分享/评论
  • PPT 演示文稿：协作编辑/评论/版本/媒体导出（Web v2026.09.14+）
  • 协同：多人实时协同编辑，支持评论（reader/commenter/writer权限分级）、版本历史（快照+两版本对比+恢复）
  • 导入导出：支持docx/Markdown双向导入导出
  • Bot协作：在文档评论区@Bot，Bot可帮你编辑文档正文（需Bot被加为文档成员，MVP阶段）
  • ⚠️ 仅Web端，iOS/Android文档入口待确认

📁 企业网盘（仅Web端）

  • 入口：Web左侧导航栏「📁 网盘」图标
  • ⚠️ 仅Web端，iOS/Android未实现网盘功能
  • 两级空间：
  • 个人空间：你的私人文件
  • 共享空间：团队共享文件夹，支持成员管理/角色调整/邀请链接
  • 支持操作：上传/下载/浏览/删除/重命名/移动/复制/新建文件夹
  • 分享：可生成分享链接，支持组织外访问（外部成员可打开链接）
  • 聊天转存：聊天中收到的文件可一键转存到网盘（Web v2026.08.10+）
  • 云文档挂载：网盘目录中可挂载云文档，统一访问

🔄 回路Loop与运行时（仅Web端，需管理员开启）

  • 入口：Web左侧导航栏「🔄 回路」图标——项目管理+AI协作平台（类似Linear/Jira）
  • ⚠️ 仅Web端，iOS/Android确认无回路功能
  • 核心流程：发任务→助理整理成Issue→专家/专家团执行→验收→归档
  • 运行时/添加电脑：
  • 入口：「我的→运行时→添加电脑」
  • 私聊BotFather发 /daemon 获取安装命令
  • 本地安装octo-daemon后（npm包），可将你的电脑接入作为AI专家的执行环境
  • 连接后Web「Runtimes」页面可看到设备在线状态、本地Agent列表
  • 支持一键远程升级插件
  • Skills：「我的→Skills」管理可复用技能包，从市场安装或从本地运行时导入

🎤 语音功能（全端，需opt-in）

  • 首次使用需opt-in：设置→语音设置，确认协议后开启
  • 语音输入（全端支持）：
  • Web：长按左Shift 300ms/500ms 或点击麦克风图标，录音转文字填入输入框
  • Web独有：选中文本后录音，可替换选中内容（语音编辑）
  • iOS/Android：按住说话录音转文字
  • 语音消息转写（全端）：收到语音消息自动转写为文字，支持@mention识别、口语化书面语优化、情感emoji标注；转写结果对能看到消息的人可见
  • 限制：单条语音最长60秒/最大3MB/最短1秒
  • 降级链：本地转写(localhost:8787) → 云端API，依次fallback

📝 智能总结（全端）

  • 入口：
  • Web：左侧导航「📝 智能总结」，或聊天窗口右上角✨一键总结（最近30条消息）
  • iOS/Android：底部「上下文」或右上角✨
  • 总结模式：按群/按人；时间范围24h/7d/30d/自上次以来
  • 定时总结：Web端支持日/周/月自动总结（v2026.06.13+），可选归档线程
  • 注意：智能总结需要配LLM API Key才能正常生成；与「AI速览」（v2026.09.14新上线，可速览+一键转文档）是不同功能
  • 全端支持（Web功能最全）

🔍 全文搜索（跨内容搜索）

  • 入口：顶部搜索框
  • 消息搜索：可搜消息历史全文（全端支持）
  • 云文档搜索：Web v2026.08.03+可搜云文档正文内容（需doc-index）
  • 网盘文件搜索：Web v2026.08.24+可搜网盘文件内容（不只是文件名，需drive-index+Tika）
  • 注意：搜索是近实时（NRT），新消息发出后需数秒才能搜到；移动端文档/网盘搜索支持待确认

🏪 专家市场与插件市场（Web端）

  • 专家市场：Web「回路」→「专家市场」（v2026.08.17+），浏览/安装专家(Expert)/专家团(Expert Team)/技能包(Skill)
  • 插件市场：Web端插件市场（v2026.09.14+），浏览插件，支持评分
  • 重要：Bot不经过市场分发——Bot的创建/管理唯一入口是私聊BotFather；市场安装的是专家和技能包，在回路工作区给AI专家使用
  • ⚠️ 移动端市场入口待确认

七、你不能做的事（权限边界）

  • ❌ 不能解散群（群主才可以，Bot也不能）
  • ❌ 不能改群主/管理员角色
  • ❌ 不能查看你不在的群的消息/成员列表
  • ❌ 不能代替别人发消息（除非你获得了授权）
  • ❌ 不能发送超大文件/伪装后缀的文件（会被拦截）
  • ❌ 不能滥用@所有人打扰全群
  • ⚠️ 如果发现你做不了某件事，大概率是权限不够，联系群主/管理员。

八、遇到问题怎么办

问题 怎么办
登不上/忘记密码 联系IT管理员重置
收不到消息/通知 检查网络连接、通知设置、勿扰模式
文件发不出去/下载不了 可能超过大小限制、类型不允许，或网络策略限制文件存储访问，联系IT
Bot不回复 Bot可能离线/未被拉进群/服务限流，等一会儿再试或联系管理员
看不到协同文档/语音/搜索/网盘/回路功能 这些是内部版可选功能，需管理员开启对应profile模块；网盘/回路/运行时仅Web端可用，移动端不支持
卡片显示不正常 更新客户端到最新版本；旧版本会降级为文字，不影响内容阅读
语音功能用不了 首次使用需在设置→语音设置确认协议opt-in；管理员需开启speech profile
搜索只能搜消息不能搜文档/网盘 文档/网盘搜索需管理员额外启用doc-index/drive-index profile

九、如果你是开发者/要接入Bot API

  • [Bot开发者接入前准备](01-bot-developer-onboarding.md)
  • [Bot API接入快速上手指南](../04-api-integration/OCTO-Bot-API接入快速上手指南-v0.1.md)
  • [创建第一个Bot实操Walkthrough](02-first-bot-walkthrough.md)

管理员操作不在本文范围

注：Q10已确认源码无"组织架构"独立模块，管理后台的成员管理功能对应Space成员管理；如确有企业组织架构功能需后续确认。

状态水印：v0.2 | 更新 2026-09-21 | confidence: medium | UI操作步骤基于功能模块+API端点反推+产品管家模块回答，菜单名称/按钮位置以实际产品为准；客户端最新版本iOS 1.0.5/Android 1.4.0/Web 2026.09.14；新增§6.5内部版8模块使用入口（文档/网盘/回路/运行时/语音/智能总结/全文搜索/市场）；未走查产品验证，不适用于直接客户分发

← 返回文档中心