墨子先生
v2.0.0 — 专注国产生态

Mozi 墨子

支持国产大模型和国产通讯软件的轻量级 AI 助手框架。
Durable Execution 保证进程崩溃后回合可恢复,约 2 万行代码,简洁高效,易于二次开发。

$ npm install -g mozi-bot click to copy
~20K
Lines of Code
16
Model Providers
5
Chat Platforms
20
Built-in Tools

为国产生态而生的 AI Agent

统一接口对接多种国产 AI 模型,原生支持国产通讯平台,开箱即用

🤖

多模型支持

DeepSeek、Qwen、智谱AI、Kimi、阶跃星辰、MiniMax、ModelScope,以及 OpenAI/Anthropic 兼容格式。统一接口,自由切换。

💬

多平台通道

QQ、飞书、钉钉、企业微信原生支持。长连接模式无需公网 IP,启动即可接收消息。

🔧

Function Calling

原生支持 OpenAI tools/tool_choice 参数,20 个内置工具涵盖文件操作、Bash 执行、网页抓取、浏览器自动化、记忆等。

🧠

记忆系统

跨会话长期记忆,自动记住用户偏好和重要信息。无需手动触发,Agent 智能判断存储时机。

⏰

定时任务 (Cron)

支持一次性、周期性、Cron 表达式三种调度方式,可执行 Agent 回合并主动投递到指定通道。

🛟

Durable Execution

回合、step、工具调用意图全部写入追加日志。进程崩溃后重启自动把未完成的工具调用标记为中断,不会留下悬空调用。

🎯

Skills 技能系统

通过 SKILL.md 文件扩展 Agent 能力。支持自定义行为、专业知识注入,无需修改代码。

🌐

浏览器自动化

基于 Playwright 的浏览器控制:导航、元素快照与引用、点击、输入、滚动、截图、执行 JS,可用于端到端调试。

⚡

轻量高效

约 2 万行 TypeScript 实现完整 Agent 核心功能。代码结构清晰,适合学习 Agent 架构设计和二次开发。

支持 16 个模型提供商

国产模型优先,兼容 OpenAI/Anthropic 格式,支持本地部署与自定义端点

国产模型
DeepSeek
DashScope (Qwen)
智谱 AI (GLM)
Kimi / Moonshot
阶跃星辰
MiniMax
ModelScope
海外 & 本地
OpenAI
OpenRouter
Together AI
Groq
Ollama (Local)
vLLM / Azure
Custom OpenAI / Anthropic

全平台通讯接入

长连接模式无需公网 IP,无需回调地址,启动即用;WebChat 与终端 TUI 开箱即用

📨

飞书

WebSocket 长连接

企业自建应用,支持私聊与群聊

📩

钉钉

Stream 长连接

机器人类型应用,内网即可部署

💬

QQ

WebSocket 长连接

官方机器人 API,支持私聊、群聊、频道

💼

企业微信

HTTP 回调

自建应用,需公网可访问地址,签名与 AES 解密校验

🖥️

WebChat

WebSocket

内置聊天界面 + 控制台,支持流式输出与会话管理

⌨️

终端 TUI

本地终端

直接运行 mozi 进入,支持历史、中断与新会话

四条命令启动

从安装到对话,WebChat / 通讯平台 / 终端 TUI 三种入口任选

terminal
# 1. Install globally
$ npm install -g mozi-bot

# 2. Configure (interactive wizard)
$ mozi onboard

# 3. 先确认配置能通过
$ mozi check

# 4. 启动

# 仅 WebChat(无需配置 QQ/飞书/钉钉)
$ mozi web --web-only

# 完整服务(WebChat + 飞书 + 钉钉 + QQ + 企微)
$ mozi start

# 或者直接在终端里聊
$ mozi

# 聊天界面 http://localhost:3000 · 控制台 http://localhost:3000/control
terminal
# 1. Clone & build
$ git clone https://github.com/King-Chau/mozi.git
$ cd mozi && npm install && npm run build

# 2. Configure
$ npx mozi onboard

# 3. Start

# 仅 WebChat
$ node dist/cli/index.js web --web-only

# 完整服务
$ node dist/cli/index.js start

# 本地打包后离线安装验证
$ npm pack && npm install -g ./mozi-bot-2.0.0.tgz

# 聊天界面 http://localhost:3000 · 控制台 http://localhost:3000/control

20 个内置工具

原生 Function Calling,涵盖文件操作、命令执行、网页抓取、浏览器自动化与长期记忆

📄

read_file

读取文件内容

✏️

write_file

写入/创建文件

🔧

edit_file

精确字符串替换

🔍

glob / grep

文件与内容搜索

💻

bash

执行 Bash 命令

🌐

web_search

网络搜索

📦

web_fetch

获取网页内容

📸

browser

浏览器自动化

🖼️

image_analyze

图像分析

🕑

current_time

获取当前时间

🧠

memory_*

长期记忆系统

⏰

cron_*

定时任务管理(按需启用)

📁

list_directory

列出目录内容

🧩

apply_patch

应用 diff 补丁

⚙️

process

管理后台进程

🧮

calculator

数学计算

⏳

delay

延时等待

轻量但完整

3% 的代码量,100% 的核心能力

Feature Mozi Moltbot
定位 国产生态优先 全功能个人 AI 助手
代码量 ~19,600 行 / 96 文件 ~516,000 行
崩溃恢复 Durable Execution(追加日志) 会话持久化
模型提供商 16 个(含自定义端点) 数十个
国产通讯 QQ / 飞书 / 钉钉 / 企微 WhatsApp / Telegram / Slack
Node.js >= 18 >= 22
适用场景 企业内部 / 国内团队 个人多设备 / 海外平台

清晰的分层架构

输入层 → 网关层 → Agent 核心 → 模型 & 工具

Input Layer — 通讯平台
飞书 (WebSocket) 钉钉 (Stream) QQ (WebSocket) 企微 (HTTP) WebChat 终端 TUI
↓
Gateway — HTTP / WebSocket 路由
Gateway Server
↓
Core — Agent 引擎
消息循环 上下文压缩 会话管理 Skills 技能 记忆系统 定时任务 Durable 执行
↓
Providers — AI 模型
DeepSeek Qwen 智谱AI Kimi OpenAI Anthropic
↓
Tools — 20 个内置工具
文件操作 Bash 执行 网络请求 浏览器自动化 记忆系统 定时任务 图像分析

开始使用 Mozi

三步启动你的国产 AI 助手,支持企业内部部署与团队协作

View on GitHub npm · mozi-bot