📄 工具详情 ⚙️ 安装教程 📚 使用教程
能力标签
🔌 MCP🤖 Agent🔄 工作流💻 CLI🔗 REST API🔊 TTS🎙 STT🧠 Claude✨ GPT
🛠
AI工具

NekoBot 多频道AI角色扮演平台

基于 Python · 开源 AI 工具，GitHub 社区精选
英文名：nekobot
⭐ 16 Stars 🍴 4 Forks 💻 Python 📄 MIT 🏷 AI 8.2分
8.2AI 综合评分
角色扮演MCP协议记忆系统可视化管理
🌐 访问官网 📺 TG 频道
✦ AI Skill Hub 推荐

NekoBot 多频道AI角色扮演平台 是 AI Skill Hub 本期精选AI工具之一。综合评分 8.2 分，整体质量较高。我们强烈推荐将其纳入你的 AI 工具库，帮助提升工作效率。

📚 深度解析

NekoBot 多频道AI角色扮演平台 是一款基于 Python 的开源工具，在 GitHub 上收获 0k+ Star，是角色扮演、MCP协议、记忆系统、可视化管理领域中的优质开源项目。开源工具的最大优势在于代码完全透明，你可以审计每一行代码的安全性，也可以根据自身需求进行二次开发和定制。

**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。

**安装与环境准备**
NekoBot 多频道AI角色扮演平台 依赖 Python 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 Python 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。

**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 NekoBot 多频道AI角色扮演平台 的版本更新，及时通知重要功能变化。

📋 工具概览

一个集成MCP协议的开源AI角色扮演系统，支持角色卡管理、长短期记忆、知识库及可视化工作流。它为用户提供多频道聊天体验和强大的工具调用能力，适合AI角色创作者、沉浸式对话爱好者及Agent开发者。

NekoBot 多频道AI角色扮演平台 是一款基于 Python 开发的开源工具，专注于 角色扮演、MCP协议、记忆系统 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

GitHub Stars
⭐ 16
开发语言
Python
支持平台
Windows / macOS / Linux
维护状态
轻量级项目，按需更新
开源协议
MIT
AI 综合评分
8.2 分
工具类型
AI工具
Forks
4

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

一个集成MCP协议的开源AI角色扮演系统，支持角色卡管理、长短期记忆、知识库及可视化工作流。它为用户提供多频道聊天体验和强大的工具调用能力，适合AI角色创作者、沉浸式对话爱好者及Agent开发者。

NekoBot 多频道AI角色扮演平台 是一款基于 Python 开发的开源工具，专注于 角色扮演、MCP协议、记忆系统 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

📌 核心特色
  • 开源免费，支持本地部署，数据完全自主可控
  • 活跃的 GitHub 开源社区，持续迭代更新
  • 提供详细文档和使用示例，新手友好
  • 支持自定义配置，灵活适配不同使用环境
  • 可作为基础组件集成进现有技术栈或进行二次开发
🎯 主要使用场景
  • 本地部署运行，保护数据隐私，满足合规要求
  • 自定义集成到现有系统，扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发
以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。
安装命令
# 方式一：pip 安装（推荐）
pip install nekobot

# 方式二：虚拟环境安装（推荐生产环境）
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install nekobot

# 方式三：从源码安装（获取最新功能）
git clone https://github.com/asukaneko/nekobot
cd nekobot
pip install -e .

# 验证安装
python -c "import nekobot; print('安装成功')"
📋 安装步骤说明
  1. 访问 GitHub 仓库页面
  2. 按照 README 文档完成依赖安装
  3. 根据系统环境完成初始化配置
  4. 参考官方示例或文档开始使用
  5. 遇到问题可在 GitHub Issues 中查找解答
以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。
常用命令 / 代码示例
# 命令行使用
nekobot --help

# 基本用法
nekobot input_file -o output_file

# Python 代码中调用
import nekobot

# 示例
result = nekobot.process("input")
print(result)
以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。
配置示例
# nekobot 配置文件示例（config.yml）
app:
  name: "nekobot"
  debug: false
  log_level: "INFO"

# 运行时指定配置文件
nekobot --config config.yml

# 或通过环境变量配置
export NEKOBOT_API_KEY="your-key"
export NEKOBOT_OUTPUT_DIR="./output"
📑 README 深度解析 真实文档 完整度 74/100 查看 GitHub 原文 →
以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

