# Octop > Self-hosted, multi-user AI assistant platform. Run personal AI agents, connect IM channels, and keep all your data on your own machine. ## 指南 - [Octop：自托管多用户AI助手](/guide/introduction.md): 从零开始用 Octop：先发出第一条消息，再做成自己的专家，并接到飞书、微信等日常聊天里。 - [Octop 快速入门：几分钟内完成安装与运行](/guide/quickstart.md): 在 macOS、Linux 或 Windows 上安装 Octop，运行 octop init，完成首次设置向导，然后在几分钟内开始聊天。 - [Octop Docker 部署指南：仅 Docker、Compose 与配置解析](/guide/quickstart-docker.md): 使用单条 docker run 命令（国内源与 GitHub 源）或 Docker Compose 部署 Octop。包括数据卷持久化、环境变量、配置解析以及首次登录与向导密码。 - [在腾讯云中使用 Octop](/guide/use-in-tencent-cloud.md): 通过腾讯云轻量应用服务器或云服务器 CVM 使用预装 Octop 的官方镜像。打开购买链接后登录腾讯云，核对配置即可下单。 - [在飞牛OS 中使用 Octop](/guide/fnos.md): 在飞牛OS（FnOS）NAS 上部署 Octop。从应用中心安装 Docker 版或本地版 .fpk，完成首次设置向导，几分钟内开始与专家对话。 - [供 Agent 阅读](/guide/for-agents.md): 页面地址末尾加 .md 即可拿到 Markdown。中文无语言前缀，英文以 /en 开头。/llms.txt 是目录，/llms-full.txt 是全部页面。 - [第一次用 Octop：这些概念怎么配合](/guide/concepts/overview.md): 用一次真实提问看清专家、模型、知识库、连接器和通道分别做什么，以及你接下来该打开哪一页。 - [专家：做成你的第一位助理](/guide/concepts/agents.md): 从内置模板创建一位专家，在聊天里交给它一件具体的事，再按需要加上记忆、技能和通道。 - [给专家选角色和口气](/guide/concepts/experts-personas.md): 从内置专家或专家市场创建对口角色，再用 MBTI 或测一测决定它怎么说话。 - [专家团队：一件事交给几位专家](/guide/concepts/expert-teams.md): 先准备至少两位专家，再创建团队。主持人负责分派，成员在同一个对话里回复。 - [知识库：让回答依据你的文件](/guide/concepts/knowledge.md): 把 PDF、Word 或表格放进知识库。提问时勾选它，回复下方会列出被引用的段落。 - [通道：在飞书或微信里找到专家](/guide/concepts/channels.md): 把一位专家接到飞书、企业微信、钉钉、QQ、微信、Telegram 或 Discord。配好之后，在原来的聊天软件里发消息即可。 - [连接器：让专家去查你的应用](/guide/concepts/connectors.md): 授权一次腾讯文档、会议、邮箱或其他应用，然后在对话里用白话让专家去查、去改。 - [如何在 Octop 中配置模型提供商与模型](/guide/guides/llm-providers.md): 在 Octop 中添加腾讯云、OpenAI、Anthropic、DeepSeek、Ollama 或任意自定义端点，并让自动路由为每条消息挑选最合适的模型。 - [把专家接到飞书、钉钉或 QQ](/guide/guides/im-channels.md): 优先用手机扫码把专家接到飞书、企业微信、钉钉、QQ 或微信。扫码不够时，再手动填写应用凭据。 - [用云端协同连接两台 Octop](/guide/guides/cloud-bridge.md): 把另一台 Octop 连到本机，在本地页面里使用对端的专家和团队。 - [让专家按时提醒或推送](/guide/guides/cron-jobs.md): 在自动化里给专家排一条每天或只跑一次的任务，并用立即执行先试一次。 - [通过 ACP 把编码任务委托给 CLI 工具](/guide/guides/acp-ide.md): 让 Octop 专家借助 Agent Client Protocol（ACP），把编码任务委托给外部 AI 编程 CLI。 - [Octop 中的浏览器自动化与终端 AI 访问](/guide/guides/browser-terminal.md): Octop 的工作台把远程浏览器和 AI 辅助终端合在一个页面，另有独立的远程桌面用于完整操控主机。 - [远程桌面：操控 Octop 主机](/guide/guides/remote-desktop.md): 在浏览器里打开主机桌面，像坐在那台机器前一样点击、输入、使用应用。 - [远程手机：操控已连接的 Android 设备](/guide/guides/remote-phone.md): 在「远程桌面 → 手机」中查看并点击 USB 手机或 Android 容器。实验性功能。 - [如何备份并完整恢复您的 Octop 数据](/guide/guides/backup-restore.md): 在页面中创建、下载、上传和恢复完整的 Octop 备份，涵盖 SQLite 数据库、专家工作区、配置与密钥。 - [重置 Octop 账户密码](/guide/guides/reset-password.md): 忘记密码时按安装方式重置：macOS / Linux、Windows、Docker、飞牛OS 和腾讯云。还能登录时，优先在头像菜单中修改密码。 - [从 LightClaw 迁移到 Octop](/guide/guides/migrate-from-lightclaw.md): 在 LightClaw 导出备份，再在 Octop 页面上传并恢复——模型、通道、工作区、环境变量与定时任务可一键迁入。 - [在 macOS 上安装 Octop 客户端与 OctopPet 桌宠](/guide/guides/macos-unsigned-app.md): macOS 提示「App 已损坏，无法打开」时怎么办：移除隔离标记、允许任何来源。图文步骤，从未用过终端也能跟着做。 - [Octop config.json 参考：所有服务器配置字段](/guide/configuration/config-file.md): Octop 读取 ~/.octop/config.json 进行服务器设置。从此文件配置端口、CORS、时区、数据库后端和 TLS。 - [Octop 环境变量：完整配置参考](/guide/configuration/environment-variables.md): 使用环境变量覆盖任何 Octop config.json 字段。适用于 Docker、CI 流水线以及不希望将密钥存入文件系统的场景。 - [为 Octop 配置 HTTPS 并注册为系统服务](/guide/configuration/tls-service.md): 使用自签名或自定义证书通过 HTTPS 运行 Octop，并通过 systemd 或 launchd 将其注册为持久化系统服务。 - [Octop 数据目录：~/.octop/ 中的文件与文件夹](/guide/configuration/data-directory.md): Octop 存储的所有内容——数据库、专家工作区、密钥、日志和插件——都位于 ~/.octop/ 下。了解每个文件和文件夹的作用。 ## CLI 参考 - [Octop CLI 概览：所有命令与传输模式](/cli/overview.md): octop CLI 完整参考：全局选项、传输模式，以及管理 Octop 服务器的所有顶层命令。 - [Octop 服务器命令：init、run、service 与 update](/cli/server-commands.md): 引导新安装，在前台启动服务器，将其管理为系统服务，并将 Octop 升级到最新发布版本。 - [Octop CLI：专家、聊天、技能与模型命令](/cli/agent-commands.md): 创建和管理专家，启动交互式聊天会话，启用或禁用技能，并从 octop CLI 配置模型提供商。 - [Octop CLI：渠道、定时任务、插件与管理命令](/cli/channel-cron-commands.md): 配置 IM 渠道，安排循环定时任务，安装与重新加载插件，并从 Octop 命令行执行管理操作。 ## API 参考 - [Octop REST 与 WebSocket API：端点与访问说明](/api/overview.md): Octop 在 /api 提供 REST 与 WebSocket。需要在浏览器里试调用时，打开 /api/docs。 - [对 Octop API 的所有请求进行认证与授权](/api/authentication.md): 通过 POST /api/auth/login 获取 JWT 访问令牌，然后在对 Octop REST API 的每个后续调用中将其作为 Bearer 令牌包含。 - [Octop 专家 API：创建、配置与控制专家](/api/agents.md): 使用 Octop 的 /api/agents 端点创建、配置、启动、停止和重新加载 AI 专家，包含专家模板和 MBTI 人格端点。 - [Octop 对话 API：WebSocket 流式传输与线程管理](/api/chat.md): 通过 WebSocket 与 Octop 专家对话并流式接收回复，并使用线程管理端点组织对话历史。 - [通道 API：在 Octop 中将专家连接到消息平台](/api/channels.md): 使用 Octop 的 /api/agents/{agent_id}/channels 端点，将专家连接到飞书、企业微信、钉钉、Telegram 等消息平台。 - [连接器 API](/api/connectors.md): 列出内置连接器目录，管理连接器实例，配置自定义 MCP 服务器，并完成 OAuth 授权流程。 - [让其他程序通过 Agent MCP 调用 Octop 专家](/api/agent-mcp.md): 使用需登录的 /api/mcp/agents Streamable HTTP 端点，让外部 MCP 客户端列出并调用你的 Octop 专家。 - [Octop 提供商 API：配置模型提供商与模型](/api/providers.md): 配置模型提供商，选择可用模型，并控制专家使用的默认模型。 - [Octop 定时任务 API：通过 REST 计划自动化专家任务](/api/cron.md): 使用 Octop 的 /api/agents/{agent_id}/cron 端点，通过 cron 表达式、间隔或一次性日期计划自动化专家任务。 - [知识库 API](/api/knowledge.md): 通过 HTTP 创建知识库、上传文档，让对话检索带引用的来源。 - [Octop 用户与管理 API：管理账户与设置](/api/users-admin.md): 使用 Octop 的 /api/users 和 /api/admin 端点管理用户账户、角色、审计日志以及平台设置（仅限管理员）。