可本地部署的octopus ai平台支持家庭或小团队共享协作，通过安装桌面版、接入微信机器人、创建subagent、配置权限隔离及接入本地知识库，实现数据不出域的隐私安全ai应用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
为家庭或3～5人小团队快速搭建一个可共享、可协作、数据不离本地的AI智能体平台，避免云服务隐私风险与订阅费用，同时兼顾操作简易性与后续扩展能力。
安装Octopus桌面版（Windows/macOS/Linux通用）
从GitHub官方仓库获取最新稳定版安装包，不建议使用第三方镜像或旧版打包器。
访问 https://github.com/Rvelamen/Octopus/releases → 找到标有“Latest”且文件名含 【Octopus-Setup- 的安装包 → 下载后双击运行。
安装时勾选“Add Octopus to PATH”（Windows/macOS）或“Install CLI tools”（Linux），否则后续命令行调用SubAgent会失败。
安装完成不要立即启动，先关闭所有杀毒软件实时防护——ClawBot微信模块在首次握手时会被部分国产安全软件误判为“可疑网络行为”，导致微信登录卡在二维码扫描页。
微信机器人一键接入（无需扫码/免手机）
方法一：使用ClawBot内置免扫码通道（推荐）
启动Octopus → 点击左下角「Channels」→ 选择「WeChat」→ 勾选「Use ClawBot built-in QRless login」→ 点击「Start」→ 等待状态栏变为绿色「Connected」即可。
方法二：传统扫码登录（备用）
同上进入WeChat设置页 → 取消勾选免扫码选项 → 点击「Show QR Code」→ 用任意微信客户端（包括PC版）扫描弹出窗口中的二维码 → 扫码后等待3秒自动跳转至「已登录」状态。
【必须确认ClawBot进程已运行】：打开任务管理器（Windows）或活动监视器（macOS），搜索“clawbot”进程。若无此进程，说明微信模块未加载成功，需检查backend目录下是否缺失clawbot/子文件夹。
创建第一个协作型SubAgent（支持多人触发）
第一步：在项目根目录新建文件夹 agents/note-taker → 在其中创建 SOUL.md 文件。
第二步：在 SOUL.md 中粘贴以下最小配置：
```yaml name: 会议纪要助手 description: 自动整理群聊中的发言并生成结构化摘要 trigger: mention @note-taker tools: - file.write - datetime.now ```
第三步：回到Octopus主界面 → 点击顶部「Agents」→ 点击右上角「+ New SubAgent」→ 选择刚刚创建的 note-taker 文件夹 → 点击「Load」。
第四步：打开微信任一群聊 → 发送文字“@note-taker 记录一下刚才讨论的三点结论” → 观察Octopus底部状态栏是否出现「note-taker running…」提示。
注意：首次触发时，Agent会自动下载所需模型权重（约120MB），期间微信消息无响应属正常现象，等待30秒内出现回复即表示成功。
多成员权限隔离与消息路由控制
在Octopus安装目录下找到 config/auth.yaml → 用文本编辑器打开。
添加如下配置段落（替换其中的微信号）：
```yaml users: - id: "wxid_abc123" # 成员A微信ID（可在微信电脑版开发者工具中查看） role: admin - id: "wxid_xyz789" # 成员B微信ID role: member allowed_agents: - "note-taker" - "file-search" ```
保存文件 → 在Octopus界面点击右上角齿轮图标 → 选择「Reload Auth Config」→ 系统将立即应用新权限规则。
成员B此后只能触发 note-taker 和 file-search 两个Agent，尝试调用其他Agent（如 db-backup）时，Octopus会自动返回“权限不足”提示，且不执行任何后端操作。
本地知识库接入（NAS/个人硬盘文件直读）
方法一：挂载路径直连（适合威联通/QNAP用户）
打开Octopus「Settings」→ 「Knowledge Base」→ 「Add Source」→ 类型选「Local Folder」→ 路径填入 /share/CACHEDEV1_DATA/AI-Docs/（威联通默认共享路径）→ 勾选「Watch for changes」→ 点击「Index Now」。
方法二：SMB协议接入（Windows/macOS通用）
路径栏填写格式为：smb://192.168.1.100/MyDocs → 输入NAS账户密码 → 点击「Test Connection」通过后再点「Index Now」。
索引完成后，在任意微信对话中发送“查一下去年Q3财报摘要”，Agent将直接从你指定的本地文件夹中检索PDF/DOCX内容并生成摘要，全程不上传任何原始文件到公网。
