<p align="center">
  <img src="site/media/readme-hero.png" width="100%" alt="nexu" />
</p>

<h1 align="center">nexu</h1>

<p align="center">
  <strong>让你的 AI Agent 直接运行在微信、飞书、Slack 等 IM 中的开源桌面客户端</strong>
</p>

<p align="center">
  <a href="https://github.com/nexu-io/nexu/releases"><img src="https://img.shields.io/github/v/release/nexu-io/nexu?color=blue" alt="Release" /></a>
  <a href="https://github.com/nexu-io/nexu/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License" /></a>
  <a href="https://github.com/nexu-io/nexu/stargazers"><img src="https://img.shields.io/github/stars/nexu-io/nexu?style=social" alt="Stars" /></a>
</p>

<p align="center">
  <a href="https://nexu.io" target="_blank" rel="noopener"><strong>🌐 官网</strong></a> &nbsp;·&nbsp;
  <a href="https://docs.nexu.io" target="_blank" rel="noopener"><strong>📖 文档</strong></a> &nbsp;·&nbsp;
  <a href="https://github.com/nexu-io/nexu/discussions"><strong>💬 Discussions</strong></a> &nbsp;·&nbsp;
  <a href="https://github.com/nexu-io/nexu/issues"><strong>🐛 Issues</strong></a> &nbsp;·&nbsp;
  <a href="https://x.com/nexudotio" target="_blank" rel="noopener"><strong>𝕏 Twitter</strong></a>
</p>

<p align="center">
  <a href="README.md">English</a> &nbsp;·&nbsp; 简体中文 &nbsp;·&nbsp; <a href="README.ja.md">日本語</a> &nbsp;·&nbsp; <a href="README.ko.md">한국어</a>
</p>

---

