# Octop操作文档

内容涵盖核心概念（概览、专家、专家与人格、通道、连接器）和操作指南（LLM 提供商、IM 通道、定时任务、ACP Runner、浏览器与终端、备份与恢复）。

---

## 目录

核心概念

1. Octop 如何运作：架构概览
2. 专家：您在 Octop 中的专属 AI 助手
3. 专家模板与 MBTI 人格
4. 通道：将 Octop 连接到您的消息应用
5. 连接器：用内置应用和 MCP 扩展专家

指南

6. 配置 LLM 提供商与模型
7. 设置 IM 通道
8. 定时任务
9. ACP Runner
10. 浏览器与终端
11. 备份与恢复

---

## 1. Octop 如何运作：架构概览

Octop 采用**单进程架构**。一个 Python 进程同时承载页面、REST/WebSocket API、IM 渠道监听器和定时任务调度器——所有功能共享同一个 SQLite 数据库和同一套配置。

因为所有功能都运行在同一个进程和数据库中，Octop 无需额外的消息队列或微服务即可运行，非常适合自托管和小规模多用户部署。

### 请求流转

1. 请求通过页面、IM 渠道或 REST/WebSocket API 到达服务器
2. 服务器根据用户和专家身份将请求路由到对应的专家运行时
3. 专家运行时加载其配置的 LLM 提供商、技能和已启用的连接器
4. 专家处理请求，可能调用技能或连接器，并将结果通过原始渠道流式返回
5. 对话历史和状态持久化写入同一个 SQLite 数据库

### 多用户模型

Octop 支持在同一个服务器实例上运行多个用户账户。每个用户可以创建自己的专家，专家之间彼此隔离，工作区、凭据和对话历史互不可见。管理员账户可以管理所有用户和系统设置。

---

## 2. 专家：您在 Octop 中的专属 AI 助手

专家是 Octop 的核心工作单元。每个专家都是一个**独立配置的 AI 助手**，拥有自己的工作区目录、LLM 提供商设置、已启用技能、连接的 IM 渠道以及对话历史。

### 专家的组成

- **工作区**：专家专属的文件目录，用于存放它生成或处理的文件
- **LLM 提供商**：该专家使用的模型和 API 凭据
- **技能**：该专家可以调用的能力（如网页浏览、终端访问）
- **通道**：连接到该专家的消息平台（飞书、企业微信、Telegram 等）
- **人格**：可选的 MBTI 人格或专家模板，用于塑造沟通风格
- **对话历史**：该专家所有会话的持久化记录

### 创建专家

页面分为三个标签页：

- **我的专家**：当前账号已创建的专家
- **内置专家**：Octop 自带的专家模板
- **专家市场**：社区贡献的专家模板

点击「从内置专家新建」可基于模板一键创建。`octop init` 会自动创建一个默认的 `main` 专家。

注意：删除专家会永久清理 `~/.octop/agents/<id>/` 工作区，且不可恢复。

### 按专家配置（个性化标签页）

- **技能**：已安装技能、内置技能、技能市场与技能包
- **子智能体**：该专家可委派的辅助智能体
- **MBTI**：决定语气与思考风格的人格设定
- **记忆**：专家跨对话保留的信息
- **通道**：路由到该专家的消息平台

---

## 3. 专家模板与 MBTI 人格

Octop 提供两种方式塑造专家的个性：

- **MBTI 人格模板**：调整沟通风格和思维方式
- **专家模板**：赋予专家特定领域的专业知识框架

### MBTI 人格

Octop 内置全部 16 种 MBTI 人格类型模板（INTJ、ENFP 等）。为专家分配一种人格后，它的回复语气、决策方式和沟通风格都会随之调整，同时保留原有的技能和知识。

路径：`个性化 → MBTI`

不确定选哪种？点击 MBTI 页面右上角的「测一测」，回答一组简短问题，Octop 会根据答案推荐一种人格。

### 专家模板

专家模板是预先配置好的角色设定，提供特定领域的视角和工作方法，例如产品经理、代码审查员、数据分析师。

路径：`专家 → 专家市场`，按电商、金融、内容创作、生活健康、营销、学术、法律、技术、教育、医疗健康、人力行政、影视媒体、设计等分类整理。

组合使用技巧：人格决定「怎么说」，专家模板决定「从什么角度想」。例如 ENTJ 人格加「产品经理」专家模板，会以直接、目标驱动的语气给出产品决策建议。

---

