OpenClaw 与 OCTO 关系

• 00-inbox/product-bot-answers/2026-09-19-第一批核心问题回答.md（产品管家 Q5 关系框架，message_id: 2100991460760260608）
• source-repos/octo-server/README.zh.md（Lobster/Agent 一等公民、Agent 路由会话工具调用内置、设计哲学）
• source-repos/octo-server/main.go + modules/ 目录（bot_api/botidentity/bot_task/botfather/ai_team/agentmailgateway 等 Agent/Bot 相关模块）
• 01-product/OCTO是什么.md（v1.0，2026-09-20，task 047）
• 02-architecture/OCTO总体架构.md（v1.0，2026-09-20，task 048）
• 03-deployment-ops/OCTO部署形态总览.md（v1.0，2026-09-20，task 049）
• 源码研究/schema边界汇总卡-v0.4.md（Bot API 卡片发送路径、card_action 回调）
• 源码研究/nonBot入站路径一致性验证小卡-v0.1.md（046：普通用户 API 绝对拒卡，必须经 Bot 身份）

---

OpenClaw / Agent / Bot / OCTO 关系说明 v1.0

状态：`draft/review`。 本文基于产品管家 Q5 回答和 octo-server 源码事实，统一澄清四者概念关系，避免售前/交付/内部口径混淆。未经 Lejun 终审前不升 active。

一、四个概念一句话定义

OCTO —— 平台

Bot —— OCTO 侧的身份实体

Agent —— 跑在 OpenClaw 里的"大脑"

OpenClaw —— Agent 运行时/网关框架

二、调用链：一条消息从 Agent 到用户所见

   ┌──────────────────────────────────────────────────────────────┐
   │  OpenClaw 运行时（平台外部，独立部署/进程）                    │
   │                                                              │
   │  ┌─────────┐    ┌──────────────────────┐                     │
   │  │  Agent  │───►│ openclaw-channel-octo│  ← 渠道插件          │
   │  │ (大脑)  │    │   插件（Bot API客户端）│                     │
   │  │ SOUL    │    └──────────┬───────────┘                     │
   │  │ MEMORY  │               │ Bot API (REST/WS)               │
   │  │ 工具/技能│               │ /v1/bot/sendMessage             │
   │  └─────────┘               │ /v1/bot/card/profile            │
   │                             │ /v1/bot/events (longpoll)     │
   └─────────────────────────────┼────────────────────────────────┘
                                 │ HTTPS (bot_token 鉴权)
   ┌─────────────────────────────▼────────────────────────────────┐
   │  OCTO 平台（octo-server，单锚点后端）                         │
   │                                                              │
   │  ① Authenticate  — bot_token 鉴权                            │
   │  ② Authorise     — Bot 身份闸门 + ACL                        │
   │  ③ Execute       — 业务编排、卡片校验（schema/limits）        │
   │  ④ Fan out       — 通过 WuKongIM 控制面下发消息              │
   │  ⑤ Respond       — 统一 JSON 信封 + 事件 ACK                  │
   │                                                              │
   │  modules/bot_api       Bot REST API 入口                     │
   │  modules/botidentity   Bot 身份与权限                        │
   │  modules/bot_task      Bot 异步任务                          │
   │  modules/cardtrust     卡片可信度校验                        │
   │  pkg/cardmsg           卡片协议/schema/limits                │
   │  internal/carddispatch 卡片下发到 IM                        │
   └─────────────────────────────┬────────────────────────────────┘
                                 │ WuKongIM 控制面 (gRPC/HTTP)
   ┌─────────────────────────────▼────────────────────────────────┐
   │  WuKongIM（IM 底座，外部独立进程，薄控制面，可替换）           │
   │  维护长连接、消息路由、在线状态、投递保证                      │
   └─────────────────────────────┬────────────────────────────────┘
                                 │ WebSocket / TCP 长连接
                                 ▼
                     ┌─────────────────────┐
                     │  客户端（用户所见）  │
                     │  Web / iOS / Android│
                     │  群聊 / Thread / DM │
                     └─────────────────────┘

三、容易混淆的几个点

3.1 "龙虾/Lobster"是什么？

3.2 产品管家 Bot 是 Agent 还是 OCTO 内置能力？

3.3 octo-smart-summary（摘要服务）的 AI 能力不走 OpenClaw

• octo-deployment 中 smart-summary Secret 独立配置 LLM_API_URL/LLM_API_KEY，不依赖 OpenClaw；
• 摘要触发走 octo-server 内部事件，不走 Bot API → OpenClaw 链路。

3.4 OpenClaw 能力 ≠ OCTO 标准产品能力

• OCTO 是 IM+协作平台本体，提供 IM/文件/任务/文档/Bot 接入能力；
• OpenClaw 是独立 Agent 运行时，可以通过插件接入 OCTO，但 OpenClaw 本身不是 OCTO 必选组件；
• 某个 Agent 在某个客户项目里实现的定制能力（比如自动写代码、自动发邮件），是 Agent 的技能/工具，不是 OCTO 标准产品能力；
• 私有化交付时是否包含 OpenClaw 运行环境，属于部署方案问题，当前待确认，不得默认承诺包含。（来源：产品管家 Q5"建议仍经 Lejun 终审"；047 不适合场景 #1）

3.5 一个 Agent 对应一个 Bot，不是多个

3.6 卡片/消息发送权限边界

四、角色对照表

五、私有化部署视角的组件归属

来源：049 部署形态总览（必选/可选依赖表）+ 产品管家 Q5"私有化部署是否包含 OpenClaw 运行环境"标注待确认。

六、常见口径风险（避免踩坑）

1. ❌ "OCTO 自带 AI Agent，可以帮你做 XXX" → 应改为"OCTO 原生支持 Bot/Agent 接入，具体 Agent 能力取决于接入的 Agent 配置"。
2. ❌ "OpenClaw 是 OCTO 的一部分" → OpenClaw 是独立开源项目，通过插件接入 OCTO。
3. ❌ "任何在 Bot 里看到的能力都是 OCTO 标准能力" → Bot 背后的 Agent 可以自定义工具/技能，具体能力要区分是平台标准还是 Agent 定制。
4. ❌ "装了 OCTO 就自动有产品管家/知识库助手" → 产品管家等 Bot 需要独立部署/配置 OpenClaw Agent 才能使用。
5. ❌ "普通用户也能发卡片" → 046 源码验证：只有 Bot 身份经 Bot API 才能发卡片，普通用户 API 绝对拒卡。
6. ❌ "octo-smart-summary 是一个 Agent" → summary 是独立微服务，不经过 OpenClaw Agent 链路。

七、相关文档

• [01-product/OCTO是什么.md](../01-product/OCTO是什么.md) v1.0 — 产品定义与核心能力
• [02-architecture/OCTO总体架构.md](OCTO总体架构.md) v1.0 — 总体分层、请求5步、Agent 集成点
• [03-deployment-ops/OCTO部署形态总览.md](../03-deployment-ops/OCTO部署形态总览.md) v1.0 — 组件归属/必选可选依赖
• [09-version-change/OCTO版本口径.md](../09-version-change/OCTO版本口径.md) v1.0 — 版本兼容矩阵待确认
• [售前交付/openclaw-channel-octo卡片能力正式口径-v1.0.md](../08-presales-delivery/openclaw-channel-octo卡片能力正式口径-v1.0.md) v1.0 — Bot 发送卡片的能力边界与排障

待产品管家/Lejun 确认项