企业官网建设流程全解析

一条命令启动你的 AI 专家团队：Octop 自托管 AI 助手完整指南

【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop

Octop 是一款开源、可自托管的 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 环境，不占用也不修改你系统里的 Python，macOS、Linux、Windows 三端都支持。

macOS / Linux 用户从仓库内置脚本开始：

bash scripts/install.sh

Windows 用户则可以从克隆的仓库（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 本地模型都行，还能一键测试连接——第一次对话就开始了。生产环境更推荐 Docker：docker/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+：在浏览器里跑交互式 shell，AI 辅助执行命令与排障。

记忆层：如何让 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.md
• CLI 命令速查：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