## 4. 通道：将 Octop 连接到您的消息应用

通道是 Octop 专家与消息平台之间的桥梁，让您在熟悉的聊天应用中直接与专家对话。

### 支持的通道（9 个内置）

- **微信**：通过 iLink Bot 接入个人微信，私聊/群聊
- **QQ**：QQ 机器人频道，支持私聊/群聊，可扫码绑定
- **企业微信**：自建应用，支持单聊/群聊
- **飞书**：飞书机器人，私聊/群聊双向同步
- **元宝**：腾讯元宝通讯频道
- **钉钉**：钉钉机器人，单聊/群聊
- **Telegram**：Bot API 接入，私聊/群组
- **小艺**：华为小艺（OpenClaw），A2A 协议
- **MQTT**：IoT 设备/机器人消息路由

### 通道配置项

- 该平台的凭据（App ID、密钥、Token 等）
- 该通道绑定的目标专家
- 消息路由规则（仅响应私聊、或响应特定群组）

路径：`个性化 → 通道`

一个专家可同时连接多个通道，例如同时接入飞书和 Telegram，无论从哪个平台发消息，都由同一个专家处理，并共享同一份对话上下文和记忆。

---

## 5. 连接器：用内置应用和 MCP 扩展专家

连接器为 Octop 专家扩展了访问外部服务和工具的能力。分为两类：

- **内置连接器**：一次授权即可使用的现成集成
- **自定义连接器**：您自己接入的 MCP 服务器

连接器是**账户级配置**，对话时按需勾选要用的连接器。

### 内置连接器（18 个）

- **腾讯文档**：文档、表格、空间文件读写
- **腾讯 IMA**：笔记与知识库
- **腾讯会议**：会议管理、录制、智能纪要
- **腾讯新闻**：新闻搜索、热点订阅
- **微信读书**：书架同步、读书笔记
- **腾讯乐享**：知识库检索、文档管理
- **腾讯微云**：网盘列表、上传、下载、分享
- **个人邮箱**：IMAP/SMTP 通用邮箱
- **QQ 音乐**：搜歌、排行榜、歌单
- **飞猪**：机票、酒店、景点搜索
- **百度地图**：地点、路线、天气
- **携程问道**：酒店、机票、行程问答
- **美团旅游助手**：酒店、机票、火车票
- **元典**：法律、案例、企业信息
- **有道云笔记**：笔记创建、搜索、整理
- **Notion**：页面、数据库读写
- **飞书 CLI**：官方 lark-cli 操作
- **企业微信 CLI**：官方 wecom-cli 操作

路径：`连接器 → 内置连接器 → 点击连接`

授权后，Octop 会把令牌保存在本机 `~/.octop/secrets/` 下，不会离开您的机器。

### 自定义连接器（MCP）

MCP（Model Context Protocol）是连接 AI 智能体与外部工具服务器的开放标准。

配置示例：

```
{
  "deepwiki": {
    "display_name": "DeepWiki",
    "url": "https://mcp.deepwiki.com/mcp",
    "transport": "streamable_http"
  }
}
```

两种服务器类型：

- **HTTP Server**：MCP 服务器通过 URL 访问（如 streamable_http）
- **Stdio Server**：MCP 服务器是由 Octop 拉起的本地进程

---

## 6. 配置 LLM 提供商与模型

Octop 内置了大量 LLM 提供商预设，也支持接入任意自定义端点。提供商由管理员在「管理 → 模型」中配置，启用后其模型会进入共享的模型池，供所有专家使用。

### 预置提供商

云端标签页：

- Tencent Cloud、Kimi、MiniMax、OpenCode、SiliconFlow、Aliyun、Volcano Engine、Zhipu：协议为 openai，多站点可选
- OpenAI、OpenAI (ChatGPT)、OpenRouter、DeepSeek、Google Gemini、Groq、ModelScope、Xiaomi MiMo：协议为 openai
- Anthropic：协议为 anthropic

本地标签页：**Ollama (Local)** 预设，默认指向 `http://localhost:11434/v1`，无需 API 密钥。

任何遵循 OpenAI 或 Anthropic 规范的端点都可以作为自定义提供商接入。

### 可用模型池与自动路由

已启用提供商的模型会汇入页面顶部的「可用模型池」。Octop 可以为每条消息自动路由，选择最合适的模型；被标记为偏好（星标）的模型在没有特殊需求时会被优先使用。

### 使用 Ollama

