175 lines
4.5 KiB
Markdown
175 lines
4.5 KiB
Markdown
# 🦞 Moltbot — 个人 AI 助手
|
||
|
||
<p align="center">
|
||
<img src="https://raw.githubusercontent.com/moltbot/moltbot/main/docs/whatsapp-clawd.jpg" alt="Clawdbot" width="400">
|
||
</p>
|
||
|
||
<p align="center">
|
||
<strong>EXFOLIATE! EXFOLIATE!</strong>
|
||
</p>
|
||
|
||
**Moltbot** 是一个运行在你自己设备上的*个人 AI 助手*。
|
||
它可以在你常用的渠道上回复你（WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat），以及扩展渠道如 BlueBubbles、Matrix、Zalo 等。它可以在 macOS/iOS/Android 上语音交互，还可以渲染你控制的实时 Canvas。Gateway 只是控制平面——产品就是助手本身。
|
||
|
||
如果你想要一个感觉本地化、快速且始终在线的个人单用户助手，这就是它。
|
||
|
||
[官网](https://molt.bot) · [文档](https://docs.molt.bot) · [快速开始](https://docs.molt.bot/start/getting-started) · [更新指南](https://docs.molt.bot/install/updating) · [展示](https://docs.molt.bot/start/showcase) · [FAQ](https://docs.molt.bot/start/faq) · [向导](https://docs.molt.bot/start/wizard) · [Discord](https://discord.gg/clawd)
|
||
|
||
---
|
||
|
||
## 🚀 快速开始
|
||
|
||
**系统要求：** Node ≥22
|
||
|
||
### 安装（推荐）
|
||
|
||
```bash
|
||
npm install -g moltbot@latest
|
||
# 或: pnpm add -g moltbot@latest
|
||
|
||
moltbot onboard --install-daemon
|
||
```
|
||
|
||
向导会安装 Gateway 守护进程（launchd/systemd 用户服务），使其保持运行。
|
||
|
||
### 快速开始（TL;DR）
|
||
|
||
```bash
|
||
moltbot onboard --install-daemon
|
||
|
||
moltbot gateway --port 18789 --verbose
|
||
|
||
# 发送消息
|
||
moltbot message send --to +1234567890 --message "来自 Moltbot 的问候"
|
||
|
||
# 与助手对话
|
||
moltbot agent --message "今日待办清单" --thinking high
|
||
```
|
||
|
||
---
|
||
|
||
## 📦 从源码安装（开发）
|
||
|
||
推荐使用 `pnpm` 从源码构建。
|
||
|
||
```bash
|
||
git clone https://github.com/moltbot/moltbot.git
|
||
cd moltbot
|
||
|
||
pnpm install
|
||
pnpm ui:build # 首次运行会自动安装 UI 依赖
|
||
pnpm build
|
||
|
||
pnpm moltbot onboard --install-daemon
|
||
|
||
# 开发循环（TS 变更自动重载）
|
||
pnpm gateway:watch
|
||
```
|
||
|
||
---
|
||
|
||
## 🔑 模型支持
|
||
|
||
**推荐订阅（OAuth）：**
|
||
- **[Anthropic](https://www.anthropic.com/)** (Claude Pro/Max) — 推荐
|
||
- **[OpenAI](https://openai.com/)** (ChatGPT/Codex)
|
||
|
||
模型说明：虽然支持任何模型，但强烈推荐 **Anthropic Pro/Max + Opus 4.5**，具有更强的长上下文能力和更好的提示注入抵抗力。
|
||
|
||
---
|
||
|
||
## 📱 支持的渠道
|
||
|
||
### 核心渠道
|
||
| 渠道 | 说明 |
|
||
|------|------|
|
||
| WhatsApp | 通过 Baileys 支持 |
|
||
| Telegram | 通过 grammY 支持 |
|
||
| Slack | 通过 Bolt 支持 |
|
||
| Discord | 通过 discord.js 支持 |
|
||
| Google Chat | 通过 Chat API 支持 |
|
||
| Signal | 通过 signal-cli 支持 |
|
||
| iMessage | 通过 imsg 支持（仅 macOS） |
|
||
| WebChat | 内置 web 界面 |
|
||
|
||
### 扩展渠道
|
||
BlueBubbles、Microsoft Teams、Matrix、Zalo、Mattermost、Nextcloud Talk 等
|
||
|
||
---
|
||
|
||
## ⚙️ 配置
|
||
|
||
配置文件位置：`~/.clawdbot/moltbot.json`
|
||
|
||
**最小配置：**
|
||
```json5
|
||
{
|
||
agent: {
|
||
model: "anthropic/claude-opus-4-5"
|
||
}
|
||
}
|
||
```
|
||
|
||
**带渠道配置：**
|
||
```json5
|
||
{
|
||
channels: {
|
||
telegram: {
|
||
botToken: "YOUR_BOT_TOKEN",
|
||
allowFrom: ["YOUR_USER_ID"]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
详细配置请参考：[配置参考](https://docs.molt.bot/gateway/configuration)
|
||
|
||
---
|
||
|
||
## 💬 聊天命令
|
||
|
||
在 WhatsApp/Telegram/Slack 等渠道发送：
|
||
|
||
| 命令 | 说明 |
|
||
|------|------|
|
||
| `/status` | 查看会话状态（模型 + tokens） |
|
||
| `/new` 或 `/reset` | 重置会话 |
|
||
| `/compact` | 压缩会话上下文 |
|
||
| `/think <级别>` | off\|minimal\|low\|medium\|high\|xhigh |
|
||
| `/verbose on\|off` | 详细模式 |
|
||
| `/usage off\|tokens\|full` | 每次响应的用量页脚 |
|
||
|
||
---
|
||
|
||
## 🔒 安全模型
|
||
|
||
- **默认：** 工具在宿主机上为 **main** 会话运行，所以当只有你使用时，助手有完全访问权限。
|
||
- **群组/渠道安全：** 设置 `agents.defaults.sandbox.mode: "non-main"` 可以在 Docker 沙箱中运行非 main 会话。
|
||
|
||
详情：[安全指南](https://docs.molt.bot/gateway/security)
|
||
|
||
---
|
||
|
||
## 📚 文档链接
|
||
|
||
- [入门指南](https://docs.molt.bot/start/getting-started)
|
||
- [配置参考](https://docs.molt.bot/gateway/configuration)
|
||
- [架构概述](https://docs.molt.bot/concepts/architecture)
|
||
- [渠道文档](https://docs.molt.bot/channels)
|
||
- [工具文档](https://docs.molt.bot/tools)
|
||
- [故障排除](https://docs.molt.bot/channels/troubleshooting)
|
||
|
||
---
|
||
|
||
## 🤝 贡献
|
||
|
||
欢迎贡献！参见 [CONTRIBUTING.md](CONTRIBUTING.md) 了解指南。
|
||
|
||
AI 辅助的 PR 也欢迎！🤖 只需在 PR 中标注即可。
|
||
|
||
---
|
||
|
||
## 📜 许可证
|
||
|
||
[MIT License](LICENSE)
|