Moltbot 完全使用指南：从零开始部署你的私人 AI 助手

欢迎来到个人 AI 智能体的世界！你是否曾幻想过拥有一个像贾维斯（Jarvis）一样的私人 AI 助手，它不仅能陪你聊天，还能 24/7 全天候待命，帮你处理工作、管理生活、甚至自动执行任务？现在，这个梦想已经触手可及。

Clawdbot（现已更名为 Moltbot）就是这样一个开源项目，它在 2026 年初席卷了整个开发者社区，让无数技术爱好者为之疯狂。与 Siri 或小爱同学等云端助手不同，Moltbot 完全运行在你自己的设备上，这意味着你的所有数据、对话和隐私都由你自己掌控。它通过你日常使用的 WhatsApp、Telegram、Discord 等聊天软件与你互动，无需安装新的 App，就能将强大的 AI 能力无缝融入你的生活。

这篇指南将带你从零开始，一步步安装、配置并玩转你的第一个专属 AI 智能体。让我们开始吧！

Moltbot 在 GitHub 上广受欢迎，展示了其强大的社区吸引力。

第一部分：安装与部署你的 AI 助手

部署 Moltbot 并不像听起来那么复杂。只要你有一些基本的命令行操作经验，跟着下面的步骤，大概 15 分钟就能搞定。

准备工作

在开始之前，请确保你的电脑上已经安装了以下软件：

Node.js: 版本建议在 18.x 或更高。
Git: 用于从 GitHub 克隆项目代码。

步骤一：获取项目代码

打开你的终端（Terminal 或 PowerShell），找一个你喜欢的位置，然后输入以下命令克隆项目仓库：

git clone https://github.com/moltbot/molt.git

然后进入项目目录：

cd molt

步骤二：安装依赖

项目需要一些依赖库来运行，使用 npm（Node.js 的包管理器）一键安装即可：

npm install

安装过程会下载项目所需的所有库文件。

步骤三：初始化配置

接下来，运行设置向导。它会引导你完成一些基础配置，比如选择你想要连接的聊天工具。

npm run setup

在向导中，它会询问你想要启用哪些“网关”（Gateways），也就是连接聊天软件的通道。你可以使用空格键选择，比如 Telegram 和 Discord。

使用 npm run setup 命令，通过交互式向导快速完成初始配置。

步骤四：启动你的 Moltbot！

完成以上步骤后，你的 Moltbot 已经准备好第一次启动了。

npm start

如果一切顺利，你会在终端看到 Moltbot 成功启动的日志信息。恭喜你，你的 AI 助手已经“上线”了！

1.1 macOS 本地部署详细指南

对于 Mac 用户，部署过程同样顺畅。

后台持续运行（推荐): 如果你关闭终端，Moltbot 进程就会中断。为了让它 24/7 运行，我们推荐使用 pm2 这个进程管理器。

# 全局安装 pm2
npm install pm2 -g
# 使用 pm2 启动 Moltbot
pm2 start npm --name moltbot -- start
# 保存当前进程列表，以便重启后恢复
pm2 save
# (可选) 生成并配置启动脚本，让 pm2 随系统启动
pm2 startup

现在，即使你关闭终端或重启电脑，Moltbot 也会在后台安静地为你工作。你可以使用 pm2 list 查看状态，pm2 logs moltbot 查看日志。

克隆与安装：这部分与通用步骤完全相同。

git clone https://github.com/moltbot/molt.git
cd molt
npm install
npm run setup

安装 Node.js: 使用 Homebrew 安装 Node.js 非常简单。

brew install node

安装 Homebrew: 如果你还没安装，Homebrew 是 macOS 的“必装神器”。打开终端，运行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

使用 pm2 list 命令可以查看 Moltbot 是否正在后台稳定运行。

1.2 Railway.com 云端一键部署

不想折腾本地环境？可以把它部署在云端！Railway 是一个对个人开发者非常友好的平台，提供免费额度。

注册并登录 Railway: 使用你的 GitHub 账号登录 railway.app。
Fork 项目：首先，你需要将 Moltbot 的官方仓库 Fork 到你自己的 GitHub 账号下。
新建项目：在 Railway 仪表盘，点击 “New Project”，然后选择 “Deploy from GitHub repo”，找到你刚刚 Fork 的 molt 仓库。
配置环境变量： Railway 会自动开始部署。此时你需要配置环境变量，这是最关键的一步。在项目设置的 “Variables” 标签页，添加你的密钥，**注意不是直接修改 **moltbot.json。
- ANTHROPIC_API_KEY: 你的 Claude API 密钥。
- TELEGRAM_API_TOKEN: 你的 Telegram Bot Token。
- DISCORD_API_TOKEN: 你的 Discord Bot Token （如果使用）。
- DISCORD_CLIENT_ID: 你的 Discord Client ID （如果使用）。
- …… 其他你需要的技能密钥。

