caspian-sdk

一个智能体通信框架，帮你把机器人接到各种聊天渠道，不用每个平台单独写适配代码。

Github地址

https://github.com/TryCaspian/caspian-sdk

功能特性

一个 handler 管所有渠道——邮件、Slack、Discord、Telegram、Instagram 这些，消息进来统一格式，回复自动回到对的线程，不用你维护五六套管道代码。

  • 多渠道接入：一次 connect_*() 调用接一个平台，已有的 on_message handler 直接复用
  • 自动线程管理：message.reply() 自己找对地方回，跨渠道同一个人也能认出是同一对话
  • 安全校验内置：Slack signing secret、Meta 签名、Telegram header 这些校验都封装好了，验不过的直接拒掉
  • 平台礼仪提示：client.behavior_prompt() 告诉你每个渠道该怎么说，塞给模型当 system prompt 用
  • 离线测试：fake 对象模拟真实平台消息格式，80 个测试不用联网跑
  • 幂等连接：重启不会重复创建邮箱或机器人实例
  • 可扩展：第三方包走 caspian.providers entry-point 注册，不用 fork 主仓库

适用场景

只要你的智能体需要和人对话，它下面就该是这一层：

  • 客服智能体 —— 在邮件、Slack、Instagram 私信，或客户打开对话的任何地方作答；转接人工时不丢上下文。
  • 销售与线索跟进 —— 首次触达用线索所在的渠道，后续跟进去他们真正回复的地方。
  • 个人 / 高管助理 —— 一个助理身份贯通你的邮件、Telegram 和 Slack，而不是三个互不相认的机器人。
  • 社区与产品机器人 —— 同一个智能体出现在你的 Discord、Slack 社区和成员的私信里。
  • OpenClaw 智能体 —— openclaw-caspian 一次插件安装，获得全部 Caspian 渠道。
  • 智能体舰队 —— 多租户作用域让每个客户拥有自己的智能体身份（见下方示例）。

以上每一种都是同样的三行代码：connect_*() 连接渠道，写一个 on_message handler，然后 listen()。可以从可运行示例开始。