Moltbot 快速入门 - 完整设置指南

Moltbot 是一个自托管的 AI 网关，它连接你喜爱的消息平台到强大的 AI 模型。在本指南中，我们将通过安装和初始配置过程。

你需要什么

在开始之前，请确保你有：

1. Node.js 22 或更高版本 - 用 node -v 检查你的版本
2. npm 或 pnpm - 用于管理依赖的包管理器
3. API 密钥 - 来自 AI 提供商（Anthropic Claude、OpenAI 等）
4. 消息平台账户 - WhatsApp、Telegram、Discord 或其他
5. 一台服务器或电脑 - 运行 Moltbot（Mac、Linux 或 Windows）

步骤 1：安装 Moltbot

最简单的安装方式是通过 npm：

npm install -g moltbot@latest

验证安装：

moltbot --version

步骤 2：运行设置向导

启动交互式设置向导：

moltbot onboard --install-daemon

这将引导你完成以下步骤：

1. 选择消息平台 - 从 WhatsApp、Telegram、Discord、iMessage、Slack 等中选择
2. 选择 AI 提供商 - 选择 Claude、ChatGPT、Gemini 或其他
3. 输入 API 凭证 - AI 服务的 API 密钥
4. 配置消息认证 - Bot 令牌或连接详情
5. 设置本地偏好 - 模型参数、响应风格等

步骤 3：连接你的 AI 提供商

使用 Anthropic Claude（推荐）

1. 从 console.anthropic.com 获取 API 密钥
2. 在设置中选择"Anthropic"作为你的 AI 提供商
3. 在提示时输入你的 API 密钥
4. 测试连接

使用 OpenAI ChatGPT

1. 从 platform.openai.com 获取 API 密钥
2. 在设置中选择"OpenAI"
3. 输入你的 API 密钥和首选模型（gpt-4、gpt-3.5-turbo 等）

步骤 4：配置你的消息平台

设置 Telegram

1. 在 Telegram 上用 BotFather 创建一个机器人
2. 获取你的机器人令牌
3. 配置 Moltbot 提供的 webhook URL
4. 通过给你的机器人发送消息进行测试

设置 WhatsApp

1. 创建一个商业账户
2. 生成 QR 代码进行扫描（或使用电话验证）
3. 连接你的商业电话号码
4. 开始与你的机器人聊天

步骤 5：测试你的设置

配置完成后，测试 Moltbot：

# 启动 Moltbot
moltbot gateway

# 在另一个终端，发送测试消息
# 到你在选定平台上的机器人

你应该在几秒内获得 AI 响应！

常见设置问题

问题："Cannot find module moltbot"

• 确保你全局安装了它：npm install -g moltbot@latest
• 检查 Node.js 是否安装：node --version

问题：API 密钥不工作

• 验证密钥有效且未过期
• 检查你使用的是正确的 AI 提供商
• 确保密钥具有必要的权限

问题：消息平台无响应

• 验证机器人令牌/凭证是否正确
• 检查 webhook URL 是否正确配置
• 确保你的机器人具有必要的权限

下一步

1. 为不同目的配置多个 AI 智能体
2. 设置群聊支持 以在对话中使用机器人
3. 启用媒体处理 支持图片、语音笔记等
4. 配置定时任务 进行自动化任务
5. 加入社区 获取技巧和建议

资源

• 官方文档
• GitHub 仓库
• 社区 Discord
• 最佳实践指南

祝你使用 Moltbot 聊天愉快！🦞