moltis 详细指南

版本 20260827.01~20260827.01 ｜分类 runtime ｜安全（已审查）｜素材：项目官方文档（英文 README）+ 本市场实测（2026-08-28）
配套：站内文档（manifest + guide + 证据）｜快速版：站内文档

1. 场景：什么时候会用它

Moltis（moltis-org 出品，MIT，约 2.8 千星）是安全的持久个人 agent 服务器：Rust 单二进制，沙箱化执行、多 provider LLM、语音、记忆、Telegram/WhatsApp/Discord/Teams 通道。它把 agent 从"终端里的临时会话"变成"常驻的个人服务"。

一句话：给你的 Agent 一个"家"——常驻、有记忆、可远程聊天。

这个工具解决什么问题：你要一个常驻的个人 Agent 服务器——安全、持久，对外提供服务（gateway）。Moltis 是 Rust 单二进制：gateway（默认子命令，端口 + 常驻）+ acp/agent/channels/sessions/config/models/providers/onboard/doctor/auth/skills/hooks/sandbox 全命令面。

什么时候用：

你要跑一个常驻网关给 Agent 服务（Telegram/WhatsApp 等通道）；
你要安全持久化的个人 Agent 服务器（密钥检查、沙箱）；
你要用 onboard 向导配 provider/通道/沙箱。

什么时候别用：临时会话、不需要常驻服务时——它是服务器形态（gateway 起进程绑端口）。

注意事项：重档服务器条目——gateway 会常驻并绑定端口；国内直连 GitHub release 资产实测 3KB/s 超时，必须 gh-proxy 前缀。

2. 能力清单

能力	作用
gateway	常驻 agent 服务器（默认子命令）
memory/sessions	持久记忆与会话
channels	Telegram/WhatsApp/Discord/Teams 接入
sandbox	沙箱化执行（Docker）
node	远程节点管理
沙箱化执行	见 Agent 执行版 guide
多 provider LLM	见 Agent 执行版 guide
记忆/会话持久化	见 Agent 执行版 guide
消息通道（Telegram/WhatsApp 等）	见 Agent 执行版 guide
onboard/doctor 配置向导	见 Agent 执行版 guide

3. 快速安装

note: release 二进制（本环境实测）；国内必须 gh-proxy 加速（命令已内置）

# 来源: Trove 详细指南 · 验证于 2026-08-28
curl -sL -o /tmp/moltis.tar.gz 'https://gh-proxy.com/https://github.com/moltis-org/moltis/releases/download/20260827.01/moltis-20260827.01-x86_64-unknown-linux-gnu.tar.gz'
tar xzf /tmp/moltis.tar.gz -C /usr/local/bin moltis
moltis --version

预期输出: moltis 20260827.01

第 1 步：确认版本与配置体检

讲解：moltis --version 确认安装；moltis doctor 把配置与安全项跑一遍——全项通过（或只有可手动修的 warn）说明环境就绪。

# 来源: Trove 详细指南 · 验证于 2026-08-28
moltis --version
moltis doctor

预期输出: 20260827.01；配置/安全检查项（TOML 有效、无 API key 泄露；数据目录权限 warn 可手动 chmod 700）

卡住怎么办：

doctor 有 FAIL 项 → 按提示修正（权限/配置）；
版本对不上 → 重新下载并确认文件完整。

第 2 步：确认 gateway 能起（可选，常驻服务）

讲解：moltis gateway 启动日志无错误、服务端口可访问，说明对外服务链路通；不需要常驻时 Ctrl+C 停止。

# 来源: Trove 详细指南 · 验证于 2026-08-28
moltis gateway

预期输出: 网关启动日志（Ctrl+C 停止；生产用 systemd 托管）

卡住怎么办：

端口被占 → 看配置里的端口设置（~/.config/moltis/）；
启动失败 → 先 doctor 检查配置。

安装变体

路径	命令	实测
主路径（实测）	`curl -sL -o /tmp/moltis.tar.gz 'https://gh-proxy.com/https://github.com/moltis-o…`	✅ 本市场实测
镜像/代理	见快速版与 semi_auto_note；国内安装按 moltis 指引	实测

半自动说明：实测命令 = release 二进制（2026-08-28 本环境验证，20260827.01）；国内直连 GitHub release 资产实测 3KB/s 超时——安装必须走 gh-proxy 类公共加速（本条命令已内置）或镜像；其他平台选对应资产（AppImage/dmg/exe/deb）；首次运行自动生成 ~/.config/moltis/；gateway 为默认子命令（端口 + 常驻进程），doctor 检查配置；完整服务需 onboard 配置 provider

非 Linux x86_64：官方提供 AppImage/dmg/exe/deb/rpm 等资产（本机未实测，命令面一致）。
后台进程：gateway 常驻并绑定端口；生产建议 systemd 托管，开发用 Ctrl+C 停止即可。
写面：~/.config/moltis/（配置）+ ~/.local/share/moltis（数据），均为专属目录，无共享注册面，共装判定全部 possible-compatible。