NekoBot

cover

Python License Web QQ MCP

面向 Web 的多渠道 AI 角色扮演系统，包含Web、QQ、CLI、Telegram、Feishu等频道。

</div>

Overview

NekoBot 是一个面向角色扮演与长期互动场景的 AI 系统。项目采用统一 AI 内核与频道适配层分离的架构，提供完整的 Web 管理后台、角色运行时、记忆系统、工具调用与工作区能力。

它的核心目标不是单纯提供“聊天接口”，而是提供一套可持续运行、可配置、可观测、可扩展的角色型智能体基础设施。

Core Capabilities

  • 多渠道接入：支持 QQ、Web、CLI、Telegram、Feishu，共用统一的 ChatRequest / ChatResponse 处理链路。
  • 角色运行时：内置实时情感引擎、六维关系模型、动态 PromptStack、自动状态评估与角色记忆。
  • Web 控制台：提供会话管理、角色管理、模型配置、工作流、知识库、记忆、日志与调试界面。
  • 工具与工作区：支持工具调用、文件读写、共享/私有工作区、文件变更预览与任务执行。
  • 模型适配：兼容 OpenAI Chat Completions/Responses , Anthropic , Gemini接口，可接入 Deepseek、GLM、Kimi、Mimo及其他兼容服务。
  • 插件与技能：支持通过插件与技能系统扩展能力，而不破坏核心处理流程。
  • MCP 接口：通过 Model Context Protocol 暴露 Gateway 能力，支持 Claude Code、Cursor、ChatGPT Agent 等 AI 智能体直接调用。
  • 语音能力：内置可插拔 TTS/STT 适配器架构，TTS 支持 OpenAI 兼容、小米 MiMo、豆包（火山引擎）等提供商，STT 支持 OpenAI 兼容、小米 MiMo 及本地 faster-whisper 离线识别。

Runtime Features

支持的能力

类型说明
Tools查询状态、查询事件链路、查询队列、模拟消息、触发任务、重试死信、节点管理
ResourcesGateway 状态、统计数据、能力清单、队列状态、节点列表
Prompts故障诊断、频道测试、节点健康检查

Requirements

  • Python 3.10+
  • NapCatQQ
  • ncatbot 3.8.5
  • 可用的 OpenAI-compatible API 服务

说明：

  • .env 是首选配置来源。
  • config.ini 仍作为 QQ 连接参数的兼容回退。
  • 项目默认使用 Flask + Flask-SocketIO + Eventlet 提供 Web 服务。

Installation

git clone https://github.com/asukaneko/nekobot.git
cd nekobot

```bash #配置虚拟环境（可选） python -m venv venv source venv/bin/activate

快速开始

```bash

启动 Bot + MCP

python bot.py --mcp ```

服务端：config.ini 设置 transport = streamable-http，然后启动

python bot.py --mcp-only

windows: venv\Scripts\activate.bat

python -m pip install -r requirements.txt 


复制环境变量模板并填写必要配置：
bash cp .env.example .env 

至少建议先配置：
env WEB_PASSWORD=your_web_password 

如需启用 QQ Bot，还需要补充：
env BOT_UIN=your_qq_number ROOT=your_admin_qq_number WS_URI=ws://your_napcat_host:port TOKEN=your_napcat_token 

AI 服务的最小示例：
env API_KEY=your_api_key BASE_URL=https://your-openai-compatible-endpoint/v1 MODEL=your_model_name ```

但你仍然可以通过web界面来配置你的模型

Claude Code 配置

在项目根目录创建 .mcp.json：

{
  "mcpServers": {
    "nekobot": {
      "command": "python",
      "args": ["bot.py", "--mcp-only"],
      "env": {
        "PYTHONPATH": "."
      }
    }
  }
}
提示：bot.py 是相对路径，会从当前工作目录查找。如果 Claude Code 不在项目根目录启动，需要通过 cwd 指定项目路径，或将 args 改为绝对路径。

Cursor 配置

在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "nekobot": {
      "command": "python",
      "args": ["bot.py", "--mcp-only"],
      "env": {
        "PYTHONPATH": "."
      }
    }
  }
}

MCP 配置项

在 config.ini 中配置 MCP 行为：

