Skip to content

社交渠道 ​

把 DotCraft 接进团队已经在用的聊天工具,同事在群里问一句就能拿到答案,不必打开 Desktop。QQ、企业微信、飞书 / Lark、Telegram 和微信都可以接,聊出来的会话和记忆与工作区的其他入口完全共用。

DotCraft Desktop 中可用的渠道

接入渠道 ​

  1. 在 DotCraft Desktop 打开工作区,进入渠道。
  2. 选择要接入的平台,按表单填写该平台的凭据。
  3. 到平台后台或 Bot 工具里完成对应设置。
  4. 启用渠道,给 Bot 发一条测试消息。

渠道进程由 Desktop 托管,不用另外部署。每个平台需要哪些凭据,见下表对应的设置页。所有渠道共用的配置项见渠道配置。

内置渠道 ​

平台接入方式主要能力设置
QQNapCat 或 OneBot v11 反向 WebSocket私聊、群聊、审批关键词、媒体投递QQ 设置
企业微信 / WeCom群机器人回调 URL、Token、EncodingAESKey企业微信群聊、审批、文件和图片投递企业微信设置
飞书 / Lark启用 Bot 和 WebSocket 事件订阅的自建应用卡片回复、审批、reaction、可选官方 CLI飞书设置
TelegramBotFather token私聊、群聊、/new、/help、inline 审批Telegram 设置
微信 / Weixin腾讯 iLink 二维码登录微信聊天、保存登录状态、纯文本回复、文件和图片投递微信设置

渠道会话如何工作 ​

DotCraft 渠道适配器拓扑

  • 发给 Bot 的消息都在同一个会话里,回复送回同一个聊天。
  • 平台支持时,审批和补充提问会直接出现在聊天里。
  • DotCraft 生成的图片会发到聊天里,平台能直接显示时发图片,否则以文件发送。
  • 支持斜杠命令的渠道里,/new 开一段新会话。
  • Desktop 打开同一个工作区,就能查看这些会话的历史或接着聊。

底层模型见统一会话核心。

把 Desktop 对话接到聊天里 ​

在 Desktop 对话里输入 /bind,选一个已连接的渠道。DotCraft 会给出一条 /bind 482913 这样的命令,10 分钟内在目标聊天里发送它,就能在那边接着聊这个会话。

绑定只对那个聊天生效,其他聊天照旧各聊各的。想停止时,在对话的 ⋯ 菜单里选停止在 … 中继续,或输入 /unbind。

开放到群聊之前 ​

把 Bot 放进群聊或公开聊天之前:

  • 文件和 Shell 操作保持需要审批。
  • 平台支持时,把渠道限制到可信的用户、群或聊天。
  • 自己运行适配器时,给 AppServer WebSocket 设一个强随机 token。
  • 平台需要回调 DotCraft 时,生产部署走 HTTPS。

对应的准确字段名见入口与服务。

相关文档 ​

  • 安全 — Bot 面向群聊之前,先把工具和审批收紧
  • 服务器部署 — 让渠道常驻服务器,不依赖你的电脑开着