在 Railway 的 Variables 页面配置所有密钥，确保云端部署的安全性。

Railway 会自动检测到变量变化并重新部署。你可以在 “Deployments” 标签页查看日志，确保一切正常。

1.3 Zeabur 云端部署

Zeabur 是另一个优秀的选择，操作逻辑与 Railway 类似。

登录并 Fork 项目：同样，使用 GitHub 账号登录 zeabur.com 并 Fork Moltbot 仓库。
创建服务：在 Zeabur 中创建一个新项目，然后添加一个新服务，从你的 GitHub 仓库导入 molt。
配置变量：在服务的 “Variables” 设置中，添加与 Railway 步骤中相同的环境变量。
部署： Zeabur 会自动完成部署。

Railway vs Zeabur: 两者都非常出色。Railway 的界面可能更简洁，而 Zeabur 在某些区域的网络连接性可能更好。你可以都试试，选择你用着顺手的平台。

第二部分：核心配置——让它听懂你的话

Moltbot 的所有配置都集中在一个名为 moltbot.json 的文件中。这是你与 AI 助手沟通的“大脑中枢”。

连接大语言模型 (LLM)

Moltbot 只是一个“骨架”，它需要连接到一个大语言模型（如 Claude 或 GPT-4）才能拥有智慧。

获取 API 密钥：你需要前往 Anthropic (Claude) 或 OpenAI (GPT) 的官网注册并获取你的 API 密钥。
配置密钥：打开 moltbot.json 文件，找到 llm 部分，填入你的密钥。

moltbot.json* 文件是 Moltbot 的大脑，所有配置都在这里完成。*

{
  "llm": {
    "provider": "anthropic", // 或者 "openai"
    "apiKey": "sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxx" // 替换成你的 API Key
  },
  // ... 其他配置
}

隐私提示：如果你对数据隐私有极高要求，可以考虑使用 Ollama 在本地运行开源模型，并将 provider 设置为 ollama。这样，你的所有对话都无需发送到任何云端服务器。

连接聊天工具

在 gateways 部分，你可以配置你想要使用的聊天软件。

Telegram 配置示例

在 Telegram 中搜索 BotFather，创建一个新的机器人，你会得到一个 Token。
在 moltbot.json 中配置：

{
  "gateways": [
    {
      "type": "telegram",
      "enabled": true,
      "apiToken": "7123456789:AAGxxxxxxxxxxxxxxxxxxxxxxxxxx" // 替换成你的 Bot Token
    }
  ],
  // ... 其他配置
}

现在，在 Telegram 中找到你的机器人并给它发消息，Moltbot 就应该会回复你了！

通过日常聊天工具与你的专属 AI 互动。

Discord 配置与使用完全指南

Discord 功能强大，非常适合用来指挥你的 Moltbot，尤其是在需要处理代码、进行团队协作时。

1. 创建 Discord Bot

首先，你需要在 Discord 创建一个“机器人”身份。

访问开发者门户：前往 Discord Developer Portal。
创建应用：点击右上角的 “New Application”，给它起个名字，比如 “MyMoltbot”。
创建 Bot: 进入应用页面后，点击左侧的 “Bot” 标签。点击 “Add Bot”，然后 “Yes, do it!”。
获取 Token: 在 Bot 页面，点击 “Reset Token” 来生成并复制你的 Bot Token。这个 Token 非常重要，不要泄露给任何人！
开启权限网关：往下滑动，开启 “MESSAGE CONTENT INTENT” 这个开关。这是让机器人能够读取你消息内容所必需的。

2. 将 Bot 添加到你的服务器

生成邀请链接：回到左侧的 "OAuth2" -> "URL Generator"。在 "SCOPES" 里勾选 bot 和 applications.commands。
设置权限：接着在下方出现的 "BOT PERMISSIONS" 中，勾选机器人需要的基本权限，建议至少勾选：
- Send Messages
- Read Message History
- Attach Files
- Embed Links
- Use External Emojis

为你的 Bot 配置正确的权限是它能正常工作的前提。

复制链接：复制最下方的生成链接，在浏览器中打开，选择你自己的服务器，授权即可。

将配置好的机器人邀请到你的 Discord 服务器。

3. 在 Moltbot 中配置 Discord

打开你的 moltbot.json 文件，添加或修改 gateways 部分：

{
  "gateways": [
    {
      "type": "discord",
      "enabled": true,
      "apiToken": "你的Bot-Token粘贴在这里",
      "clientId": "你在General-Information页面找到的Application-ID"
    }
    // ... 你可能还有其他 gateway，比如 telegram
  ],
  // ... 其他配置
}

重启 Moltbot，如果配置正确，你的机器人在 Discord 中就会显示为“在线”状态。

4. Discord 实战使用案例

现在，你可以在 Discord 频道里和你的 Moltbot 互动了！

