一条命令启动你的 AI 专家团队Octop 自托管 AI 助手完整指南【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/OctopOctop 是一款开源、可自托管的 AI 助手平台面向个人、家庭与小型团队。它用多智能体架构为每位用户组建一支可随取随用的 AI 专家团队Web 控制台、CLI、IM 通道与定时任务全部运行在你自己的机器上对话、文件与凭据不出本机部署只需一个进程。架构为什么「单进程」就够了多人多 Agent 的系统通常会拆出一堆微服务和消息队列。Octop 反其道而行Web 服务、CLI、IM 通道、定时调度与每个用户的 Agent 运行时全部装进同一个 Python 进程不依赖 Redis 或任何外部队列。这样做的好处是运维成本极低——装完即用没有需要额外看护的组件。状态管理同样被刻意做简单控制面数据默认落在一个 SQLite 文件里规模上来后可换 PostgreSQL进程每次重启都从这个数据库完整重建运行时不存在需要手动对齐的外部状态。所有数据配置、会话、工作区、密钥都收在~/.octop/目录下本地优先。这条设计决策的完整论证见 docs/adr/001-single-process-model.md技术栈与分层拆解见 docs/architecture.md。启动从空环境到第一次对话要多久新手部署自托管 AI 助手最大的顾虑往往是环境依赖。Octop 把这部分包办了安装脚本会用 uv 在~/.octop/下自动创建一套隔离的 Python 3.12 环境不占用也不修改你系统里的 PythonmacOS、Linux、Windows 三端都支持。macOS / Linux 用户从仓库内置脚本开始bash scripts/install.shWindows 用户则可以从克隆的仓库https://gitcode.com/GitHub_Trending/oct/Octop里直接运行install.bat。安装完成后两步即可跑起来octop init # 交互式向导创建数据库、JWT 密钥与首个管理员账号 octop run # 启动 API Web 控制台浏览器打开http://127.0.0.1:8088在设置向导里挑一个模型供应商——OpenAI 兼容 API、DashScope、Ollama 本地模型都行还能一键测试连接——第一次对话就开始了。生产环境更推荐 Dockerdocker/docker-compose.yml 提供一键编排如果你不想打开终端Windows / macOS / Linux 原生桌面客户端NSIS / DMG 安装包见 desktop/README.md与 FnOS NAS 应用包也都备好了。对话层如何搭一支只属于你的专家团队全能但平庸的通用助手很难在每个领域都交出满意的答案。Octop 的做法是按任务拆人每位用户拥有自己的 Agent 团队每个 Agent 都有独立的工作区、模型供应商、IM 通道与定时任务互不干扰。专家库在启动时自动扫描、开箱即用。内置模板覆盖了不少高频场景通用助手小通、专注 Linux / Kubernetes / Docker 的运维工程师 Ops、证券观察员、育儿管家、能处理 Word / Excel / PPT 的办公小办还有临床医生、CVM 集群医生等垂直角色。模板源码位于 src/octop/infra/agents/experts/library/在控制台点一下「从模板新建」就能把它变成自己的专家再按需微调。个性塑造上Octop 内置 16 种 MBTI 人格模板外加一个互动人格测试。选定人格后启动时会把它渲染进 Agent 的SOUL.md人格文件构成性格骨架你手写的系统提示词作为微调附加在后。选错了随时可换——人格本质是一份可版本化的行为描述而不是不可控的黑盒细节见 docs/personas.md。触达层如何把专家请出浏览器只活在标签页里的助手使用频率天然受限。Octop 的统一消息处理管线让 Web、IM、定时任务三个入口共用同一条处理链路你在飞书群里 自己的 AI 专家和打开网页跟它说话走的是同一套逻辑。通道配置像开关一样排列——微信、QQ、企业微信、飞书、钉钉、Telegram、Discord、MQTT 等渠道按需启用不同专家还可以各挂各的通道把任务分流到不同群里。定时任务则补上了主动性创建 Cron 任务时支持自然语言描述比如每天 14:00 根据我的日程提醒我喝水、预设频率或自定义 Cron 表达式还能指定时区。任务分两种——文本推送直接发消息与 Agent 执行先让 AI 跑一轮再推送结果每天早上 9 点查邮件并总结这类需求都能直接落地。执行层如何得到一个真会动手的 AI聊天只是 Octop 的一半另一半是它能直接操作屏幕与终端浏览器 AI基于无头 Chromium 的自动化会话网页浏览、截图、表单填写、信息采集浏览器 profile 按用户隔离登录态不会串号远程桌面在 Web 控制台直接看到并操作 Linux / Windows / macOS 的实时画面没有显示器的服务器可一键拉起隔离桌面ACP 双向协同入站方向执行octop acp --agent main让 Zed、OpenCode 等 IDE 工具反过来调用你的 Octop Agent出站方向则在对话中把编码任务委派给 OpenCode、Claude Code、Codex、CodeBuddy 等外部编码 Agent且带权限门禁不是放任式调用完整配置见 docs/acp.md终端 AI在浏览器里跑交互式 shellAI 辅助执行命令与排障。记忆层如何让 AI 越用越懂你长期陪伴依赖两件事记住你以及基于你的资料作答。Octop 分别给出答案。知识库 RAG让私有文档成为回答的底气上传文档构建知识库后Agent 的回答语义检索、有据可依聊天中可以直接预览引用的原文同一部署内的不同专家还能共享语料。可迁移记忆由 octop-memory 驱动分层召回加全文检索记忆与工作区一起保存、一起迁移——把工作区拷到另一台机器专家的记性原封不动带走。记忆库用久了会膨胀octop memory slim支持不停服在线去重、压缩操作手册见 docs/memory-slim.md。再往外一圈是连接器生态通过 OAuth 应用与 MCP 网关接入腾讯文档、新闻热点、企查查、邮箱等外部资源完整列表见 docs/connectors.md为每个专家扩展数据与工具的边界无需重写代码。安全与数据主权你的数据归谁管自托管在 Octop 里不是一句口号而是几项具体机制本地优先配置、聊天、工作区、凭据全部位于~/.octop/不经过任何第三方服务器多用户隔离JWT 认证Agent 与工作区按用户隔离一个管理员账号即可让全家/全团队共享各行其是互不串数据工具审批与命令护栏危险工具调用与 Shell 命令需要显式批准规则文件在~/.octop/security/tool_guard/可自由编辑PII 脱敏敏感数据在离开工作区前自动打码无厂商锁定模型供应商、存储后端、IM 通道随时可换工作区后端甚至能在本地磁盘、Docker 沙箱、PostgreSQL、COS/S3 之间切换见 docs/agent-backend-file-io.md。路线图Octop 下一步要去哪里1.0 只是起点。按 README 路线图共享资源池、专家发布共享、PC 客户端已落地AgentTeams一个协调者自主调度多个专家完成多步任务Beta与移动端客户端内测中正在推进。规划中的还包括浏览器技能录制回放把一次工作流录下来变成可复用技能、自我进化把日常对话沉淀成可复用技能、项目级工作区、插件市场以及对话式控制面——用聊天就能完成建专家、接通道、管知识库的全部操作。延伸阅读新用户完整流程安装 → 向导 → 配模型 → 使用docs/user-guide.md环境变量与配置项参考docs/configuration.mdCLI 命令速查docs/cli.md技术架构与分层说明docs/architecture.md变更历史CHANGELOG.md终端已备好剩下的一行命令就是octop init。【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
