Octop 是腾讯云开源的多用户多 Agent 家庭与团队 AI 助手，支持可迁移记忆、Connector 工具连接、远程桌面及 Loop Engineering 复杂任务编排。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让 Octop 不再只是回话的聊天框，而是能自动查腾讯文档、定时写周报、同步日程到群聊、整理家庭账单的私人助理——这需要明确配置身份、连接工具、定义任务流，而不是反复发“你好”。
第一步：用三个文件告诉 Octop “你是谁”
Octop 启动时默认读取 USER.md、SOUL.md、AGENTS.md 三个本地文件。不写这三份，它永远是陌生人。
在 Octop 安装目录下新建这三个纯文本文件，编码必须为 UTF-8，无 BOM。
USER.md 写你的基础画像：姓名、职业（如“跨境电商运营主管”）、常用工具（“腾讯文档链接前缀是 docs.qq.com”）、时区（“Asia/Shanghai”）、关键偏好（“拒绝生成带emoji的文案”）。这一项漏填，后续所有自动化都可能跑偏方向。
SOUL.md 定义它的表达人格：比如写“回答控制在3句话内；遇到不确定的事必须先问；对家人消息语气要温和；拒绝使用‘根据我的知识’这类模糊表述”。它不是风格开关，而是行为硬约束。
AGENTS.md 是任务指令总纲：用 YAML 格式列出你允许它主动执行的动作，例如：
– name: 每日晨会摘要
trigger: “每天 8:30”
action: “读取腾讯文档中【晨会纪要】表第1页，提取今日待办，@所有人发到「运营组」群”
– name: 家庭账单归档
trigger: “每周日 20:00”
action: “从飞书多维表格「家庭支出」拉取本周记录，生成 Markdown 表格，存入本地 /data/bills/weekly_{{date}}.md”
第二步：连通第一个真实数据源——腾讯文档
方法一：OAuth 授权直连（推荐给个人用户）
登录 Octop Web 界面 → 左侧导航点「Connectors」→ 找到「Tencent Docs」→ 点「Connect」→ 跳转腾讯云扫码授权 → 返回后勾选「可读取我名下所有文档」→ 点「Save」。
Excel/CSV与飞书表格（多维表格/电子表格）双向转换工具。支持：1. 导入Excel到多维表格（创建新表或同步到现有表）；2. 从多维表格/电子表格导出数据为CSV或Excel格式。自动识别URL类型，智能推断字段类型。
方法二：手动输入文档 ID（适合已知固定文档）
在 AGENTS.md 对应任务的 action 字段里，把文档链接替换成 docs.qq.com/d/ 开头的真实 ID，例如 docs.qq.com/d/abc123xyz。Octop 会自动识别权限并抓取内容，但仅限你有编辑权的文档。
注意：如果文档设置了“仅指定人可查看”，即使你本人有权限，Octop 也会因 OAuth token 缺少该子权限而失败。此时必须进文档右上角「权限管理」→ 添加 Octop 的登录邮箱为「可编辑」成员。
第三步：让 Octop 主动执行一个任务
① 确保 Docker 或本地后端已运行，且 Octop 服务状态为 Healthy（访问 http://localhost:3000/health 可查）。
② 在 Web 界面右下角点击「+ New Task」→ 输入自然语言指令：“把腾讯文档【9月周报模板】里「项目进展」栏的内容，复制到新文档，标题改为「9月15日进展快照」，并分享给我”。
③ Octop 会立即解析动作链：定位文档 → 提取区块 → 创建新文档 → 插入内容 → 设置分享权限 → 发送通知。整个过程在后台完成，无需你切换窗口。
④ 两分钟内，你会收到一条系统消息：“新文档已生成：https://docs.qq.com/doc/Dxxx”，同时该链接自动出现在聊天窗口中。点击即可打开编辑。
这一步成功的关键在于：USER.md 中已声明你使用腾讯文档，且 Connector 已完成 OAuth 授权。缺任一环，Octop 会在第②步就卡住并返回错误码 CONN-403。