基础对话与任务分配：直接 @你的机器人 然后用自然语言下达指令。像和真人对话一样，在 Discord 中向 Moltbot 分配任务。
安装技能与网页分析：使用 /skill install 命令来扩展它的能力，比如安装 web-search 技能后，让它帮你分析网页内容。通过安装技能，你的 Moltbot 可以获得上网、搜索、分析网页等新能力。
代码解释：把一段代码贴在聊天框里，让它帮你逐行解释，或者帮你 debug。对于开发者来说，让 Moltbot 解释或审查代码是一个非常高效的用法。
文件处理与总结：上传一个 PDF 或文本文档，然后让它帮你总结核心要点。@MyMoltbot 总结一下我刚上传的这份 PDF 文档的核心内容。处理长篇文档的利器：上传文件，AI 自动为你提炼精华。

第三部分：安全第一！保护你的 AI 助手

Moltbot 功能强大，能读写文件、执行命令。如果配置不当，它可能会成为一个安全隐患。请务必遵守以下安全准则：

黄金法则：绝不将端口暴露在公网

默认情况下，Moltbot 可能在本机开启一个端口。绝对不要使用路由器端口转发等方式将它直接暴露到互联网上。这相当于把你家的钥匙直接挂在了门外。

正确做法：使用加密隧道工具，如 Cloudflare Tunnel 或 Tailscale。它们可以为你创建一个安全的、只有你自己能访问的通道，让你在外面也能安全地和家里的 Moltbot 通信。

最小权限原则

在 moltbot.json 文件中，你可以精细地控制 Moltbot 的权限。如果某个功能你用不到，就果断关掉它。例如，执行系统命令的功能（shell）风险极高，如果你不确定是否需要，请务必禁用：

{
  "skills": {
    "shell": {
      "enabled": false // 禁用 shell 命令执行功能
    }
  },
  // ... 其他配置
}

使用 `doctor` 命令体检

Moltbot 自带一个安全检查工具，可以帮你发现常见的配置风险。建议定期运行它：

npm run doctor

doctor* 命令可以帮你发现并修复潜在的安全问题。*

第四部分：实战！Moltbot 的 N 种玩法

配置完成，现在是发挥想象力的时候了！以下是一些真实的用户案例，希望能给你带来启发。

场景一：工作学习好帮手

会议纪要总结：将长达一小时的会议录音转录成文字，发给 Moltbot，让它在 30 秒内为你提炼出核心要点和待办事项。
代码解释器：遇到一段看不懂的代码？直接发给 Moltbot，让它逐行解释给你听。
外语学习伙伴：让 Moltbot 扮演你的外语老师，随时随地陪你练习口语和纠正语法错误。

让 AI 成为你的 24/7 技术导师。

场景二：全能生活助理

新闻摘要官：配置一个技能，让 Moltbot 每天早上自动抓取你感兴趣领域的新闻，并生成一份 5 分钟的摘要发给你。
智能购物清单：随时通过聊天告诉 Moltbot 你需要买什么，它会自动帮你整理成一个购物清单。
灵感记录员：散步时突然冒出个好点子？直接发条语音给 Moltbot，它会自动转成文字并保存到你的笔记应用中。

利用 Moltbot 快速消化和处理信息。

第五部分：ClawdHub——AI 助手的“应用商店”

Moltbot 的强大之处在于其可扩展性。ClawdHub 就是官方的技能市场，社区开发者在这里分享了数以百计的实用技能，涵盖了从文件管理到智能家居控制的方方面面。

在 ClawdHub 发现并安装社区创建的强大技能。

如何安装技能？

在与 Moltbot 的对话中，直接发送命令即可安装：

/skill install web-search

这条命令会安装一个让你的 Moltbot 具备上网搜索能力的技能。

安全提醒：安装社区技能就像安装浏览器插件，请务必从可信的来源安装，并在安装前花点时间查看其源代码，了解它会做什么。

第六部分：常见问题 (FAQ)

Moltbot 启动失败怎么办？
- 首先检查终端的报错信息，通常会给出线索。最常见的原因是 moltbot.json 配置文件格式错误或 API 密钥不正确。
如何更新 Moltbot 到最新版本？
- 在项目目录下，依次执行 git pull 拉取最新代码，然后 npm install 更新依赖即可。
我可以同时在多个设备上和它聊天吗？
- 可以。只要你配置了多个网关（如 Telegram 和 Discord），你就可以在这些平台上同时与同一个 Moltbot 实例对话，它的记忆是互通的。
遇到问题去哪里求助？
- 官方的 Discord 社区是最好的求助地点，那里有成千上万的活跃用户和开发者。

拥有一个私人 AI 智能体是一段激动人心的旅程。Moltbot 为我们提供了一个起点，一个能够完全由我们自己掌控、塑造和扩展的智能核心。它不仅仅是一个工具，更像是一个数字化的伙伴，潜力无限。

现在，轮到你了。去创造、去实验，看看你的 Moltbot 能为你做些什么吧！