1. 在「本地」标签页启用 Ollama (Local) 预设
2. 确保 Ollama 已在运行
3. 使用 `octop models ollama-list` 和 `octop models ollama-pull` 管理本地模型

---

## 7. 设置 IM 通道

将 Octop 专家连接到飞书、企业微信、钉钉、QQ、微信、Telegram 等平台，让团队能在日常使用的工具里直接与 AI 专家对话。

路径：`个性化 → 通道`（按专家配置）

### 飞书

1. 在飞书开放平台（https://open.feishu.cn）创建企业自建应用，获取 App ID 和 App Secret
2. 打开「飞书」开关，填入凭据
3. 将 Octop 回调地址填入飞书应用的「事件订阅」
4. 给机器人发消息，确认收到回复

终端向导：`octop channel feishu-setup`

### 企业微信

1. 在企业微信后台创建自建应用，获取 CorpID、AgentID 和 Secret
2. 打开「企业微信」开关，填入凭据
3. 将回调 URL 配置到企业微信应用中

终端扫码绑定：`octop channel bind`

### 钉钉

1. 在钉钉开放平台（https://open.dingtalk.com）创建机器人应用，获取 Client ID 和 Client Secret
2. 打开「钉钉」开关，填入凭据
3. 将回调地址配置到钉钉应用的「消息接收模式」，开启相应事件权限

### QQ

1. 在 QQ 机器人开放平台注册应用，或在通道抽屉/CLI 中扫码绑定
2. 打开「QQ」开关
3. 群聊可选配置群聊上下文：可见范围（auto / all / mention_recent / mention_only）

终端扫码绑定：`octop channel bind qq --agent main`

### Telegram

1. 通过 @BotFather（https://t.me/BotFather）创建 Bot，复制 Bot Token
2. 打开「Telegram」开关，填入 Bot Token

支持私聊与群组消息。

安全提醒：请妥善保管所有凭据。一旦泄露（如 Bot Token），请立即在对应平台重置并更新 Octop 中的配置。

---

## 8. 定时任务

为 Octop 专家设置定时任务，自动发送提醒、报告或定时执行其他任务，无需手动触发。

### 创建步骤

1. 打开「任务」标签页
2. 选择任务所属的专家
3. 点击「创建任务」
4. 填写调度、指令和任务类型后保存

### 任务的三个要素

- **调度**：何时触发（cron 表达式、间隔或一次性时间点）
- **指令**：发送给专家的提示词，上限 2000 字符
- **类型**：Agent（大模型处理）或文本（直接推送消息）

### 触发格式示例

- Cron 表达式：`0 9 * * *`，标准 5 字段 cron，每天 9 点触发
- 间隔：`interval:30`，从保存那一刻起每 30 分钟触发一次
- 一次性：`date:2025-01-15T09:00:00`，ISO 8601 时间点，只触发一次

### 查看与手动执行

任务列表会显示每个任务的调度、类型、指令、上次执行时间和上次状态。每行还有「启用」和「立即执行」操作，「立即执行」会马上跑一次，是验证新任务最快的方式。

时区设置：设置 `OCTOP_DEFAULT_TIMEZONE` 环境变量，或在 `config.json` 中添加 `"default_timezone"`，可控制 Octop 计算 cron 表达式时使用的时区。未设置时使用服务器系统时区。

进阶玩法：将定时任务与通道结合，可以实现每天自动推送报告到飞书或 Telegram。

---

## 9. ACP Runner

Octop 可以通过内置的 `acp_runner` 工具，把编码子任务委托给外部 AI 编程 CLI，包括 OpenCode、Claude Code、CodeBuddy、Codex 或自定义工具。通信走 stdio JSON-RPC。

### 配置步骤（6 步）

**第 1 步：安装 CLI 工具**

在运行 `octop run` 的同一台机器上安装：

```
# OpenCode
npm install -g opencode

# Claude Code（通过 npx）
npx -y @zed-industries/claude-agent-acp

# Codex（通过 npx）
npx -y @zed-industries/codex-acp
```

**第 2 步：在 CLI 里配好模型**

每个 CLI 工具都跑在自己的模型和凭据上，与 Octop 相互独立。先在 CLI 内部配好（如 `opencode auth login`）。

**第 3 步：打开 ACP 页面**

侧边栏进入 `/acp`。

**第 4 步：启用需要的 Runner**

打开 Runner 卡片开关。Runner 配置对所有专家共享。

**第 5 步：为专家启用 acp_runner 工具**

