[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-wzpan--wukong-robot":3,"tool-wzpan--wukong-robot":62},[4,18,28,37,45,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":24,"last_commit_at":25,"category_tags":26,"status":17},9989,"n8n","n8n-io\u002Fn8n","n8n 是一款面向技术团队的公平代码（fair-code）工作流自动化平台，旨在让用户在享受低代码快速构建便利的同时，保留编写自定义代码的灵活性。它主要解决了传统自动化工具要么过于封闭难以扩展、要么完全依赖手写代码效率低下的痛点，帮助用户轻松连接 400 多种应用与服务，实现复杂业务流程的自动化。\n\nn8n 特别适合开发者、工程师以及具备一定技术背景的业务人员使用。其核心亮点在于“按需编码”：既可以通过直观的可视化界面拖拽节点搭建流程，也能随时插入 JavaScript 或 Python 代码、调用 npm 包来处理复杂逻辑。此外，n8n 原生集成了基于 LangChain 的 AI 能力，支持用户利用自有数据和模型构建智能体工作流。在部署方面，n8n 提供极高的自由度，支持完全自托管以保障数据隐私和控制权，也提供云端服务选项。凭借活跃的社区生态和数百个现成模板，n8n 让构建强大且可控的自动化系统变得简单高效。",184740,2,"2026-04-19T23:22:26",[16,14,13,15,27],"插件",{"id":29,"name":30,"github_repo":31,"description_zh":32,"stars":33,"difficulty_score":10,"last_commit_at":34,"category_tags":35,"status":17},10095,"AutoGPT","Significant-Gravitas\u002FAutoGPT","AutoGPT 是一个旨在让每个人都能轻松使用和构建 AI 的强大平台，核心功能是帮助用户创建、部署和管理能够自动执行复杂任务的连续型 AI 智能体。它解决了传统 AI 应用中需要频繁人工干预、难以自动化长流程工作的痛点，让用户只需设定目标，AI 即可自主规划步骤、调用工具并持续运行直至完成任务。\n\n无论是开发者、研究人员，还是希望提升工作效率的普通用户，都能从 AutoGPT 中受益。开发者可利用其低代码界面快速定制专属智能体；研究人员能基于开源架构探索多智能体协作机制；而非技术背景用户也可直接选用预置的智能体模板，立即投入实际工作场景。\n\nAutoGPT 的技术亮点在于其模块化“积木式”工作流设计——用户通过连接功能块即可构建复杂逻辑，每个块负责单一动作，灵活且易于调试。同时，平台支持本地自托管与云端部署两种模式，兼顾数据隐私与使用便捷性。配合完善的文档和一键安装脚本，即使是初次接触的用户也能在几分钟内启动自己的第一个 AI 智能体。AutoGPT 正致力于降低 AI 应用门槛，让人人都能成为 AI 的创造者与受益者。",183572,"2026-04-20T04:47:55",[13,36,27,14,15],"语言模型",{"id":38,"name":39,"github_repo":40,"description_zh":41,"stars":42,"difficulty_score":10,"last_commit_at":43,"category_tags":44,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":46,"name":47,"github_repo":48,"description_zh":49,"stars":50,"difficulty_score":24,"last_commit_at":51,"category_tags":52,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",161692,"2026-04-20T11:33:57",[14,13,36],{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":59,"last_commit_at":60,"category_tags":61,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,27],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":78,"owner_email":79,"owner_twitter":78,"owner_website":80,"owner_url":81,"languages":82,"stars":107,"forks":108,"last_commit_at":109,"license":110,"difficulty_score":10,"env_os":111,"env_gpu":112,"env_ram":112,"env_deps":113,"category_tags":119,"github_topics":121,"view_count":24,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":139,"updated_at":140,"faqs":141,"releases":142},10068,"wzpan\u002Fwukong-robot","wukong-robot","🤖 wukong-robot 是一个简单、灵活、优雅的中文语音对话机器人\u002F智能音箱项目，支持ChatGPT多轮对话能力，还可能是首个支持脑机交互的开源智能音箱项目。","wukong-robot 是一款专为中文环境打造的开源智能音箱项目，旨在帮助开发者轻松构建个性化的语音对话机器人。它解决了传统智能设备封闭、难以定制的问题，让用户能够自由组合语音识别、合成及对话逻辑，打造专属的智能助手。\n\n该项目特别适合热爱动手的 Maker、黑客以及希望深入探索语音交互技术的开发者使用。wukong-robot 拥有高度模块化的架构，支持接入百度、讯飞、OpenAI Whisper 等多种主流语音技术，并能无缝集成 ChatGPT 实现流畅的多轮对话。其独特亮点在于丰富的唤醒方式，不仅支持离线语音指令，更可能是全球首个支持脑机接口（BCI）唤醒的开源音箱项目，同时也兼容摇一摇等趣味交互。此外，它还具备强大的智能家居联动能力，可对接小爱同学、HomeAssistant 等平台。凭借简洁的安装流程和灵活的配置选项，wukong-robot 让每个人都能低门槛地体验从硬件组装到软件定义的全流程智能音箱开发乐趣。","# wukong-robot\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwukong.hahack.com\" target=\"_blank\">\n    \u003Cimg width=\"128\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_5f23366a6bbe.png\" alt=\"wukong-robot\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  wukong-robot 是一个简单、灵活、优雅的中文语音对话机器人\u002F智能音箱项目，目的是让中国的 Maker 和 Haker 们也能快速打造个性化的智能音箱。wukong-robot 还可能是第一个开源的脑机唤醒智能音箱。  \n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  截至 2023 年 3 月 31 日，wukong-robot 的安装设备数已超过 13,000 台，唤醒次数累积超过了 700,000 次。\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fusers\u002Fwzpan\u002Fprojects\u002F2\u002Fviews\u002F1\">\u003Cimg alt=\"wukong-project\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fproject-wukong-informational.svg?style=flat-square\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fdonate\">\u003Cimg alt=\"捐赠\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F%EF%BF%A5-donate-green.svg?style=flat-square\">\u003C\u002Fa>\n  \u003Ca href=\"#\">\u003Cimg alt=\"Python3.7+\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython->=3.7-blue.svg?style=flat-square\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fhub.docker.com\u002Fr\u002Fwzpan\u002Fwukong-robot\">\u003Cimg alt=\"docker-pulls\" src=\"https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fpulls\u002Fwzpan\u002Fwukong-robot.svg?style=flat-square&colorB=success\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub1s.com\u002Fwzpan\u002Fwukong-robot\">\u003Cimg alt=\"browse-code\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fbrowse-code-purple.svg?style=flat-square\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fcontribute\u002Ftier\u002F8131-sponsor\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsors.svg?avatarHeight=36\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n## Table of Contents\n\n* [特性](#特性)\n* [Demo](#demo)\n* [环境要求](#环境要求)\n* [安装](#安装)\n* [升级](#升级)\n* [运行](#运行)\n* [配置](#配置)\n* [技能插件](#插件)\n* [API接口](#api-接口)\n* [捐赠](#捐赠)\n* [贡献](#贡献)\n* [引用](#引用)\n* [联系](#联系)\n* [感谢](#感谢)\n* [FAQ](#faq)\n* [免责声明](#免责声明)\n\n## 特性\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_b6ec5a8a9d96.png\" alt=\"wukong-robot\">\n\u003C\u002Fp>\n\n* 模块化。功能插件、语音识别、语音合成、对话机器人都做到了高度模块化，第三方插件单独维护，方便继承和开发自己的插件。\n* 中文支持。集成百度、科大讯飞、阿里、腾讯、OpenAI Whisper、Apple、微软Edge、VITS声音克隆TTS 等多家中文语音识别和语音合成技术，且可以继续扩展。\n* 对话机器人支持。支持基于 [AnyQ](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fanyq) 的本地对话机器人，并支持接入图灵机器人、ChatGPT 等在线对话机器人。\n* 全局监听，离线唤醒。支持 [Porcupine](https:\u002F\u002Fgithub.com\u002FPicovoice\u002Fporcupine) 和 [snowboy](https:\u002F\u002Fgithub.com\u002FKitt-AI\u002Fsnowboy) 两套离线语音指令唤醒引擎，并支持 Muse [脑机唤醒](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fbci) 以及行空板摇一摇唤醒等其他唤醒方式。\n* 灵活可配置。支持定制机器人名字，支持选择语音识别和合成的插件。\n* 智能家居。支持和 [小爱音箱](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Flinkage)、[Siri](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Flinkage)、mqtt、[HomeAssistant](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fsmarthome) 等智能家居协议联动，支持语音控制智能家电。\n* 后台配套支持。提供配套后台，可实现远程操控、修改配置和日志查看等功能。\n* 开放API。可利用后端开放的API，实现更丰富的功能。\n* 安装简单，支持更多平台。相比 dingdang-robot ，舍弃了 PocketSphinx 的离线唤醒方案，安装变得更加简单，代码量更少，更易于维护并且能在 Mac 以及更多 Linux 系统中运行。\n\nwukong-robot 的功能还在不断更新迭代中，详见 [更新说明](https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-robot\u002Fwiki\u002Fupdate-notes) 。\n\nwukong-robot 的工作模式：\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_f87c50a786a2.png\" alt=\"wukong-robot 的工作模式\">\n\u003C\u002Fp>\n\nwukong-robot 被唤醒后，用户的语音指令先经过 ASR 引擎进行 ASR 识别成文本，然后对识别到的文本进行 NLU 解析，再将解析结果进行技能匹配，交给适合处理该指令的技能插件去处理。插件处理完成后，得到的结果再交给 TTS 引擎合成成语音，播放给用户。\n\n虽然一次交互可能包含多次网络请求，不过带来的好处是：每一个环节都可以被修改和定制。而且我认为，到了 5G 时代，音箱的响应速度将不再成为体验问题。可定制和个性化才是未来的主流，而届时 wukong-robot 将会是更好的选择！\n\n## Demo\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_8c63f7ca2a3c.jpg\" alt=\"demo\">\n\u003C\u002Fp>\n\n* Demo视频：\n  - [wukong-robot + ChatGPT 实现支持流式对话的智能音箱（一分半钟）](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1Bh411g7t2)\n  - [粉丝向定制版，演示对话+音乐+开放API+智能家居（五分钟）](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002Fav50685517\u002F)\n  - [使用脑机唤醒 wukong-robot](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002Fav76739580\u002F)\n  - [Google AIY Voice Kit + wukong-robot](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002Fav81173082\u002F)\n  - [Siri 联动 wukong-robot + ChatGPT](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1yY4y1y7oW)\n  - [小爱同学联动 wukong-robot](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1eg4y1b75Y)\n  - [教程：基于树莓派&wukong-robot&VITS的AI泠鸢开源智能音箱的初步实现（by @二维环状无限深势阱）](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1Sc411K7dv)\n  - [教程：实现一个虚拟管家：贾维斯(by @Echo）](https:\u002F\u002Fzhuanlan.zhihu.com\u002Fp\u002F655865035)\n* 后台管理端 Demo\n  - 体验地址：https:\u002F\u002Fbot.hahack.com  （体验用户名：wukong；体验密码：wukong@2019）\n\n## 环境要求 ##\n\n### Python 版本 ###\n\nwukong-robot 只支持 Python >= 3.7 且 \u003C 3.10 ，不支持 Python 2.x 。\n\n### 设备要求 ###\n\nwukong-robot 支持运行在以下的设备和系统中：\n\n* Intel Chip Mac (不支持 M1 芯片)\n* 64bit Ubuntu（12.04 and 14.04）\n* 全系列的树莓派（Raspbian 系统）\n* Pine 64 with Debian Jessie 8.5（3.10.102）\n* Intel Edison with Ubilinux （Debian Wheezy 7.8）\n* 装有 WSL（Windows Subsystem for Linux） 的 Windows\n\n## 安装 ##\n\n见 [wukong-robot 安装教程](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Finstall) 。\n\n## 升级\n\n``` bash\npython3 wukong.py update\n```\n\n如果提示升级失败，可以尝试在 wukong-robot 的根目录手动执行以下命令，看看问题出在哪。\n\n``` sh\ngit pull\npip3 install -r requirements.txt\n```\n\n## 运行 ##\n\n``` bash\npython3 wukong.py\n```\n\n建议在 [tmux](http:\u002F\u002Fblog.jobbole.com\u002F87278\u002F) 或 supervisor 中执行。\n\n第一次启动时将提示你是否要到用户目录下创建一个配置文件，输入 `y` 即可。\n\n然后通过唤醒词 “snowboy” 唤醒 wukong-robot 进行交互（该唤醒词可自定义）。\n\n此外，wukong-robot 默认在运行期间还会启动一个后台管理端，提供了远程对话、查看修改配置、查看 log 等能力。\n\n- 默认地址：http:\u002F\u002Flocalhost:5001\n- 默认账户名：wukong\n- 默认密码：wukong@2019\n\n建议正式使用时修改用户名和密码，以免泄漏隐私。\n\n## 配置 ##\n\n参考[配置文件的注释](https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-robot\u002Fblob\u002Fmaster\u002Fstatic\u002Fdefault.yml)进行配置即可。注意不建议直接修改 default.yml 里的内容，否则会给后续通过 `git pull` 更新带来麻烦。你应该拷贝一份放到 `$HOME\u002F.wukong\u002Fconfig.yml` 中，或者在运行的时候按照提示让 wukong-robot 为你完成这件事。\n\n> tips：不论使用哪个厂商的API，都建议注册并填上自己注册的应用信息，而不要用默认的配置。这是因为这些API都有使用频率和并发数限制，过多人同时使用会影响服务质量。\n\n## 技能插件 ##\n\n* [官方插件列表](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fofficial)\n* [用户贡献插件](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fcontrib)\n\n## API 接口 ##\n\nwukong-robot 的后台接口是开放 Web API 的，可以使用 Restful 方式调用，见 [后台API](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fapi)。\n\n## 捐赠\n\n您的捐赠将鼓励我继续完善 wukong-robot。\n\n* 对于个人用户，可以使用支付宝或者微信进行捐赠，单笔超过 100 元的捐赠者，您的 ID 将可以出现在 wukong-robot 后台管理端的捐赠页面中。\n\n \n| 支付宝 | 微信支付 |\n| ------ | --------- |\n| \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_36d04617283a.png\" height=\"248px\" width=\"164px\" title=\"支付宝\" style=\"display:inherit;\"\u002F> | \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_91a1fc574250.jpeg\" height=\"248px\" width=\"164px\" title=\"微信支付\" style=\"display:inherit;\"\u002F> |\n\n如果以上的图裂了，可以下载图片（[支付宝](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_36d04617283a.png) | [微信](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_91a1fc574250.jpeg)）到本地进行扫描。\n\n* 对于企业用户，建议[成为这个项目的 backer](https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fcontribute\u002Ftier\u002F8131-sponsor)，您将可以把一个带链接的 logo 放在 wukong-robot 后台管理端的首页、捐赠页面以及 Github 项目首页中。\n\n\u003Cp>\n  \u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F0\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F0\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F1\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F1\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F2\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F2\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F3\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F3\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F4\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F4\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F5\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F5\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F6\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F6\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F7\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F7\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F8\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F8\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F9\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F9\u002Favatar.svg\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n## 贡献\n\n* 喜欢本项目请先打一颗星；\n* 提 bug 请到 [issue 页面](https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-robot\u002Fissues)；\n* 要贡献代码，欢迎 fork 之后再提 pull request；\n* 插件请提交到 [wukong-contrib](https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-contrib) ；\n\n\n## 引用\n\n如果使用本项目的代码或插件，请引用本项目。\n\n```\n@misc{wukong-robot,\n  author = {潘伟洲},\n  title = {wukong-robot，一个简单、灵活、优雅的中文语音对话机器人\u002F智能音箱项目},\n  year = {2019},\n  publisher = {GitHub},\n  journal = {GitHub repository},\n  howpublished = {\\url{https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-robot}},\n}\n```\n\n\n## 联系\n\n* wukong-robot 的主要开发者是 [潘伟洲](http:\u002F\u002Fhahack.com) 。\n* QQ 频道（推荐）：\n\n使用 QQ 扫码加入：\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_fbe376d25a97.png)\n\n* QQ 群：580447290（人数将满，为控制人数，需付费20元入群。微信或支付宝支付后，申请入群时贴上转账单号即可。**群收入的前一万元已无偿捐赠给[壹基金等公益项目](https:\u002F\u002Fhahack-1253537070.cos.ap-chengdu.myqcloud.com\u002Fimages\u002Fdonate.png)**）。\n\n| 支付宝 | 微信支付 |\n| ------ | --------- |\n| \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_36d04617283a.png\" height=\"248px\" width=\"164px\" title=\"支付宝\" style=\"display:inherit;\"\u002F> | \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_91a1fc574250.jpeg\" height=\"248px\" width=\"164px\" title=\"微信支付\" style=\"display:inherit;\"\u002F> |\n\n如果以上的图裂了，可以下载图片（[支付宝](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_36d04617283a.png) | [微信](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_91a1fc574250.jpeg)）到本地进行扫描。\n\n## 感谢\n\n* 悟空的前身是 [dingdang-robot](https:\u002F\u002Fgithub.com\u002Fdingdang-robot\u002Fdingdang-robot) 项目和 [jasper-client](https:\u002F\u002Fgithub.com\u002Fjasperproject\u002Fjasper-client) 项目。感谢 [Shubhro Saha](http:\u002F\u002Fwww.shubhro.com\u002F), [Charles Marsh](http:\u002F\u002Fwww.crmarsh.com\u002F) and [Jan Holthuis](http:\u002F\u002Fhomepage.ruhr-uni-bochum.de\u002FJan.Holthuis\u002F) 在 Jasper 项目上做出的优秀贡献；\n* 感谢三咲智子提供了备选的后台管理端 Demo 体验地址。\n* 感谢 aliciacai 贡献的 wukong-robot 图标。\n* 感谢所有为[本项目](https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-robot\u002Fgraphs\u002Fcontributors)、 [wukong-contrib](https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-contrib\u002Fgraphs\u002Fcontributors) 项目以及[dingdang-robot](https:\u002F\u002Fgithub.com\u002Fdingdang-robot\u002Fdingdang-robot\u002Fgraphs\u002Fcontributors) 项目做出过贡献的人！\n\n## Star 历史\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_5cb8bc7a84a4.png)](https:\u002F\u002Fstar-history.com\u002F#wzpan\u002Fwukong-robot&Date)\n\n## 免责声明\n\n* wukong-robot 只用作个人学习研究，如因使用 wukong-robot 导致任何损失，本人概不负责。\n* 本开源项目与腾讯叮当助手及优必选悟空项目没有任何关系。\n","# 悟空-机器人\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwukong.hahack.com\" target=\"_blank\">\n    \u003Cimg width=\"128\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_5f23366a6bbe.png\" alt=\"wukong-robot\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  wukong-robot 是一个简单、灵活、优雅的中文语音对话机器人\u002F智能音箱项目，目的是让中国的 Maker 和 Haker 们也能快速打造个性化的智能音箱。wukong-robot 还可能是第一个开源的脑机唤醒智能音箱。  \n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  截至 2023 年 3 月 31 日，wukong-robot 的安装设备数已超过 13,000 台，唤醒次数累积超过了 700,000 次。\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fusers\u002Fwzpan\u002Fprojects\u002F2\u002Fviews\u002F1\">\u003Cimg alt=\"wukong-project\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fproject-wukong-informational.svg?style=flat-square\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fdonate\">\u003Cimg alt=\"捐赠\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F%EF%BF%A5-donate-green.svg?style=flat-square\">\u003C\u002Fa>\n  \u003Ca href=\"#\">\u003Cimg alt=\"Python3.7+\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython->=3.7-blue.svg?style=flat-square\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fhub.docker.com\u002Fr\u002Fwzpan\u002Fwukong-robot\">\u003Cimg alt=\"docker-pulls\" src=\"https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fpulls\u002Fwzpan\u002Fwukong-robot.svg?style=flat-square&colorB=success\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub1s.com\u002Fwzpan\u002Fwukong-robot\">\u003Cimg alt=\"browse-code\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fbrowse-code-purple.svg?style=flat-square\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fcontribute\u002Ftier\u002F8131-sponsor\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsors.svg?avatarHeight=36\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n## 目录\n\n* [特性](#特性)\n* [Demo](#demo)\n* [环境要求](#环境要求)\n* [安装](#安装)\n* [升级](#升级)\n* [运行](#运行)\n* [配置](#配置)\n* [技能插件](#插件)\n* [API接口](#api-接口)\n* [捐赠](#捐赠)\n* [贡献](#贡献)\n* [引用](#引用)\n* [联系](#联系)\n* [感谢](#感谢)\n* [FAQ](#faq)\n* [免责声明](#免责声明)\n\n## 特性\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_b6ec5a8a9d96.png\" alt=\"wukong-robot\">\n\u003C\u002Fp>\n\n* 模块化。功能插件、语音识别、语音合成、对话机器人都做到了高度模块化，第三方插件单独维护，方便继承和开发自己的插件。\n* 中文支持。集成百度、科大讯飞、阿里、腾讯、OpenAI Whisper、Apple、微软Edge、VITS声音克隆TTS 等多家中文语音识别和语音合成技术，且可以继续扩展。\n* 对话机器人支持。支持基于 [AnyQ](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fanyq) 的本地对话机器人，并支持接入图灵机器人、ChatGPT 等在线对话机器人。\n* 全局监听，离线唤醒。支持 [Porcupine](https:\u002F\u002Fgithub.com\u002FPicovoice\u002Fporcupine) 和 [snowboy](https:\u002F\u002Fgithub.com\u002FKitt-AI\u002Fsnowboy) 两套离线语音指令唤醒引擎，并支持 Muse [脑机唤醒](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fbci) 以及行空板摇一摇唤醒等其他唤醒方式。\n* 灵活可配置。支持定制机器人名字，支持选择语音识别和合成的插件。\n* 智能家居。支持和 [小爱音箱](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Flinkage)、[Siri](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Flinkage)、mqtt、[HomeAssistant](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fsmarthome) 等智能家居协议联动，支持语音控制智能家电。\n* 后台配套支持。提供配套后台，可实现远程操控、修改配置和日志查看等功能。\n* 开放API。可利用后端开放的API，实现更丰富的功能。\n* 安装简单，支持更多平台。相比 dingdang-robot ，舍弃了 PocketSphinx 的离线唤醒方案，安装变得更加简单，代码量更少，更易于维护并且能在 Mac 以及更多 Linux 系统中运行。\n\nwukong-robot 的功能还在不断更新迭代中，详见 [更新说明](https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-robot\u002Fwiki\u002Fupdate-notes) 。\n\nwukong-robot 的工作模式：\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_f87c50a786a2.png\" alt=\"wukong-robot 的工作模式\">\n\u003C\u002Fp>\n\nwukong-robot 被唤醒后，用户的语音指令先经过 ASR 引擎进行 ASR 识别成文本，然后对识别到的文本进行 NLU 解析，再将解析结果进行技能匹配，交给适合处理该指令的技能插件去处理。插件处理完成后，得到的结果再交给 TTS 引擎合成成语音，播放给用户。\n\n虽然一次交互可能包含多次网络请求，不过带来的好处是：每一个环节都可以被修改和定制。而且我认为，到了 5G 时代，音箱的响应速度将不再成为体验问题。可定制和个性化才是未来的主流，而届时 wukong-robot 将会是更好的选择！\n\n## Demo\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_8c63f7ca2a3c.jpg\" alt=\"demo\">\n\u003C\u002Fp>\n\n* Demo视频：\n  - [wukong-robot + ChatGPT 实现支持流式对话的智能音箱（一分半钟）](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1Bh411g7t2)\n  - [粉丝向定制版，演示对话+音乐+开放API+智能家居（五分钟）](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002Fav50685517\u002F)\n  - [使用脑机唤醒 wukong-robot](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002Fav76739580\u002F)\n  - [Google AIY Voice Kit + wukong-robot](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002Fav81173082\u002F)\n  - [Siri 联动 wukong-robot + ChatGPT](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1yY4y1y7oW)\n  - [小爱同学联动 wukong-robot](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1eg4y1b75Y)\n  - [教程：基于树莓派&wukong-robot&VITS的AI泠鸢开源智能音箱的初步实现（by @二维环状无限深势阱）](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1Sc411K7dv)\n  - [教程：实现一个虚拟管家：贾维斯(by @Echo）](https:\u002F\u002Fzhuanlan.zhihu.com\u002Fp\u002F655865035)\n* 后台管理端 Demo\n  - 体验地址：https:\u002F\u002Fbot.hahack.com  （体验用户名：wukong；体验密码：wukong@2019）\n\n## 环境要求 ##\n\n### Python 版本 ###\n\nwukong-robot 只支持 Python >= 3.7 且 \u003C 3.10 ，不支持 Python 2.x 。\n\n### 设备要求 ###\n\nwukong-robot 支持运行在以下的设备和系统中：\n\n* Intel Chip Mac (不支持 M1 芯片)\n* 64bit Ubuntu（12.04 and 14.04）\n* 全系列的树莓派（Raspbian 系统）\n* Pine 64 with Debian Jessie 8.5（3.10.102）\n* Intel Edison with Ubilinux （Debian Wheezy 7.8）\n* 装有 WSL（Windows Subsystem for Linux） 的 Windows\n\n## 安装 ##\n\n见 [wukong-robot 安装教程](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Finstall) 。\n\n## 升级\n\n``` bash\npython3 wukong.py update\n```\n\n如果提示升级失败，可以尝试在 wukong-robot 的根目录手动执行以下命令，看看问题出在哪。\n\n``` sh\ngit pull\npip3 install -r requirements.txt\n```\n\n## 运行 ##\n\n``` bash\npython3 wukong.py\n```\n\n建议在 [tmux](http:\u002F\u002Fblog.jobbole.com\u002F87278\u002F) 或 supervisor 中执行。\n\n第一次启动时将提示你是否要到用户目录下创建一个配置文件，输入 `y` 即可。\n\n然后通过唤醒词 “snowboy” 唤醒 wukong-robot 进行交互（该唤醒词可自定义）。\n\n此外，wukong-robot 默认在运行期间还会启动一个后台管理端，提供了远程对话、查看修改配置、查看 log 等能力。\n\n- 默认地址：http:\u002F\u002Flocalhost:5001\n- 默认账户名：wukong\n- 默认密码：wukong@2019\n\n建议正式使用时修改用户名和密码，以免泄漏隐私。\n\n## 配置 ##\n\n参考[配置文件的注释](https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-robot\u002Fblob\u002Fmaster\u002Fstatic\u002Fdefault.yml)进行配置即可。注意不建议直接修改 default.yml 里的内容，否则会给后续通过 `git pull` 更新带来麻烦。你应该拷贝一份放到 `$HOME\u002F.wukong\u002Fconfig.yml` 中，或者在运行的时候按照提示让 wukong-robot 为你完成这件事。\n\n> tips：不论使用哪个厂商的API，都建议注册并填上自己注册的应用信息，而不要用默认的配置。这是因为这些API都有使用频率和并发数限制，过多人同时使用会影响服务质量。\n\n## 技能插件 ##\n\n* [官方插件列表](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fofficial)\n* [用户贡献插件](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fcontrib)\n\n## API 接口 ##\n\nwukong-robot 的后台接口是开放 Web API 的，可以使用 Restful 方式调用，见 [后台API](https:\u002F\u002Fwukong.hahack.com\u002F#\u002Fapi)。\n\n## 捐赠\n\n您的捐赠将鼓励我继续完善 wukong-robot。\n\n* 对于个人用户，可以使用支付宝或者微信进行捐赠，单笔超过 100 元的捐赠者，您的 ID 将可以出现在 wukong-robot 后台管理端的捐赠页面中。\n\n \n| 支付宝 | 微信支付 |\n| ------ | --------- |\n| \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_36d04617283a.png\" height=\"248px\" width=\"164px\" title=\"支付宝\" style=\"display:inherit;\"\u002F> | \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_91a1fc574250.jpeg\" height=\"248px\" width=\"164px\" title=\"微信支付\" style=\"display:inherit;\"\u002F> |\n\n如果以上的图裂了，可以下载图片（[支付宝](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_36d04617283a.png) | [微信](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_91a1fc574250.jpeg)）到本地进行扫描。\n\n* 对于企业用户，建议[成为这个项目的 backer](https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fcontribute\u002Ftier\u002F8131-sponsor)，您将可以把一个带链接的 logo 放在 wukong-robot 后台管理端的首页、捐赠页面以及 Github 项目首页中。\n\n\u003Cp>\n  \u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F0\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F0\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F1\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F1\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F2\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F2\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F3\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F3\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F4\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F4\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F5\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F5\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F6\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F6\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F7\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F7\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F8\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F8\u002Favatar.svg\">\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F9\u002Fwebsite\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fopencollective.com\u002Fwukong-robot\u002Fsponsor\u002F9\u002Favatar.svg\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n## 贡献\n\n* 喜欢本项目请先打一颗星；\n* 提 bug 请到 [issue 页面](https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-robot\u002Fissues)；\n* 要贡献代码，欢迎 fork 之后再提 pull request；\n* 插件请提交到 [wukong-contrib](https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-contrib) ；\n\n\n## 引用\n\n如果使用本项目的代码或插件，请引用本项目。\n\n```\n@misc{wukong-robot,\n  author = {潘伟洲},\n  title = {wukong-robot，一个简单、灵活、优雅的中文语音对话机器人\u002F智能音箱项目},\n  year = {2019},\n  publisher = {GitHub},\n  journal = {GitHub repository},\n  howpublished = {\\url{https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-robot}},\n}\n```\n\n\n## 联系\n\n* wukong-robot 的主要开发者是 [潘伟洲](http:\u002F\u002Fhahack.com) 。\n* QQ 频道（推荐）：\n\n使用 QQ 扫码加入：\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_fbe376d25a97.png)\n\n* QQ 群：580447290（人数将满，为控制人数，需付费20元入群。微信或支付宝支付后，申请入群时贴上转账单号即可。**群收入的前一万元已无偿捐赠给[壹基金等公益项目](https:\u002F\u002Fhahack-1253537070.cos.ap-chengdu.myqcloud.com\u002Fimages\u002Fdonate.png)**）。\n\n| 支付宝 | 微信支付 |\n| ------ | --------- |\n| \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_36d04617283a.png\" height=\"248px\" width=\"164px\" title=\"支付宝\" style=\"display:inherit;\"\u002F> | \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_91a1fc574250.jpeg\" height=\"248px\" width=\"164px\" title=\"微信支付\" style=\"display:inherit;\"\u002F> |\n\n如果以上的图裂了，可以下载图片（[支付宝](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_36d04617283a.png) | [微信](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_91a1fc574250.jpeg)）到本地进行扫描。\n\n## 感谢\n\n* 悟空的前身是 [dingdang-robot](https:\u002F\u002Fgithub.com\u002Fdingdang-robot\u002Fdingdang-robot) 项目和 [jasper-client](https:\u002F\u002Fgithub.com\u002Fjasperproject\u002Fjasper-client) 项目。感谢 [Shubhro Saha](http:\u002F\u002Fwww.shubhro.com\u002F), [Charles Marsh](http:\u002F\u002Fwww.crmarsh.com\u002F) and [Jan Holthuis](http:\u002F\u002Fhomepage.ruhr-uni-bochum.de\u002FJan.Holthuis\u002F) 在 Jasper 项目上做出的优秀贡献；\n* 感谢三咲智子提供了备选的后台管理端 Demo 体验地址。\n* 感谢 aliciacai 贡献的 wukong-robot 图标。\n* 感谢所有为[本项目](https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-robot\u002Fgraphs\u002Fcontributors)、 [wukong-contrib](https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-contrib\u002Fgraphs\u002Fcontributors) 项目以及[dingdang-robot](https:\u002F\u002Fgithub.com\u002Fdingdang-robot\u002Fdingdang-robot\u002Fgraphs\u002Fcontributors) 项目做出过贡献的人！\n\n## Star 历史\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_readme_5cb8bc7a84a4.png)](https:\u002F\u002Fstar-history.com\u002F#wzpan\u002Fwukong-robot&Date)\n\n## 免责声明\n\n* wukong-robot 只用作个人学习研究，如因使用 wukong-robot 导致任何损失，本人概不负责。\n* 本开源项目与腾讯叮当助手及优必选悟空项目没有任何关系。","# wukong-robot 快速上手指南\n\nwukong-robot 是一个简单、灵活、优雅的中文语音对话机器人\u002F智能音箱开源项目，支持多种语音识别（ASR）、合成（TTS）引擎及对话机器人接入，旨在帮助开发者快速打造个性化的智能音箱。\n\n## 环境准备\n\n### 系统要求\nwukong-robot 支持以下设备和操作系统：\n*   **Mac**: Intel 芯片 Mac（**不支持** M1\u002FM2 等 Apple Silicon 芯片）\n*   **Linux**: 64bit Ubuntu (12.04\u002F14.04), Raspbian (全系列树莓派), Debian Jessie 8.5 (Pine 64) 等\n*   **Windows**: 需安装 WSL (Windows Subsystem for Linux)\n\n### 前置依赖\n*   **Python 版本**: 必须满足 `3.7 \u003C= Python \u003C 3.10`，不支持 Python 2.x。\n*   **硬件**: 需要麦克风用于录音，扬声器用于播放语音。\n*   **网络**: 大部分语音引擎和对话功能需要联网使用。\n\n## 安装步骤\n\n### 1. 克隆项目\n将代码克隆到本地：\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fwzpan\u002Fwukong-robot.git\ncd wukong-robot\n```\n\n### 2. 安装依赖\n安装项目所需的 Python 依赖包：\n```bash\npip3 install -r requirements.txt\n```\n> **提示**: 如果下载速度较慢，建议使用国内镜像源加速安装，例如：\n> ```bash\n> pip3 install -r requirements.txt -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n> ```\n\n## 基本使用\n\n### 1. 启动机器人\n在项目根目录下运行以下命令启动程序：\n```bash\npython3 wukong.py\n```\n\n### 2. 初始化配置\n*   **首次运行**：程序会提示是否在用户目录下创建配置文件，输入 `y` 确认。\n*   **配置修改**：建议不要直接修改 `static\u002Fdefault.yml`。请编辑生成的 `$HOME\u002F.wukong\u002Fconfig.yml` 文件，填入你申请的各平台（如百度、讯飞、ChatGPT 等）API Key 和 Secret。\n    > **注意**：请务必使用自己注册的 API 信息，默认配置仅供测试且有限制。\n\n### 3. 开始交互\n*   **唤醒**：默认使用唤醒词 **\"snowboy\"** 激活机器人（可在配置文件中自定义）。\n*   **对话**：唤醒后说出指令，机器人将自动进行语音识别、意图理解并回复。\n\n### 4. 后台管理（可选）\n运行时会自动启动 Web 管理端，方便远程查看日志和配置：\n*   **访问地址**: `http:\u002F\u002Flocalhost:5001`\n*   **默认账号**: `wukong`\n*   **默认密码**: `wukong@2019`\n> **安全提示**：正式使用前请务必在配置文件中修改默认用户名和密码。\n\n### 5. 升级维护\n如需更新到最新版本，可执行：\n```bash\npython3 wukong.py update\n```\n若自动升级失败，可手动执行：\n```bash\ngit pull\npip3 install -r requirements.txt\n```","独居的开发者阿明希望利用树莓派和旧音箱，为自己打造一个能听懂中文、支持多轮对话且能控制家中智能设备的个性化语音助手。\n\n### 没有 wukong-robot 时\n- **开发门槛极高**：若要自行整合语音识别（ASR）、自然语言理解（NLU）和语音合成（TTS），需分别对接多家厂商 API 并编写大量胶水代码，耗时数周仍难跑通。\n- **中文交互生硬**：市面上开源方案多针对英文优化，中文识别率低，且无法流畅接入 ChatGPT 进行有逻辑的多轮对话，体验像“人工智障”。\n- **智能家居割裂**：语音助手无法直接联动现有的 HomeAssistant 或小爱音箱设备，想通过语音关灯或查天气，必须切换不同 App 操作。\n- **唤醒方式单一**：仅支持按键或固定关键词唤醒，缺乏离线唤醒或脑机接口等极客玩法，无法满足定制化需求。\n\n### 使用 wukong-robot 后\n- **快速部署上线**：凭借高度模块化设计，阿明只需配置 YAML 文件即可集成百度 ASR 与 VITS 克隆音色，半天内就完成了从安装到运行的全流程。\n- **对话智能流畅**：直接启用 ChatGPT 插件，机器人不仅能精准识别中文指令，还能像真人一样进行上下文关联的流式对话，回答富有逻辑。\n- **生态无缝联动**：通过内置的智能家居插件，阿明用自然语言即可指挥 wukong-robot 调用 MQTT 协议控制灯光，甚至通过 Siri 间接触发复杂场景。\n- **玩法无限扩展**：除了常规的“悟空”唤醒词，他还成功接入了 Muse 脑机设备，实现了“意念唤醒”音箱播放音乐，真正打造了极客专属的智能终端。\n\nwukong-robot 将复杂的语音交互链路封装为灵活的积木，让普通创客也能低成本构建出具备工业级能力的中文智能音箱。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwzpan_wukong-robot_5f23366a.png","wzpan","潘伟洲","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fwzpan_bb32044e.png","技施于手，道养于心。\r\nWriting codes & growing tao.","@Tencent",null,"m@hahack.com","http:\u002F\u002Fhahack.com","https:\u002F\u002Fgithub.com\u002Fwzpan",[83,87,91,95,99,103],{"name":84,"color":85,"percentage":86},"Python","#3572A5",80.4,{"name":88,"color":89,"percentage":90},"HTML","#e34c26",8,{"name":92,"color":93,"percentage":94},"JavaScript","#f1e05a",6.6,{"name":96,"color":97,"percentage":98},"CSS","#663399",4.7,{"name":100,"color":101,"percentage":102},"Dockerfile","#384d54",0.3,{"name":104,"color":105,"percentage":106},"Shell","#89e051",0,7116,1413,"2026-04-19T12:51:24","MIT","Linux, macOS (Intel Chip)","未说明",{"notes":114,"python":115,"dependencies":116},"不支持 macOS M1 芯片；支持运行在 WSL (Windows Subsystem for Linux) 上；支持的 Linux 发行版包括 Ubuntu 12.04\u002F14.04、Raspbian (树莓派全系列)、Debian Jessie 8.5 (Pine 64)、Ubilinux (Intel Edison)；首次运行需创建配置文件；默认开启后台管理端 (端口 5001)。",">=3.7, \u003C3.10",[117,118],"requirements.txt (具体列表需查看项目文件)","git",[14,15,36,13,120],"音频",[122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138],"ai","speaker","asr","tts","unit","homeassistant","raspeberry-pi","amazon-echo","alexa","snowboy","google-home","anyq","muse","bci","chatgpt","gpt3","openai","2026-03-27T02:49:30.150509","2026-04-20T19:42:43.083423",[],[]]