连接总览
三层架构
Karma One 的连接系统采用三层架构设计，每一层解决不同的需求：
┌─────────────────────────────────┐
第三层 · 发布层 │ 一键发布到 11 个社交媒体平台 │
└──────────────┬──────────────────┘
│
┌──────────────┴──────────────────┐
第二层 · 渠道层 │ 接入 9 大消息平台，双向消息通信 │
└──────────────┬──────────────────┘
│
┌──────────────┴──────────────────┐
第一层 · Bot 层 │ Karma Telegram Bot，零配置绑定 │
└─────────────────────────────────┘
- Bot 层：最基础也是最简单的连接方式，30 秒绑定 Telegram
- 渠道层：将分身接入微信、飞书、Slack 等 9 大平台
- 发布层：一键将内容发布到微博、小红书等 11 个社交平台
三层可以独立使用，也可以组合使用。
第一层：Bot 层
Karma Telegram Bot
这是最快速的连接方式——无需配置任何 API，无需创建自己的 Bot，30 秒就能完成。
什么是 Karma Bot？
Karma Bot（@karmabox7bot）是 Karma One 官方运营的 Telegram 机器人。绑定后，你可以：
- 在 Telegram 中直接与 AI 对话
- 接收分身自动任务的执行结果
- 接收每日早报推送
- 在外出时通过 Telegram 快速使用 AI
绑定步骤：
- 在 Karma One 应用中，打开「设置」→「渠道管理」
- 在顶部的「Karma Bot」卡片中点击「绑定 Telegram」
- 系统生成专属绑定链接
- 点击链接，跳转到 Telegram
- 在 Telegram 中向 @karmabox7bot 发送
/start - 绑定完成
绑定后能做什么：
| 功能 | 说明 | |------|------| | 发消息 | 在 Telegram 中直接发消息给 AI，像聊天一样 | | 接收通知 | 分身完成自动任务后，结果推送到 Telegram | | 每日早报 | 如果开启了每日早报功能，每天推送到 Telegram | | 语音消息 | 发送语音消息，AI 会以语音回复（短文本）| | 内联查询 | 在任何 Telegram 对话中 @karmabox7bot 快速提问 |
提示：Karma Bot 绑定不影响你在应用内的正常使用。它是一个额外的入口，让你在不打开 Karma One 应用的情况下也能使用 AI。
解绑方式：
在「渠道管理」中找到 Karma Bot 卡片，点击「解绑」即可。
第二层：渠道层
渠道层让你将分身接入外部消息平台。用户在这些平台上发消息，分身自动回复——就像拥有了一个 24 小时在线的客服或助手。
支持的 9 大平台
| 平台 | 消息方向 | 典型场景 | |------|---------|---------| | 微信公众号 | 双向 | 公众号自动回复、客户咨询 | | 企业微信 | 双向 | 企业内部助手、客户服务 | | 飞书 | 双向 | 团队协作助手 | | 钉钉 | 双向 | 企业内部通知和问答 | | Slack | 双向 | 团队协作、DevOps 通知 | | Discord | 双向 | 社区管理、用户互动 | | Telegram | 双向 | 个人助手、社区机器人 | | WhatsApp | 双向 | 海外客户服务 | | Email | 双向 | 邮件自动回复、客户支持 |
渠道接入流程（通用）
不同平台的具体配置步骤不同，但基本流程一致：
-
获取平台凭证
- 在目标平台（如微信公众号后台）创建应用或机器人
- 获取 API Key、Token 等凭证信息
-
在 Karma One 中配置
- 进入「设置」→「渠道管理」→「添加渠道」
- 选择目标平台
- 填写平台凭证信息
-
绑定分身
- 选择要对接该渠道的分身
- 分身将作为该渠道的回复者
-
测试连接
- 在目标平台发送一条测试消息
- 确认分身能正确接收和回复
-
上线运行
- 测试通过后，渠道自动进入运行状态
- 在 Karma One 中可以实时监控消息流
渠道管理
在「渠道管理」页面，你可以：
| 操作 | 说明 | |------|------| | 查看状态 | 每个渠道显示当前运行状态（在线/离线/错误） | | 暂停/恢复 | 临时暂停某个渠道的自动回复 | | 切换分身 | 更换负责回复的分身 | | 查看消息 | 查看通过该渠道收发的历史消息 | | 删除渠道 | 移除渠道配置 |
微信公众号接入要点
微信公众号是国内最常用的渠道之一。接入要点：
- 需要已认证的微信公众号（服务号或订阅号）
- 在公众号后台的「开发」→「基本配置」中获取 AppID 和 AppSecret
- 配置服务器 URL（Karma One 会提供专属回调地址）
- 支持文字消息和图片消息
- 支持安全模式（AES-256-CBC 加密）
Email 渠道接入要点
Email 渠道让分身能够自动回复邮件：
- 支持任何标准 IMAP/SMTP 邮箱
- 配置收件邮箱和发件邮箱
- 分身收到邮件后自动分析并回复
- 可设置关键词过滤，只回复特定主题的邮件
Telegram 渠道 vs Karma Bot
| 对比项 | Karma Bot | Telegram 渠道 | |--------|-----------|--------------| | 配置难度 | 零配置 | 需要创建 Bot Token | | 适用场景 | 个人使用 | 面向用户/社区 | | Bot 身份 | 官方 @karmabox7bot | 你自己的 Bot | | 自定义程度 | 低 | 高（自定义名称、头像等） | | 绑定分身 | 绑定到账号默认 AI | 可绑定指定分身 |
注意：如果你的 Telegram 自定义 Bot 使用了和 Karma Bot 相同的 Token，系统会自动检测到冲突并提示，不会重复运行。
第三层：发布层
发布层让你一键将 AI 生成的内容发布到多个社交媒体平台。
支持的 11 个平台
| 平台 | 内容类型 | 说明 | |------|---------|------| | 微博 | 图文 | 支持话题标签 | | 小红书 | 图文/视频 | 支持笔记格式 | | 抖音 | 短视频 | 需配合视频生成 | | 快手 | 短视频 | 需配合视频生成 | | B 站 | 视频/专栏 | 支持动态和专栏文章 | | 公众号 | 图文 | 长文章发布 | | 知乎 | 图文 | 问答和专栏 | | Twitter/X | 图文 | 支持多语言 | | Instagram | 图片/视频 | 支持 Stories | | LinkedIn | 图文 | 职场内容 | | Facebook | 图文/视频 | 海外社交 |
发布流程
- 在对话中让 AI 生成你需要的内容
- 对内容满意后，点击消息下方的「发布」按钮
- 选择目标平台（可多选）
- 预览各平台的内容适配效果
- 确认发布
提示：不同平台对内容格式有不同要求（字数限制、图片比例等）。Karma One 会自动适配各平台的要求，但建议发布前检查预览效果。
Karma Box — macOS 桌面连接
Karma Box 是 Karma One 的 macOS 桌面客户端，提供深度的本地系统集成：
| 功能 | 说明 | |------|------| | 系统工具 | 操作文件、截屏、剪贴板等 | | 应用控制 | 打开应用、操作 Safari、管理日历 | | 邮件管理 | 通过 Mail.app 收发邮件 | | 语音唤醒 | 语音呼唤 AI 开始对话 | | 通知推送 | macOS 系统通知 | | 文件搜索 | Finder 集成，快速查找文件 |
Karma Box 将 AI 能力深度融入你的日常 Mac 使用体验。
主权 AI 连接
对于有数据安全要求的企业用户，Karma One 支持连接部署在本地硬件上的 AI 模型。
两种主权部署方式
云端主权 AI
- AI 模型运行在受控的云端基础设施上
- 数据不经过第三方
- 适合对安全有一定要求但不需要完全本地化的场景
本地主权 AI（Karma Box 高级主权 AI）
- AI 模型直接运行在你自己的硬件上（如 Mac Studio、GPU 服务器）
- 数据完全不出本地网络
- 适合金融、医疗、政府等对数据安全有严格要求的场景
- 支持图片生成和图片分析的本地化
主权 AI 的能力
| 能力 | 云端主权 | 本地主权 | |------|---------|---------| | 文本对话 | 支持 | 支持 | | 图片生成 | 支持 | 支持 | | 图片分析 | 支持 | 支持 | | 数据隔离 | 云端隔离 | 完全本地 | | 网络要求 | 需要网络 | 可离线使用 | | 性能 | 高 | 取决于本地硬件 |
提示：主权 AI 功能仅在团队版（可选附加）和企业版（默认包含）中提供。
架构总览
以下是 Karma One 连接系统的完整架构概览：
你（用户）
│
├── Karma One App (iOS/Android/Web)
│ └── 直接使用全部 AI 功能
│
├── Karma Box (macOS)
│ └── 桌面深度集成 + 本地主权 AI
│
├── Bot 层
│ └── Karma Telegram Bot (@karmabox7bot)
│ └── 个人消息 + 通知推送
│
├── 渠道层（分身自动回复）
│ ├── 微信公众号
│ ├── 企业微信
│ ├── 飞书
│ ├── 钉钉
│ ├── Slack
│ ├── Discord
│ ├── Telegram (自定义 Bot)
│ ├── WhatsApp
│ └── Email
│
└── 发布层（内容一键分发）
├── 微博 / 小红书 / 抖音 / 快手 / B 站
├── 公众号 / 知乎
└── Twitter / Instagram / LinkedIn / Facebook