Moltbot 新手入门指南
欢迎使用 Moltbot 入门指南！Moltbot 是一个强大的多平台 AI 代理工具，本教程将帮助你快速安装配置 Moltbot，完成第一次智能对话。
Moltbot 是什么？
Moltbot 是一个 AI 代理平台，通过单一的 Gateway 进程将多个聊天平台与 AI 连接起来。支持的平台包括：
- WhatsApp（通过 Baileys）
- Telegram（通过 grammY）
- Discord（通过 discord.js）
- iMessage（仅 macOS）
- Mattermost 及更多插件支持
把它想象成你的个人 AI 助手，它不仅能聊天，还能在所有消息应用中真正做事。
通过 Baileys
Telegram
通过 grammY
Discord
通过 discord.js
iMessage
仅 macOS
安装 Moltbot 的环境要求
开始之前，请确保你已具备：
Moltbot 快速开始
1
安装 CLI
最快的安装方式：
curl -fsSL https://molt.bot/install.sh | bash或通过 npm/pnpm 全局安装：
pnpm add -g moltbot
# 或
npm install -g moltbot2
运行配置向导
这是推荐的 Moltbot 配置方式。向导会引导你完成所有配置步骤。
moltbot onboard --install-daemon向导会帮你配置：
- 本地或远程 Gateway 连接
- 认证方式（OAuth 或 API 密钥）
- 消息平台（WhatsApp/Telegram/Discord/Mattermost）
- 后台守护服务
- Gateway 令牌
3
验证 Gateway
配置完成后，Gateway 服务会自动运行。验证是否正常：
moltbot gateway status访问本地控制台： http://127.0.0.1:18789/
4
连接消息渠道
选择你喜欢的消息平台：
WhatsApp（推荐）：
moltbot channels login用手机扫描二维码连接。
Telegram / Discord / Mattermost：通过配置向导设置，或参阅 渠道指南
5
处理私信安全
收到未知联系人的消息时，需要批准配对：
moltbot pairing approve <channel> <code>验证 Moltbot 安装
运行以下命令确保一切正常：
# 检查整体状态
moltbot status
# 健康检查
moltbot health
# 安全审计（上线前推荐）
moltbot security audit --deepMoltbot 重要配置路径
记住这些关键位置：
| 路径 | 用途 |
|---|---|
~/.clawdbot/moltbot.json | 你的个人配置文件 |
~/clawd/ | 工作空间：技能、提示词、记忆 |
http://127.0.0.1:18789/ | 本地 Gateway 控制台 |
Moltbot 安全检查清单
上线生产环境之前，请务必遵循以下安全实践：
- 永远不要给 AI 代理 生产环境的凭证
- 使用独立的 API 密钥 区分开发和生产环境
- 应用最小权限原则 - 只启用需要的技能
- 启用审计日志 记录所有代理操作
- 设置消费限额 在 AI 服务商账户上
在部署到生产环境前，请阅读完整的 安全检查清单
这是非官方指南
本网站是社区资源，与 Moltbot 官方团队无关。如需官方文档，请访问 docs.molt.bot