> 🦞 **最丝滑接入微信 OpenClaw**：扫码即连，开箱即用。
>
> 🖥 **已支持平台**：macOS（Apple Silicon）· macOS（Intel）· Windows — [立即下载](https://nexu.io)

---

## 📋 nexu（奈苏）是什么？

**nexu**（奈苏，next to you）是一个开源桌面客户端，让你的 **OpenClaw 🦞** Agent 直接运行在微信、飞书、Slack、Discord 等 IM 中。

**已支持微信接入 OpenClaw** —— 适配微信 8.0.7 OpenClaw 插件，点击连接、微信扫码，即可在微信中与 AI Agent 对话。

下载即用，图形化配置，内置飞书 Skills，支持 Gemini 等多模型与自带 API Key。

连接 IM 后，Agent 7×24 小时在线——手机上随时对话，不受桌面限制。

所有数据保存在本机，隐私安全，完全可控。

<h3 align="center">🎬 产品实操演示</h3>

<p align="center">
  <video src="https://github.com/user-attachments/assets/220170ce-b394-44de-8bb2-d71512b0eee1" width="100%" autoplay loop muted playsinline>
    您的浏览器不支持视频播放，请 <a href="https://github.com/user-attachments/assets/220170ce-b394-44de-8bb2-d71512b0eee1">点击下载</a> 观看。
  </video>
</p>

---

## 📊 与常见方案的区别

| | OpenClaw 官方 | 典型托管飞书龙虾方案 | **nexu** ✅ |
|---|---|---|---|
| **🧠 模型** | 自选，但需手动配置 ⚠️ | 平台指定，不可更换 ❌ | **自选 Gemini 等，GUI 一键切换；MiniMax / Codex / GLM 支持 OAuth** ✅ |
| **📡 数据路径** | 本地 | 经第三方服务器，数据不可控 ❌ | **本机为主，不托管你的业务数据** ✅ |
| **💰 费用** | 免费，但需自行部署 ⚠️ | 订阅 / 按席收费 ❌ | **客户端免费，按自备 API Key 计费** ✅ |
| **📜 源码** | 开源 | 闭源，无法审计 ❌ | **MIT 开源，可 fork、可审计** ✅ |
| **🔗 渠道** | 需自行对接 ⚠️ | 视产品而定，常有限制 ❌ | **内置微信、飞书、Slack、Discord，开箱即用** ✅ |
| **🖥 使用方式** | CLI，需技术背景 ❌ | 视产品而定 | **纯 GUI，无需 CLI，双击即用** ✅ |

---

## 功能要点

### 🖱 双击安装

下载、双击、开始使用。无需环境变量、无需折腾依赖、无需长文档。nexu 的首次体验与能力一致——开箱即用。

### 🔗 内置 OpenClaw 🦞 Skills + 完整飞书 Skills

原生 OpenClaw 🦞 Skills 与完整飞书 Skills 一并提供。Agent 不再停留在演示，而是直接进入团队真实工作流，无需额外集成。

### 🧠 顶级模型，开箱即用

通过 nexu 账号直接使用 Gemini 等模型，无需额外配置。也可随时切换为自带 API Key。

### 🔐 OAuth 一键登录，免填 Key

支持 MiniMax、OpenAI Codex、GLM（Z.AI Coding Plan）OAuth 登录——点击授权即可使用，无需手动复制粘贴 API Key。

### 🔑 支持自带 API Key，无需登录

更倾向自己的模型服务？填入 API Key 即可使用，无需注册、无需登录。

### 📱 连接 IM，移动端即用

连接微信、飞书、Slack 或 Discord，你的 AI Agent 立刻出现在手机上。无需额外 App——打开微信或团队聊天工具，随时随地和 Agent 对话。

### 👥 为团队而生

核心开源，同时提供真正可用的桌面体验，兼容团队已有的工具与模型栈。

---

## 使用场景

nexu 面向 **One Person Company** 与小团队，让一个人就能拥有一支 AI 团队。

### 🛒 一人电商 / 跨境电商

> *"以前写 3 种语言的商品详情要花整个周末。现在我在飞书里把产品参数发给 Agent，一杯咖啡的功夫，亚马逊、Shopee、TikTok Shop 的 listing 就全好了。"*

选品调研、竞品比价、商品标题优化、多语言营销素材生成——从一周压缩到一个下午。

### ✍️ 知识博主 / 自媒体

> *"周一早上，我在 Slack 里问 Agent 这周有什么热点。午饭前，小红书、公众号、Twitter 的 5 篇初稿就出来了——每篇都是对应平台的调性。"*

热点追踪、选题生成、多平台内容批量产出、评论区互动——一个人运营矩阵账号。

### 💻 独立开发者

> *"凌晨 3 点排 Bug？我把报错堆栈贴到 Discord，Agent 定位到一个竞态条件，给出修复方案，连 PR 描述都帮我写好了。永不下线的结对编程。"*

代码审查、文档生成、Bug 分析、重复任务自动化——Agent 就是你的结对编程搭档。

### ⚖️ 法律 / 财税 / 咨询

> *"客户在飞书发来一份 40 页合同。我转发给 Agent——10 分钟后收到风险摘要、标记条款和修改建议。以前半天的活儿，现在一杯咖啡的时间。"*

合同审阅、法规检索、报表生成、客户问答——把专业知识变成 Agent 的技能。

### 🏪 门店 / 本地商家

> *"半夜客户发消息问'这个还有货吗？'我飞书里的 Agent 自动回复实时库存，处理退换，还顺手发了张优惠券。我终于能安心睡觉了。"*

库存管理、订单跟进、客户消息自动回复、营销文案生成——让 AI 帮你看店。

### 🎨 设计 / 创意

> *"我在 Slack 里丢了一句简单的 brief：'宠物食品品牌落地页，活泼风格。'Agent 回了文案方案、配色建议和参考图——全在启动会之前搞定。"*

需求拆解、素材检索、文案撰写、设计稿标注——释放创意时间，减少重复劳动。

---

## 🚀 快速开始

### 系统要求

- 🍎 **macOS**：macOS 12+（Apple Silicon & Intel）
- 🪟 **Windows**：Windows 10+
- 💾 **磁盘**：约 500 MB

### 安装

| 平台 | 下载 |
|------|------|
| 🍎 macOS（Apple Silicon） | [nexu.io](https://nexu.io) · [Releases](https://github.com/nexu-io/nexu/releases) |
| 🍎 macOS（Intel） | [nexu.io](https://nexu.io) · [Releases](https://github.com/nexu-io/nexu/releases) |
| 🪟 Windows | [nexu.io](https://nexu.io) · [Releases](https://github.com/nexu-io/nexu/releases) |

### 首次启动

使用 nexu 账号登录，立即使用已支持的模型；也可添加自带 API Key，无需账号即可使用 🔑。

---

## 🛠 开发

### 前置条件

- **Node.js** 22+（推荐 LTS）
- **pnpm** 10+

### 项目结构（节选）

```
nexu/
├── apps/
│   ├── web/              # Web 前端
│   ├── desktop/          # 桌面客户端（Electron）
│   └── controller/       # 控制器
├── packages/shared/      # 共享库
├── docs/                 # 文档
├── tests/
└── specs/
```

### 常用命令

```bash
pnpm dev start           # 启动完整本地开发栈（热重载）
pnpm dev stop            # 停止本地开发栈
pnpm build               # 生产构建
pnpm lint
pnpm test
```

---

## 🤝 贡献

欢迎贡献！详细指南在仓库根目录 [CONTRIBUTING.md](CONTRIBUTING.md)，也可访问 [docs.nexu.io — 参与贡献](https://docs.nexu.io/zh/guide/contributing)。

1. 🍴 Fork 本仓库
2. 🌿 创建功能分支（`git checkout -b feature/amazing-feature`）
3. 💾 提交改动（`git commit -m 'Add amazing feature'`）
4. 📤 推送到分支（`git push origin feature/amazing-feature`）
5. 🔀 提交 Pull Request

### 规范

- 遵循现有代码风格（Biome，可运行 `pnpm lint`）
- 为新功能编写测试
- 按需更新文档
- 保持提交原子化且描述清晰

---

## ❓ FAQ

**Q: nexu 免费吗？**
A: 客户端完全免费且开源（MIT）。内置多款顶级模型，也可以选择自带 API Key。

**Q: 支持哪些操作系统？**
A: 支持 macOS 12+（Apple Silicon & Intel）和 Windows 10+。

**Q: 支持哪些 IM 平台？**
A: 内置支持微信、飞书、Slack、Discord，开箱即用。

**Q: 我的数据安全吗？**
A: 所有数据保存在本机，nexu 不托管你的业务数据。源码开源可审计。

**Q: 可以使用自己的 API Key 吗？**
A: 可以。填入你的 API Key 即可使用，无需注册账号或登录。

**Q: 微信接入需要什么条件？**
A: 适配微信 8.0.7 OpenClaw 插件，点击连接、微信扫码即可，无需额外配置。

---

## 💬 社区

我们以 GitHub 作为社区交流的主要阵地。发帖前请先搜索，避免重复。

| 渠道 | 适用场景 |
|------|----------|
| 💡 [**Discussions**](https://github.com/nexu-io/nexu/discussions) | 提问、提想法、分享使用场景，或者打个招呼。**Q&A** 分类适合排查问题，**Ideas** 分类适合功能脑暴。 |
| 🐛 [**Issues**](https://github.com/nexu-io/nexu/issues) | 提交 Bug 或具体的功能需求。请使用 Issue 模板，方便我们快速分类处理。 |
| 📋 [**Roadmap & RFCs**](https://github.com/nexu-io/nexu/discussions/categories/rfc-roadmap) | 关注产品规划，参与重大设计方案的讨论。 |
| 📧 [**support@nexu.ai**](mailto:support@nexu.ai) | 私密咨询、商务合作，或不适合公开讨论的事项。 |

### 加入我们的社群

<table>
  <tr>
    <td align="center" width="220">
      <strong>💬 微信群</strong><br/><br/>
      <img src="site/media/wechat-qr.png" width="200" height="200" alt="微信社群二维码" /><br/>
      <sub>扫码加入微信社群</sub>
    </td>
    <td align="center" width="220">
      <strong><a href="https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=8b7k7b5b-ac27-4748-9165-78606dc16913">🪁 飞书群</a></strong><br/><br/>
      <img src="site/media/feishu-qr.png" width="200" height="200" alt="飞书社群二维码" /><br/>
      <sub>扫码或点击加入飞书社群</sub>
    </td>
    <td align="center" width="220">
      <strong><a href="https://discord.gg/Q6AxCUuMNU">🎮 Discord</a></strong><br/><br/>
      <img src="site/media/discord-qr.png" width="200" height="200" alt="Discord 社群二维码" /><br/>
      <sub>扫码或点击加入 Discord 服务器</sub>
    </td>
  </tr>
</table>

### Nexu 开源共创招募

Nexu 开源共创招募中，欢迎一起来写代码、拿积分、上榜单。想低门槛开始，可以先看 [Good First Issue 贡献者指南](https://docs.nexu.io/zh/guide/first-pr)。

我们长期维护 [Good First Issue 列表](https://github.com/nexu-io/nexu/labels/good-first-issue)，题目边界清晰、方向聚焦，还配有 AI Prompt 模板，方便你更快上手。首次贡献者和 `good-first-issue` 认领者，我们也会尽量提供引导与反馈。更多说明见 [贡献奖励与支持](https://docs.nexu.io/zh/guide/contributor-rewards)。

### Contributors

感谢每一位为 nexu 添砖加瓦的贡献者。无论是代码、文档、反馈还是创意建议，都会让这个项目变得更好。

特别感谢 [NickHood1984](https://github.com/NickHood1984) 已经向 nexu 提交并成功合入了 PR。这样的每一次真实贡献，都会被我们认真看到，也欢迎更多朋友一起加入。

<a href="https://github.com/nexu-io/nexu/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=nexu-io/nexu" />
</a>

---

## 📊 GitHub Stats

<picture>
  <img alt="GitHub Stats" src="docs/github-metrics.svg" />
</picture>

---

## ⭐ Star History

<a href="https://star-history.com/#nexu-io/nexu&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=nexu-io/nexu&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=nexu-io/nexu&type=Date" />
   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=nexu-io/nexu&type=Date" />
 </picture>
</a>

---

## 📄 许可证

nexu 基于 [MIT License](LICENSE) 开源——你可以自由使用、修改、分发，包括商业用途。

我们相信开源是 AI 基础设施的未来。欢迎 fork、贡献、或基于 nexu 构建你自己的产品。

---

<p align="center">
  <a href="https://github.com/nexu-io/nexu/stargazers">
    <img src="https://github.com/user-attachments/assets/a44df6d4-7056-4cd0-b778-32248a7fd26b" width="600" alt="Star nexu on GitHub" />
  </a>
</p>

---

<p align="center">Built with ❤️ by the nexu Team</p>