[mcp]
; 是否允许 MCP 发送真实消息（高危，默认关闭）
send_message_enabled = false
; 重试死信是否需要确认
retry_require_confirmation = true
; 审计日志
audit_enabled = true
; 授予 MCP 全部权限（本地使用建议开启）
admin = true
; 传输模式: stdio (本地) | streamable-http (远程)
transport = stdio
; 服务端配置（streamable-http 模式）
host = 127.0.0.1
port = 5001
; 远程连接 URL（--mcp-connect 使用）
connect_url = http://127.0.0.1:5001/mcp

[gateway]
; Gateway 持久化存储（启用后可查询历史事件）
storage_enabled = true
data_dir = data/web

CLI only

python bot.py --cli

CLI + Web

python bot.py --cli-and-web

🎯 aiskill88 AI 点评 A 级 2026-07-08

aiskill88点评：功能覆盖全面，将MCP与角色扮演结合具有前瞻性，是构建复杂AI人格的优秀框架。

⚡ 核心功能

👥 适合人群

AI 技术爱好者研究人员和学生开发者和工程师技术创业者

🎯 使用场景

  • 本地部署运行，保护数据隐私，满足合规要求
  • 自定义集成到现有系统，扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发

⚖️ 优点与不足

✅ 优点
  • +MIT 协议，可免费商用
  • +完全开源免费，无授权费用
  • +本地部署，数据完全自主可控
  • +开发者社区支持，遇问题可查可问
⚠️ 不足
  • −安装和初始配置可能需要一定技术基础
  • −功能完整性通常不如成熟商业产品
  • −技术支持主要依赖开源社区，响应速度不稳定
⚠️ 使用须知

AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。

📄 License 说明

✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。

🔗 相关工具推荐

Nuwax Agent OS
一个企业级的AI Agent开发与运维平台，基于MCP协议实现Agent与工具的标准化连接。提供沙箱环境和Agent-t
AgentScope智能体框架
AI工具
Claude代码智能体系统
基于Claude的MCP开源智能体框架，集成技能、本能、记忆和搜索能力。通过优化agent性能，支持复杂代码生成和自动化
Claude技能资源库
精心策划的Claude AI技能、资源和工具集合。支持MCP协议，提供Agent技能模板和自动化工具，适合Claude开
🧩 你可能还需要
基于当前 Skill 的能力图谱，自动补全的工具组合
技能寻求者
MCP · Agent · 工作流
DeepCode Agent工作流
MCP · Agent · 工作流
MemOS智能记忆系统
MCP · Agent · 工作流
natively-cluely-ai-assistant — Claude Skill 中文使用文档
免费开源的AI面试助手，实时转录，隐蔽模式，局部RAG，BYOK。无订阅，防止数据泄露。
mcp-proxy-for-aws MCP工具
为AWS服务提供MCP（模型上下文协议）代理的开源工具。支持SigV4签名认证，让大模型能通过标准MCP接口调用AWS API，适合需要集成
total-agent-memory MCP工具
为Claude Code和Codex CLI提供持久化记忆功能的开源MCP工具。自动提取知识图谱，支持多轮对话上下文保留，适合需要长期记忆和

❓ 常见问题 FAQ

它深度集成了角色卡系统和MCP工具调用，支持更强的记忆维持和外部知识库挂载。
💡 AI Skill Hub 点评

经综合评估，NekoBot 多频道AI角色扮演平台 在AI工具赛道中表现稳健，质量优秀。如果你已有明确的使用需求，可以直接上手体验；如果还在评估阶段，建议对比同类工具后再做决策。

📚 深入学习 NekoBot 多频道AI角色扮演平台
查看分步骤安装教程和完整使用指南，快速上手这款工具
⚙️ 安装教程 📚 使用教程
🌐 原始信息
原始名称 nekobot
Topics 角色扮演MCP协议记忆系统可视化管理
GitHub https://github.com/asukaneko/nekobot
License MIT
语言 Python
🔗 原始来源
🐙 GitHub 仓库  https://github.com/asukaneko/nekobot 🌐 官方网站  https://asukaneko.github.io/nekobot/

收录时间：2026-07-08 · 更新时间：2026-07-08 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。

📺 订阅 AI Skill Hub Daily Telegram 频道
每天 8 条精选 AI Skill、MCP、Agent 与自动化工具推送
加入频道 →