koishi

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

开源 🏷️完全免费 ✅ 目前可打开 对话助手 🍴 复刻 358 🐛 待处理 113 👀 关注 30
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 6317
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源框架,MIT 许可证,完全免费,无付费版本。

项目预览

koishi 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类对话助手
开发团队koishijs
定价模式🏷️完全免费
价格说明开源框架,MIT 许可证,完全免费,无付费版本。
访问状态✅ 目前可打开
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型bot,chatbot,discord,feishu,framework,koishi,koishijs,lark,line,mail,matrix,onebot,sdk,telegram
GitHub 星标★ 6317
上线时间2019-12-03 00:00:00
代码更新2026-10-08
仓库体积16.9 MB
本站数据更新2026-11-09
维护状态维护中
收录时间2026-08-09
浏览次数7

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 6317

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

难度:入门 约 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

上一篇:botman

下一篇:superduper

同类项目推荐

Gemini-AI-KMP-App 开源

一套 Kotlin 代码,让 Gemini AI 跑遍六大平台

Gemini AI Kotlin Multiplatform project designed to target Android, iOS, Windows, mac···

★ 114 2026-08-09
chidori 开源

让AI运行永不丢失,断点续跑自动恢复

The agent framework where every run is durable, replayable, and resumable by default···

★ 1372 2026-08-09
instructor-go 开源

用 Go struct 约束大模型输出,直接拿到强类型结果

structured outputs for llms

★ 222 2026-11-07
swytchcode-examples 开源

多模型多智能体接入示例,拿来就能跑

Swytchcode demo projects with different agents

★ 404 2026-09-13
fragments 开源

用 AI 一句话生成完整 Next.js 应用,快速搭建全栈原型

Open-source Next.js template for building apps that are fully generated by AI. By E2···

★ 6406 2026-08-09
mcpdoc 开源

把 llms-txt 文档接进 IDE,让 AI 写代码不再瞎编

Expose llms-txt to IDEs for development

★ 1031 2026-09-12
ccproxy 开源

给 Claude Code 加钩子,自定义模型和路由,让 AI 调用随你掌控。

Build mods for Claude Code: Hook any request, modify any response, /model "with-your···

★ 357 2026-08-09
torchdistill 开源

免写代码,配置即复现顶会知识蒸馏实验

A coding-free framework built on PyTorch for reproducible deep learning studies. PyT···

★ 1636 2026-08-13