顶部切换到目标专家，打开「启用 ACP Runner 工具」。这个开关按专家单独生效。

**第 6 步：在对话中委托任务**

例如：「用 acp_runner 调 opencode 找到 README 并总结一下」。

### 内置 Runner

- `opencode`：命令 `opencode`，参数 `acp`
- `codebuddy`：命令 `codebuddy`，参数 `--acp`
- `claude_code`：命令 `npx`，参数 `-y` 和 `@zed-industries/claude-agent-acp`
- `codex`：命令 `npx`，参数 `-y` 和 `@zed-industries/codex-acp`

### acp_runner 工具的动作

- `action=list`：列出已启用的 Runner 和当前会话状态
- `action=start`：新建会话，指定 runner 加 message（可选 cwd）
- `action=message`：在已有会话中继续追加消息
- `action=respond`：用确切选项 id 回应权限确认提示
- `action=status`：查询会话是打开还是等待权限确认
- `action=close`：结束会话

注意：如果 `octop run` 启动环境的 PATH 中找不到 Runner（以系统服务方式运行时很常见），请在 Runner 的「命令」字段填写绝对路径，例如 `/usr/local/bin/opencode`。

---

## 10. 浏览器与终端

Octop 的工作台把远程浏览器和 AI 辅助终端合并在一个页面，另有独立的远程桌面页面。

### 浏览器

浏览器标签页驱动的是一个真实的 Chromium 实例（通过 CDP 接入，支持持久化配置），专家可以在其中浏览网页、填写表单、截图。

启用浏览器（需要 `browser` 扩展），一键安装：

```
curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash -s -- --extras browser
```

安装后重启 `octop run`，打开 `工作台 → 浏览器`，点击「检查」确认环境就绪，再点击「启动浏览器」建立会话。

### 终端

工作台中的终端标签页内嵌了完整的交互式 shell。路径：`工作台 → 终端`。

工作台终端与聊天 Dock 中的终端共用同一会话，无论从哪一侧操作，命令与输出都保持一致。

### 远程桌面

用于查看并操控 Octop 主机的操作系统桌面。点击「检查」确认环境，再点击「连接」建立会话。

### 安全防护

路径：`管理 → 安全防护`

六个标签页：

- **工具审批**：命中列表的工具执行前暂停，等待批准或拒绝
- **文件访问**：控制专家可读写的路径
- **敏感信息**：对密钥和个人信息做脱敏处理
- **命令防护**：对 shell 命令生效的放行与拦截规则
- **技能扫描**：技能安装前的安全检查
- **审计日志**：记录被防护拦截或放行的操作

默认已把 `bash`、`execute`、`write_file`、`edit_file` 列入风险名单，但总开关「启用工具人工审批」默认关闭。建议从严格白名单开始，按需逐步放开。

---

## 11. 备份与恢复

导出一份包含 SQLite 数据库、专家工作区和配置文件的完整备份，在任何运行 Octop 的机器上完整恢复。

### 备份包含什么

- `~/.octop/octop.db`：主数据库
- `~/.octop/secrets/`：JWT 密钥和其他敏感文件
- `~/.octop/agents/`：每个专家的工作区
- `~/.octop/config.json`：服务器配置

### 创建与恢复

```
# 创建备份归档
octop backup create

# 将归档恢复到 ~/.octop
octop backup restore <archive>
```

注意：恢复操作会覆盖目标机器上现有的 `~/.octop` 目录。恢复前请确保已备份任何需要保留的本地数据。

### 恢复后

重新启动 Octop 服务器以加载恢复的数据：

```
octop service restart
```

---


内容涵盖核心概念（概览、专家、专家与人格、通道、连接器）和操作指南（LLM 提供商、IM 通道、定时任务、ACP Runner、浏览器与终端、备份与恢复）。

Octop操作文档

内容涵盖核心概念（概览、专家、专家与人格、通道、连接器）和操作指南（LLM 提供商、IM 通道、定时任务、ACP Runner、浏览器与终端、备份与恢复）

开发工具

人工智能

低代码

Octop操作文档涵盖核心概念与操作指南，包括架构概览、专家配置、MBTI人格、通道连接、连接器扩展、LLM提供商设置、IM通道接入、定时任务、ACPRunner、浏览器终端及备份恢复，支持多用户隔离与自托管部署。

2026上云采购 | AI焕新·智启新局

lexiang

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Octop操作文档-腾讯云开发者社区-腾讯云

Octop操作文档

Octop操作文档

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