4. 为什么会这样（机制与共享面）

它怎么工作：Rust 单二进制（release tarball 解压到 /usr/local/bin）。首次运行自动生成 ~/.config/moltis/；doctor 配置/安全检查；onboard 交互式配置 provider/通道/沙箱；gateway 启动常驻网关（Ctrl+C 停止，生产用 systemd 托管）。

关键概念：

gateway：默认子命令 = 常驻网关服务器（端口绑定，对外提供 agent 服务）；
onboard：首次配置向导（provider/通道/沙箱，人工介入）；
doctor：配置/安全检查（TOML 有效、无 API key 泄露）。

装完它动哪里：~/.config/moltis/（配置，首次运行自动生成）+ 数据目录 ~/.local/share/moltis（记忆/会话/通道数据）。

~/.config/moltis/：moltis.toml + defaults.toml（实测生成）
数据目录：~/.local/share/moltis 或安装目录 share/moltis/
运行时：gateway 端口绑定 + 常驻进程；sandbox 用 Docker（可选）

5. 常用操作

第 1 步：装二进制（为什么 gh-proxy：国内直连实测 3KB/s 超时）

讲解：国内直连 GitHub release 资产实测 3KB/s 超时（2026-08-28）——必须走 gh-proxy 前缀（实测 68M/16s）。tarball 解压出 moltis 到 /usr/local/bin。其他平台选对应资产（AppImage/dmg/exe/deb/rpm）。

# 来源: Trove 详细指南 · 验证于 2026-08-28
curl -sL -o /tmp/moltis.tar.gz 'https://gh-proxy.com/https://github.com/moltis-org/moltis/releases/download/20260827.01/moltis-20260827.01-x86_64-unknown-linux-gnu.tar.gz'
tar xzf /tmp/moltis.tar.gz -C /usr/local/bin moltis
moltis --version

预期输出: moltis 20260827.01

装好确认：

--version 输出 20260827.01；
/usr/local/bin 可写（前置检查 precheck: OK）。

卡住怎么办：

下载慢/超时 → 确认网络能到 gh-proxy；备选 npm/cargo 镜像构建（官方路径，未实测）；
tar 解压报错 → 重新下载，确认文件完整。

第 2 步：doctor 检查 + onboard 配置

讲解：doctor 全项配置/安全检查（TOML 有效、无 API key 泄露；数据目录权限 warn 可手动 chmod 700）；onboard 交互式向导配置 provider/通道/沙箱（人工介入）。

# 来源: Trove 详细指南 · 验证于 2026-08-28
moltis doctor

预期输出: 配置/安全检查项（TOML 有效、无 API key 泄露；数据目录权限 warn 可手动 chmod 700）

# 来源: Trove 详细指南 · 验证于 2026-08-28
moltis onboard

预期输出: 交互式配置（provider/通道/沙箱；人工介入）

装好确认：

doctor 全项通过（或只有可手动修的 warn）；
onboard 完成后配置就位。

卡住怎么办：

doctor 有 FAIL 项 → 按提示修正（权限/配置）；
onboard 中途退出 → 可重跑，配置是增量的。

第 3 步：启动 gateway（常驻）

讲解：gateway 是默认子命令，启动常驻网关（端口绑定，对外提供 agent 服务）。Ctrl+C 停止；生产建议 systemd 托管。

# 来源: Trove 详细指南 · 验证于 2026-08-28
moltis gateway

预期输出: 网关启动日志（Ctrl+C 停止；生产用 systemd 托管）

装好确认：

启动日志无错误；
服务端口可访问。

卡住怎么办：

端口被占 → 看配置里的端口设置（~/.config/moltis/）；
启动失败 → 先 doctor 检查配置。

启动与入口

网关：moltis gateway（常驻）；生产用 systemd 托管；
命令面：moltis --help（gateway/acp/agent/channels/sessions/config/models/providers/onboard/doctor/auth/skills/hooks/sandbox）。

常用操作

操作一：查看命令清单

# 来源: Trove 详细指南 · 验证于 2026-08-28
moltis --help

预期输出: gateway/acp/agent/channels/sessions/config/models/providers/onboard/doctor/auth/skills/hooks/sandbox 等命令

操作二：配置检查（本环境实测，全项通过）

# 来源: Trove 详细指南 · 验证于 2026-08-28
moltis doctor

预期输出: 配置/安全检查项（TOML 有效、无 API key 泄露；数据目录权限 warn 可手动 chmod 700）

操作三：配置向导（首次使用）

# 来源: Trove 详细指南 · 验证于 2026-08-28
moltis onboard

预期输出: 交互式配置（provider/通道/沙箱；人工介入）

操作四：启动网关（默认子命令，常驻进程 + 端口）

# 来源: Trove 详细指南 · 验证于 2026-08-28
moltis gateway

