经 AI Skill Hub 精选评估,CrustAI本地助手 获评「推荐使用」。这款Agent工作流在功能完整性、社区活跃度和易用性方面表现出色,AI 评分 7.0 分,适合有一定技术背景的用户使用。
CrustAI本地助手 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排,将复杂的多步骤任务拆解为清晰的自动化流程,实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成,适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
CrustAI本地助手 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排,将复杂的多步骤任务拆解为清晰的自动化流程,实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成,适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
# 方式一:npm 全局安装 npm install -g crustai # 方式二:npx 直接运行(无需安装) npx crustai --help # 方式三:项目依赖安装 npm install crustai # 方式四:从源码运行 git clone https://github.com/DaveSimoes/CrustAI cd CrustAI npm install npm start
# 命令行使用
crustai --help
# 基本用法
crustai [options] <input>
# Node.js 代码中使用
const crustai = require('crustai');
const result = await crustai.run(options);
console.log(result);
# crustai 配置说明 # 查看配置选项 crustai --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量(覆盖配置文件) export CRUSTAI_CONFIG="/path/to/config.yml"
| 🔒 **100% Private** | Every message stays on your device. No telemetry, no external APIs, no logs |
| 🧠 **Powered by Ollama** | Use llama3.2, mistral, phi3, tinyllama and any model you choose |
| 📱 **4 Platforms, 1 Bot** | Connect to Telegram, Discord, WhatsApp, and Slack simultaneously |
| 🧬 **Long-Term Memory** | Your assistant remembers facts about you across sessions |
| 🗣️ **Voice Support** | Speak and listen — fully offline voice mode (pt-BR) |
| ⚡ **REST API** | Integrate CrustAI into your own tools and workflows |
| 🎭 **Personality Config** | Give your assistant a custom name, tone, and identity |
| 🐳 **Docker Ready** | One-command deployment for servers and home labs |
| 🌐 **Bilingual** | Full English + Portuguese support out of the box |
---
npm install
```bash
cp config/config.example.yml config/config.yml
Edit config/config.yml:
model: tinyllama # or llama3.2, phi3, mistral...
ollama_url: http://localhost:11434
language: en # or pt-BR
telegram:
enabled: true
token: YOUR_BOT_TOKEN_HERE
allowed_user_ids: [] # leave empty to allow all users
discord:
enabled: false
token: ""
whatsapp:
enabled: false
slack:
enabled: false
voice:
enabled: false
port: 8765
---
cp config/config.example.yml config/config.yml
| Model | Size | Best For |
|---|---|---|
tinyllama | ~600MB | Low-end machines, quick replies |
phi3 | ~2GB | Balanced performance |
llama3.2 | ~2GB | General purpose, highly capable |
mistral | ~4GB | Strong reasoning and coding |
llama3 | ~4GB | High quality conversations |
Any model available on ollama.ai can be used.
---
"Connection refused" on Ollama — Make sure Ollama is running: ollama serve
Bot not responding on Telegram — Double-check your token in config/config.yml and that the bot was started with /start.
High memory usage — Switch to a lighter model like tinyllama. Edit model: in config/config.yml.
WhatsApp keeps disconnecting — WhatsApp Web sessions expire. Restart CrustAI to regenerate the QR code.
---
CrustAI 是一款专注于隐私保护的个人 AI 助手项目。它旨在为用户提供一个完全本地化、私密且强大的对话体验,确保所有聊天信息都留在您的本地设备上,无需担心数据泄露或外部 API 的隐私风险。
CrustAI 具备以下核心特性:100% 隐私保护,不进行任何远程遥测或日志记录;深度集成 Ollama,支持 llama3.2、mistral、phi3 等多种开源模型;多平台支持,可同时连接 Telegram、Discord、WhatsApp 和 Slack;并具备长期记忆功能,能够跨会话记住您的个人信息,打造个性化助手。
在开始之前,请确保您的开发环境已满足以下要求:已安装 Node.js(版本需 ≥ 20.0);本地已安装并正在运行 Ollama 服务;此外,您需要准备好相应平台的 Token(例如通过 Telegram 的 @BotFather 获取的 Bot Token)以实现平台接入。
您可以通过源码方式快速部署 CrustAI。首先,请确保已安装 Node.js 环境,然后在项目根目录下运行 `npm install` 命令来安装所有必要的依赖项。如果您希望使用 Docker 进行容器化部署,请参考项目提供的 Dockerfile 进行构建与运行。
项目安装完成后,请进入配置阶段。首先需要将 `config/config.example.yml` 复制并重命名为 `config/config.yml`。随后,根据您的需求在配置文件中填入对应的平台 Token,即可启动您的私密 AI 助手。
您可以通过编辑 `config/config.yml` 文件来高度自定义助手行为。您可以指定使用的 Ollama 模型(如 tinyllama 或 llama3.2)、设置语言、配置 Ollama 的访问 URL,以及开启或关闭 Telegram、Discord、WhatsApp 和 Slack 等平台的接入开关,并设置允许访问的用户 ID 列表。
CrustAI 通过 Ollama 驱动,支持多种规模的模型。您可以根据硬件配置选择合适的模型:`tinyllama` 适合低配设备及快速回复;`phi3` 和 `llama3.2` 提供平衡的性能;而 `mistral` 和 `llama3` 则在逻辑推理、编程能力及高质量对话方面表现更强。
针对常见问题,若遇到 Ollama 提示 "Connection refused",请确保已执行 `ollama serve` 启动服务;若 Telegram Bot 无响应,请检查配置文件中的 Token 是否正确以及是否已发送 `/start` 指令;若遇到内存占用过高的情况,建议在配置文件中将 model 切换为更轻量级的 `tinyllama`。
私有AI���手解决方案具创新性,多平台支持覆盖广。但项目成熟度偏低,需社区验证,适合早期使用者。
AI Skill Hub 为第三方内容聚合平台,本页面信息基于公开数据整理,不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后,再部署至生产环境,并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一,可自由商用、修改、分发,仅需保留版权声明。
AI Skill Hub 点评:CrustAI本地助手 的核心功能完整,质量良好。对于自动化工程师和运维人员来说,这是一个值得纳入个人工具库的选择。建议先在非生产环境试用,再逐步推广。
| 原始名称 | CrustAI |
| 原始描述 | 开源AI工作流:Private, local-first AI assistant with Telegram, Discord, WhatsApp and Slack。⭐10 · JavaScript |
| Topics | AI助手多平台集成本地部署隐私优先开源自动化 |
| GitHub | https://github.com/DaveSimoes/CrustAI |
| License | MIT |
| 语言 | JavaScript |
收录时间:2026-05-22 · 更新时间:2026-05-30 · License:MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。
选择 Agent 类型,复制安装指令后粘贴到对应客户端