返回目录
开源项目自动化与 Agent 类新手

Koishi:跨平台可扩展聊天机器人框架

Koishi 是一个跨平台、可扩展、高性能的聊天机器人框架,提供图形化控制台与在线插件市场,支持 QQ、Telegram、Discord、飞书等主流聊天平台,拥有 3000+ 官方与社区插件,并完全基于 TypeScript 开发,采用 MIT 协议开源。

0 次阅读2026/09/15 发布
Koishi:跨平台可扩展聊天机器人框架 来源图片

社区作者 · zZz

它解决什么问题

Koishi 是一个跨平台、可扩展、高性能的聊天机器人框架(配图 1 为其 logo,配图 2 为 FOSSA Status 徽章)。它的名字和图标设计来源于东方 Project 中的角色古明地恋(Komeiji Koishi):该角色会做出无意识举动,取这个名字既象征聊天机器人的主题,也蕴含开发者为之倾注的热爱。

主要特性包括:

  1. 开箱即用:提供高度便利的控制台,官方描述为无需基础即可在几分钟内搭建自己的聊天机器人;提供在线插件市场,即使没有编程基础也能在控制台中下载安装插件;支持 QQ、Telegram、Discord、飞书等主流聊天平台,支持多账户与跨平台数据互通;可随时随地通过控制面板监控运行状态、控制机器人行为,甚至上号聊天。
  1. 生态丰富:经过长达四年的迭代,已发展出丰富的插件生态和与之匹配的健壮系统,超过 3000 个官方和社区插件覆盖机器人开发的方方面面,从平台支持、数据库、资源存储、网页控制台、状态管理到具体业务功能一应俱全,适用于大型交互应用或轻量级辅助机器人;并提供细致文档帮助使用者在复杂功能中定位方向。
  1. 专为开发者打造:类型支持方面,Koishi 完全基于 TypeScript 开发,拥有类型支持与丰富代码提示;单元测试方面,所有核心功能均已通过单元测试,既确保可靠性,也为开发者提供测试插件与定位问题的最佳实践;模块热重载方面,开发 Koishi 插件时只需轻点保存即可热重载,无需频繁重启机器人。

快速起步部分,来源仅给出“前往文档”的入口,未在页面正文中列出具体安装命令与部署步骤。许可证方面,Koishi 完全使用 MIT 协议开源,页面标注版权为 Copyright © 2019-2023, Shigma。页面还提供贡献指南、参与讨论、支持作者等入口。

— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。

安装 / 开始使用

来源页面未提供具体的安装命令与逐条部署步骤,仅提示“快速起步:前往文档”(文档站点见 https://koishi.chat )。以下为可依据来源确认的要点,未明确处标注待核验:

  1. 准备环境:具体运行环境与依赖(如 Node.js 版本等)来源未明确,待核验;建议先访问官方文档查看最新环境要求。
  1. 获取与安装:安装命令、包管理器选择、初始化方式来源均未明确,待核验。
  1. 首次运行:来源未给出启动命令,待核验;页面描述称通过高度便利的控制台,无需基础即可在几分钟内搭建自己的聊天机器人。
  1. 插件安装:来源明确说明提供在线插件市场,即使没有任何编程基础,也能轻松在控制台中下载安装插件;因此插件安装可在控制台内完成,无需手写代码。
  1. 平台接入:支持 QQ、Telegram、Discord、飞书等主流聊天平台,并支持多账户和跨平台数据互通;具体各平台的接入配置步骤来源未展开,待核验。
  1. 运行监控:可通过控制面板监控运行状态、控制机器人的行为,甚至上号聊天。
  1. 常见问题:页面未列出 FAQ,待核验;插件开发相关的最佳实践可参考项目文档,核心功能已通过单元测试,并支持模块热重载(保存即热重载,无需频繁重启机器人)。
  1. 完整步骤请以官方文档“快速起步/指南”章节为准,页面本身未复述这些命令。

来源教程配图

logo
配图 1 · logo查看原图
FOSSA Status
配图 2 · FOSSA Status查看原图

适用场景

搭建 QQ
Telegram
Discord
飞书等平台的聊天机器人
在无编程基础的情况下通过控制台和在线插件市场快速配置机器人
构建大型交互应用或轻量级辅助机器人
开发并热重载自定义 Koishi 插件
通过控制面板监控机器人运行状态与远程控制机器人行为