预期输出: 网关启动日志（Ctrl+C 停止；生产用 systemd 托管）

数据与目录

配置：~/.config/moltis/（首次运行自动生成）；
数据：~/.local/share/moltis 或安装目录 share/moltis/（记忆/会话/通道数据）。

6. 冲突逐条（摘要）

与工具页矩阵同源，共 19 对（2 实测兼容 / 17 推断可能兼容 / 0 推断可能冲突）；完整对子、状态与证据见冲突对子（共装矩阵）。

7. 排障速查

暂无独立排障手册；安装/卸载问题先看 Agent 执行版 guide 注意事项

8. 卸载与残留检查

# 来源: Trove 详细指南 · 验证于 2026-08-28
rm -f /usr/local/bin/moltis; rm -rf ~/.config/moltis

note: 二进制删除 + 专属配置自动删；数据目录与沙箱镜像手动确认

# 来源: Trove 详细指南 · 验证于 2026-08-28
rm -f /usr/local/bin/moltis
rm -rf ~/.config/moltis
command -v moltis >/dev/null 2>&1 && echo "残留: moltis 仍存在" || echo "moltis removed: OK"

预期输出: moltis removed: OK

手动确认清单（用户数据，不自动删）：

数据目录：~/.local/share/moltis 或安装目录 share/moltis/（记忆/会话/通道数据）
Docker 沙箱镜像：docker images 中 moltis 相关镜像
通道 Bot（Telegram/WhatsApp）：随配置删除 token 失效，服务端侧 Bot 可保留

9. FAQ

运行环境预检（Linux x86_64；确认 /usr/local/bin 可写）
release 二进制（本环境实测）；国内直连 GitHub 资产实测 3KB/s 超时——必须走 gh-proxy 加速（命令已内置）
其他平台选对应资产（AppImage/dmg/exe/deb/rpm）；首次运行自动生成 ~/.config/moltis/；完整服务需 onboard 配置 provider
每条操作 = 一个命令块 + 预期输出
国内安装必须加速：GitHub release 资产直连实测 3KB/s 超时；用安装段 gh-proxy 前缀（实测 16s 完成）

问：下载很慢/装不上？答：国内直连 GitHub release 资产实测 3KB/s 超时——必须用安装段的 gh-proxy 前缀（实测 68M/16s）；也可用 npm/cargo 镜像构建（备选）。
问：装完怎么开始用？答：moltis doctor 检查配置 → moltis onboard 向导配置 provider → moltis gateway 启动。
问：gateway 是干嘛的？答：默认子命令 = 常驻网关服务器（端口绑定），对外提供 agent 服务；不用时 Ctrl+C 或 systemd 管理。
问：和别的插件冲突吗？答：判定全部 possible-compatible——moltis 只写 ~/.config/moltis/（专属）+ 数据目录，无共享注册面。
问：使用问题向谁反馈？答：本市场安装/卸载问题走条目反馈入口（usage-report 模板）；项目自身问题请向作者仓库反馈。

版本：[20260827.01, 20260827.01] 锁定（收录实测版本）。
环境：Linux x86_64；/usr/local/bin 可写；其他平台走对应资产（AppImage/dmg/exe/deb/rpm）。
网络：GitHub 直连 3KB/s 超时（实测），必须 gh-proxy（实测 68M/16s）。
写面：~/.config/moltis/（专属）+ 数据目录（~/.local/share/moltis）。
后台进程：gateway 常驻（端口绑定）；生产用 systemd。
共装：判定全部 possible-compatible——moltis 只写 ~/.config/moltis/（专属）+ 数据目录，无共享注册面。

10. 出处

条目签名：moltis-org/moltis（MIT，原样收录 20260827.01）

实测：实测记录（本地留存）（2026-08-28，gh-proxy 下载 + 安装 + version/help/doctor 冒烟）。
未实测：onboard 完整向导与 gateway 常驻运行（需人工配置 provider）；Docker 沙箱（需镜像环境）。

外部教学（来源未实测）

第三方教学未逐条实测，仅供学习；有出入以本页与官方文档为准。

官方 README（codeload tarball 20260830.01，2026-08-31 结构实测）：Moltis 完整用法 [官方文档 · Moltis 官方 · 2026-08-31（tag 20260830.01）]
官方用法全解——单二进制安装（release tarball 解压）、gateway 常驻网关（默认子命令，端口绑定）、acp/agent/channels/sessions/config/models/providers/onboard/doctor/auth/skills/hooks/sandbox 命令面、配置与数据目录、Telegram/WhatsApp 等通道接入

收录来源（已合并）

本页内容由多篇来源文章按哈希去重、实测验证、AI 重写后合并而来——来源不散落，全部挂在这一个页面上。

暂无已合并来源：本页为本地实测与多来源重写的沉淀；来源与验证细节见站内对应方案页。

← 返回 moltis 方案页｜多智能体编排问题域