<div align="center">

<a href="https://moltis.org"><img src="https://raw.githubusercontent.com/moltis-org/moltis/main/website/favicon.svg" alt="Moltis" width="64"></a>

# Moltis — 一个用 Rust 编写的安全持久化个人智能体服务器

单一二进制文件——沙箱化、安全、属于你。

[![CI](https://github.com/moltis-org/moltis/actions/workflows/ci.yml/badge.svg)](https://github.com/moltis-org/moltis/actions/workflows/ci.yml)
[![codecov](https://codecov.io/gh/moltis-org/moltis/graph/badge.svg)](https://codecov.io/gh/moltis-org/moltis)
[![CodSpeed](https://img.shields.io/endpoint?url=https://codspeed.io/badge.json&style=flat&label=CodSpeed)](https://codspeed.io/moltis-org/moltis)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Rust](https://img.shields.io/badge/Rust-1.91+-orange.svg)](https://www.rust-lang.org)
[![Discord](https://img.shields.io/discord/1469505370169933837?color=5865F2&label=Discord&logo=discord&logoColor=white)](https://discord.gg/XnmrepsXp5)

[安装](#installation) • [对比](#comparison) • [架构](#architecture--crate-map) • [安全](#security) • [功能](#features) • [工作原理](#how-it-works) • [贡献](https://github.com/moltis-org/moltis/blob/main/CONTRIBUTING.md)

</div>

---

Moltis 最近登上了 [Hacker News 首页](https://news.ycombinator.com/item?id=46993587)。如果遇到任何问题，请[提交 issue](https://github.com/moltis-org/moltis/issues)。我正专注于让 Moltis 变得卓越。

**设计即安全** — 你的密钥永远不会离开你的机器。每条命令都在沙箱容器中运行，绝不在你的主机上运行。

**你的硬件** — 可运行在 Mac Mini、树莓派或你拥有的任何服务器上。单一 Rust 二进制文件，无需 Node.js，无需 npm，无需运行时。

**功能齐全** — 语音、记忆、跨会话回忆、自动编辑检查点、定时调度、Telegram、Signal、Discord、浏览器自动化、MCP 服务器、SSH 或基于节点的远程执行、在 Web UI 中带主机固定的托管部署密钥、实时的 设置 → 工具 清单、兼容 Cursor 的项目上下文，以及上下文文件威胁扫描——全部内置。没有可能遭受供应链攻击的插件市场。

**可审计** — 智能体运行器和模型接口约 7.5K 行，提供商部分另有约 19K 行。Rust 工作区约 270K 行，分布在 59 个可独立审计的模块化 crate 中，包含 470+ 个含测试的 Rust 文件。不安全代码被隔离在 FFI 和预编译运行时边界，而非核心智能体循环中。

## 安装

```bash
# One-liner install script (macOS / Linux)
curl -fsSL https://www.moltis.org/install.sh | sh

# macOS / Linux via Homebrew
brew install moltis-org/tap/moltis

# Docker (multi-arch: amd64/arm64)
docker pull ghcr.io/moltis-org/moltis:latest

# Or build from source
cargo install moltis --git https://github.com/moltis-org/moltis
```

## 对比

| | OpenClaw | Hermes Agent | **Moltis** |
|---|---|---|---|
| 主要技术栈 | TypeScript + Swift/Kotlin 配套应用 | Python + TypeScript TUI/Web 界面 | **Rust** |
| 运行时 | Node.js + npm/pnpm/bun | Python + uv/pip，可选 Node UI 组件 | **单一 Rust 二进制文件** |
| 本地检出大小\* | 约 110 万行应用代码 | 约 15.2 万行应用代码 | **约 27 万行 Rust 代码** |
| 架构 | 广泛的网关、通道、节点和应用生态 | 带学习循环和研究工具的 CLI/网关代理 | **模块化 crate 的持久化个人代理服务器** |
| Crate/模块 | npm 包、扩展、应用 | Python 包、插件、工具、TUI | **59 个 Rust 工作区 crate** |
| 沙箱/后端 | 应用级权限、浏览器/节点工具 | 本地、Docker、SSH、Daytona、Singularity、Modal | **Docker/Podman + Apple Container + WASM** |
| 认证/访问 | 配对和本地网关控制 | CLI 和消息网关设置 | **密码 + Passkey + API 密钥 + Vault** |
| 语音 I/O | 语音唤醒和通话模式 | 语音备忘录转录 | **内置 STT + TTS 提供商** |
| MCP | 插件/集成支持 | MCP 集成 | **stdio + HTTP/SSE** |
| 技能 | 内置、托管和工作区技能 | 自我改进技能和 Skills Hub 支持 | **内置/工作区技能 + 自主改进 + OpenClaw 导入** |
| 记忆/RAG | 插件支持的记忆和上下文引擎 | 代理策划的记忆、会话搜索、用户建模 | **SQLite + FTS + 向量记忆** |

\* 代码行数使用 `tokei` 测量，排除 `node_modules`、生成的构建输出、`dist` 和 `target`。

> [文档中的完整对比 →](https://docs.moltis.org/comparison.html)

## 架构 — Crate 映射

当前 Rust 工作区：59 个 crate，约 27 万行代码。下表按角色对主要 crate 进行分组，以便架构保持清晰可读。

**核心运行时**：

| Crate | 代码行数 | 角色 |
|-------|-----|------|
| `moltis-gateway` | 37.4K | HTTP/WS 服务器、RPC、认证、启动接线 |
| `moltis-tools` | 37.0K | 工具执行、沙箱、WASM 工具 |
| `moltis-providers` | 18.9K | LLM 提供商实现 |
| `moltis-agents` | 14.5K | 代理循环、流式传输、提示词组装 |
| `moltis-chat` | 14.2K | 聊天引擎、代理编排 |
| `moltis-config` | 10.3K | 配置、验证 |
| `moltis-httpd` | 9.9K | HTTP 服务器原语和中间件 |
| `moltis` (CLI) | 4.7K | 入口点、CLI 命令 |
| `moltis-sessions` | 3.5K | 会话持久化 |
| `moltis-common` | 1.5K | 共享工具 |
| `moltis-service-traits` | 1.2K | 共享服务接口 |
| `moltis-protocol` | 0.7K | 线路协议类型 |

**功能与集成 crate**：

| 类别 | Crate | 合计代码行数 |
|----------|--------|-------------|
| 通道 | `moltis-telegram`、`moltis-whatsapp`、`moltis-signal`、`moltis-discord`、`moltis-msteams`、`moltis-matrix`、`moltis-slack`、`moltis-nostr`、`moltis-channels` | 34.0K |
| Web 与 API | `moltis-web`、`moltis-graphql`、`moltis-webhooks` | 10.8K |
| 可扩展性 | `moltis-mcp`、`moltis-mcp-agent-bridge`、`moltis-skills`、`moltis-plugins` | 11.5K |
| 记忆与上下文 | `moltis-memory`、`moltis-qmd`、`moltis-code-index`、`moltis-projects` | 11.7K |
| 语音与浏览器 | `moltis-voice`、`moltis-browser` | 9.2K |
| 认证与安全 | `moltis-auth`、`moltis-oauth`、`moltis-vault`、`moltis-secret-store`、`moltis-network-filter`、`moltis-tls` | 8.5K |
| 调度与自动化 | `moltis-cron`、`moltis-caldav`、`moltis-auto-reply` | 4.7K |
| 设置与导入 | `moltis-provider-setup`、`moltis-openclaw-import`、`moltis-onboarding` | 11.7K |
| 原生与节点宿主 | `moltis-swift-bridge`、`moltis-node-host`、`moltis-courier` | 5.7K |
| WASM 工具 | `moltis-wasm-precompile`、`moltis-wasm-calc`、`moltis-wasm-web-fetch`、`moltis-wasm-web-search` | 1.4K |
| 支持性 crate | `moltis-media`、`moltis-metrics`、`moltis-tailscale`、`moltis-routing`、`moltis-canvas`、`moltis-schema-export`、`benchmarks` | 2.1K |

对于受限设备（Raspberry Pi 等），使用 `--no-default-features --features lightweight`。

## 安全

- **极小的不安全面** — 核心 agent/gateway 代码保持安全 Rust；不安全代码被隔离在 Swift FFI、本地模型封装和预编译 WASM 边界内
- **沙箱化执行** — Docker + Apple Container，按会话隔离
- **密钥处理** — `secrecy::Secret`，丢弃时清零，从工具输出中脱敏
- **身份验证** — 密码 + 通行密钥（WebAuthn），限速，按 IP 节流
- **SSRF 防护** — DNS 解析，阻止回环/私有/链路本地地址
- **来源验证** — 拒绝跨源 WebSocket 升级
- **钩子门控** — `BeforeToolCall` 钩子可检查/阻止任何工具调用
- **供应链完整性** — [制品证明](https://github.com/moltis-org/moltis/attestations)、Sigstore 无密钥签名、GPG 签名（YubiKey）、SHA-256/SHA-512 校验和

详情请参阅[安全架构](https://docs.moltis.org/security.html)。
使用 `gh attestation verify <artifact> -R moltis-org/moltis` 验证发布版本，或参阅[发布验证](https://docs.moltis.org/release-verification.html)。

## 功能特性

- **推理默认值** - 可为无模型会话和新建主会话配置默认思考强度，并支持按会话显式覆盖为关闭或指定级别
- **AI 网关** — 多提供商 LLM 支持（OpenAI Codex、GitHub Copilot、本地），流式响应，带子代理委派的代理循环，会话模式，并行工具执行
- **通信** — 带命令面板代理提示和 Markdown 复制/导出的 Web UI，Telegram、Signal、Microsoft Teams、Discord、Slack（含原生实时工具卡片），Nostr 私信 + NIP-29 群聊（含 Block 的 Buzz 频道），API 访问，语音 I/O（8 个 TTS + 7 个 STT 提供商），带推送通知的移动端 PWA
- **桌面应用** — 原生 Rust/gpui 客户端，可在本地、通过 HTTPS 或经 SSH 隧道连接到运行中的守护进程；密钥链存储的作用域 API 密钥，证书固定，流式原生 Markdown，带系统通知的审批
- **记忆与召回** — 按代理的记忆工作区，嵌入驱动的长期记忆，混合向量 + 全文搜索，带自动压缩的会话持久化，跨会话召回，兼容 Cursor 的项目上下文，上下文文件安全扫描
- **托管文件** - 设置中经身份验证的嵌套文件管理，带代理通告的主机路径，以及为 Docker、Podman 和 Apple Container 沙箱提供的独立默认只读挂载
- **更安全的代理编辑** — 在内置技能和记忆变更前自动创建检查点，恢复工具，会话分支
- **可扩展性** — MCP 服务器（stdio + HTTP/SSE），技能系统，15 个带熔断器的生命周期钩子事件，破坏性命令防护
- **代理客户端协议** — 驱动外部 ACP 代理（`codex-acp`、`claude-agent-acp`、Cursor），并通过 `moltis acp` 经 stdio 向 ACP 客户端提供 Moltis 服务
- **首次运行** — 在浏览器中打开引导流程并预填设置代码，提供免证书的 `http://localhost`，一次性提供信任名称约束的本地 CA 以用于局域网 HTTPS，并在终端日志下方固定显示 Web UI URL（通过 SSH 时附带 `ssh -L` 提示）
- **安全** — 静态加密保险库（XChaCha20-Poly1305 + Argon2id），密码 + 通行密钥 + API 密钥认证，沙箱隔离，SSRF/CSWSH 防护
- **运维** — Cron 调度，持久化本地 CalDAV，Gmail、Himalaya 邮件，以及可复用的 Slack/Discord/Matrix/Teams 消息数据集，提供商特定的只读代理工具，快速全文搜索，JSONL/Markdown 投影，代理可观测性（Langfuse 用于 LLM 追踪，OTLP 用于 Grafana/Datadog），Prometheus 指标，云部署（Fly.io、DigitalOcean），Tailscale 集成，托管 SSH 部署密钥，主机固定的远程目标，设置中的实时工具清单，以及 CLI/Web 远程执行诊断流程

## 工作原理

Moltis 是一个**本地优先的持久化代理服务器**——一个单一的 Rust 二进制文件，
位于你和多个 LLM 提供商之间，保持持久的会话状态，并能跨渠道与你交互，
而无需将你的数据交给云端中继。

```
┌─────────────┐  ┌─────────────┐  ┌─────────────┐
│   Web UI    │  │  Telegram   │  │  Discord    │
└──────┬──────┘  └──────┬──────┘  └──────┬──────┘
       │                │                │
       └────────┬───────┴────────┬───────┘
                │   WebSocket    │
                ▼                ▼
        ┌─────────────────────────────────┐
        │          Gateway Server         │
        │   (Axum · HTTP · WS · Auth)     │
        ├─────────────────────────────────┤
        │        Chat Service             │
        │  ┌───────────┐ ┌─────────────┐  │
        │  │   Agent   │ │    Tool     │  │
        │  │   Runner  │◄┤   Registry  │  │
        │  └─────┬─────┘ └─────────────┘  │
        │        │                        │
        │  ┌─────▼─────────────────────┐  │
        │  │    Provider Registry      │  │
        │  │  Multiple providers       │  │
        │  │  (Codex · Copilot · Local)│  │
        │  └───────────────────────────┘  │
        ├─────────────────────────────────┤
        │  Sessions  │ Memory  │  Hooks   │
        │  (JSONL)   │ (SQLite)│ (events) │
        └─────────────────────────────────┘
                       │
               ┌───────▼───────┐
               │    Sandbox    │
               │ Docker/Apple  │
               │  Container    │
               └───────────────┘
```

有关网关启动、消息流、会话和内存的详细信息，请参阅 [Quickstart](https://docs.moltis.org/quickstart.html)。

## 入门

### 构建与运行

需要 [just](https://github.com/casey/just)（命令运行器）和 Node.js（用于 Tailwind CSS）。

```bash
git clone https://github.com/moltis-org/moltis.git
cd moltis
just build-css                  # Build Tailwind CSS for the web UI
just build-release              # Build in release mode
cargo run --release --bin moltis
```

如需包含 WASM 沙箱工具的完整发布构建：

```bash
just build-release-with-wasm    # Builds WASM artifacts + release binary
cargo run --release --bin moltis
```

打开 `https://moltis.localhost:3000`。首次运行时，终端会打印一个设置码——在 Web UI 中输入该设置码以设置密码或注册通行密钥。

可选标志：`--config-dir /path/to/config --data-dir /path/to/data`

### Docker

```bash
# Docker / OrbStack
docker run -d \
  --name moltis \
  -p 13131:13131 \
  -p 13132:13132 \
  -p 1455:1455 \
  -v moltis-config:/home/moltis/.config/moltis \
  -v moltis-data:/home/moltis/.moltis \
  -v /var/run/docker.sock:/var/run/docker.sock \
  ghcr.io/moltis-org/moltis:latest
```

打开 `https://localhost:13131` 并完成设置。对于无人值守的 Docker 部署，请在首次启动前设置 `MOLTIS_PASSWORD`、`MOLTIS_PROVIDER` 和 `MOLTIS_API_KEY`，以跳过设置向导。有关 Podman、OrbStack、TLS 信任和持久化的详细信息，请参阅 [Docker 文档](https://docs.moltis.org/docker.html)。

### 云部署

| 提供商 | 部署 |
|----------|--------|
| DigitalOcean | [![Deploy to DO](https://www.deploytodo.com/do-btn-blue.svg)](https://cloud.digitalocean.com/apps/new?repo=https://github.com/moltis-org/moltis/tree/main) |

**Fly.io**（CLI）：

```bash
fly launch --image ghcr.io/moltis-org/moltis:latest
fly secrets set MOLTIS_PASSWORD="your-password"
```

所有云配置均使用 `--no-tls`，因为 TLS 终止由提供商处理。
详情请参阅[云部署文档](https://docs.moltis.org/cloud-deploy.html)。

## 许可证

MIT
下载工具
moltis

最受欢迎
