koishi

一套代码,让机器人无缝连接所有聊天平台。

Koishi 是一个用 TypeScript 编写的跨平台聊天机器人框架,旨在帮助开发者高效构建功能丰富的对话应用。它解决了传统机器人开发中平台适配繁琐、插件管理混乱、状态同步困难等问题,提供了一套统一的插件系统和模块化架构。核心能力包括:支持 Discord、Telegram、飞书、LINE、Matrix、邮件等多种平台的无缝接入;内置强大的指令系统和上下文管理,方便处理复杂对话逻辑;提供可视化的控制台和插件市场,降低开发与运维门槛。Koishi 强调可扩展性和易用性,无论是个人爱好者还是团队开发者,都能通过其丰富的生态快速搭建定制化机器人。

开源 free 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 6218
维护状态 较活跃
是否开源 是
定价模式 free

项目数据

分类对话助手
开发团队koishijs
所属国家
定价模式free
价格说明开源框架,MIT 许可证,完全免费,无付费版本。
访问状态
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型bot,chatbot,discord,feishu,framework,koishi,koishijs,lark,line,mail,matrix,onebot,sdk,telegram
GitHub 星标★ 6218
30天Star增速
HF 下载量
上线时间2019-12-03 00:00:00
最近更新2026-09-22 00:00:00
维护状态较活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数6

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 6 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • 可访问 koishi.chat 官方文档的网络环境
  • TypeScript / Node.js 运行环境(Koishi 完全基于 TypeScript 开发)
  • 使用控制台时需现代浏览器
  • 一个目标聊天平台的账号(如 QQ、Telegram、Discord、飞书)

安装与启动步骤

  1. 1阅读官方文档

    README 的「快速起步」只给了文档入口,没有安装命令,先打开官方起步文档按步骤操作。

  2. 2准备运行环境

    Koishi 完全基于 TypeScript 开发,先准备好对应的语言运行环境,再进入下一步。

  3. 3打开控制台

    Koishi 提供可视化控制台,无需编程基础即可在几分钟内搭建自己的聊天机器人。

  4. 4接入聊天平台

    在控制台中选择 QQ、Telegram、Discord、飞书等平台并配置账号,支持多账户接入。

  5. 5安装插件

    通过在线插件市场下载安装所需插件,3000 多个官方与社区插件覆盖各类功能。

  6. 6监控运行状态

    在控制面板查看运行状态、控制机器人行为,必要时可直接上号聊天测试。

如何确认成功

在控制面板中能看到机器人运行状态并正常收发消息,即表示启动成功。

常见问题

Q:没有编程基础可以用吗?

A:可以。Koishi 提供高度便利的控制台和在线插件市场,无需基础也能在几分钟内搭建自己的聊天机器人。

Q:支持哪些聊天平台?

A:支持 QQ、Telegram、Discord、飞书等主流聊天平台,并支持多账户和跨平台数据互通。

Q:插件多不多?

A:经过四年迭代,已有超过 3000 个官方和社区插件,涵盖平台支持、数据库、资源存储、状态管理及业务功能。

Q:开发插件方便吗?

A:方便。Koishi 基于 TypeScript 开发,类型提示丰富;插件开发时保存即可热重载,无需频繁重启机器人。

Q:项目使用什么许可证?

A:完全使用 MIT 协议开源。

注意事项

  • README 未提供任何安装命令,具体安装步骤必须以官网 https://koishi.chat/manual/starter/ 的文档为准。
  • README 中未给出端口、配置文件、环境变量等信息,请勿自行臆测。
  • Koishi 面向个人爱好者与团队开发者,扩展性与易用性并重。
  • 遇到问题可通过官网「参与讨论」页面联系社区。

核心亮点

  • 跨平台支持广泛,覆盖主流聊天软件,降低多端适配成本。
  • 插件化架构成熟,拥有活跃的插件市场,功能扩展便捷。
  • 内置控制台和调试工具,提升开发与运维效率。

不足之处

  • 中文文档相对完善,但英文资料较少,国际社区活跃度待提升。
  • 框架学习曲线较陡,新手入门需要一定时间。

适用场景

  • 为 Discord 或 Telegram 群组搭建多功能管理机器人。
  • 企业内部集成飞书或钉钉,实现自动化工作流。
  • 个人开发者快速原型验证聊天机器人创意。

替代项目

NoneBot、Yunzai-Bot、NapCat

项目介绍

koishi 是开发框架领域的开源项目,由 koishijs 开发,2019 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(6,218)位列前 8%,在开发框架分类的 803 个项目里位列前 8%。

近 41 天,它的 GitHub 星标从 5,660 增加到 6,218,净增 558。

项目保持着较活跃的维护节奏,最近一次代码更新于 2026-09-22。MIT 许可证,完全免费,无付费版本。从国内网络环境看,可直接访问。

它主要面向的使用场景是:为Discord或Telegram群组搭建多功能管理机器人。同类可对比的替代方案包括 NoneBot、Yunzai-Bot、NapCat。

上一篇:botman

下一篇:superduper

同类项目推荐

langchain 开源

组装 AI 应用的乐高积木,从想法到上线不换工具

The agent engineering platform.

★ 146874 2026-08-09
transformers 开源

全球最大的模型仓库全家桶,想用的模型一把抓

Transformers: the model-definition framework for state-of-the-art machine learning m···

★ 166529 2026-08-09
pi 开源

一套 TypeScript 工具包,快速搭出能写代码的 AI agent

AI agent toolkit: unified LLM API, agent loop, TUI, coding agent CLI

★ 108504 2026-09-12