🦞 Moltbot 完整安装与部署教程 🦞

1检查系统要求

• 操作系统： macOS（推荐）或 Linux/WSL2
• Node.js：版本 >= 22
• 包管理器：npm、pnpm 或 bun（推荐 pnpm）
• 磁盘空间：至少 500MB 可用空间
• 内存：至少 2GB RAM

2验证 Node.js 版本

打开终端，检查 Node.js 是否已安装：

node --version

如果版本低于 22，需要升级 Node.js：

使用 nvm 安装/管理 Node.js：

# 安装 nvm（如果尚未安装）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 安装并使用 Node.js 22
nvm install 22
nvm use 22

# 验证版本
node --version

3安装 pnpm（推荐）

# 使用 npm 安装 pnpm
npm install -g pnpm

# 验证安装
pnpm --version

1运行 onboarding 向导

这是最简单、最推荐的配置方式：

moltbot onboard --install-daemon

向导会引导您完成以下配置：

• 选择本地或远程 Gateway
• 配置 AI 模型认证（OAuth 或 API Key）
• 设置聊天频道（WhatsApp、Telegram、Discord 等）
• 配置 DM 安全性（配对审批）
• 设置工作区和技能
• 安装后台服务（launchd/systemd）

2手动配置（可选）

如果您不想使用向导，可以手动配置。配置文件位于：

~/.clawdbot/moltbot.json

基本配置示例：

{
  "agent": {
    "model": "anthropic/claude-opus-4-5"
  },
  "gateway": {
    "port": 18789,
    "auth": {
      "token": "your-gateway-token-here"
    }
  }
}

1创建 Telegram Bot

1. 打开 Telegram，搜索并联系 @BotFather
2. 发送 /newbot 命令
3. 按照提示输入 Bot 名称和用户名
4. 保存好 Bot Token（格式类似：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）

2配置 Telegram 频道

编辑配置文件，添加 Telegram 配置：

# 使用 CLI 配置（推荐）
moltbot configure --section telegram --key botToken "你的Bot Token"

# 或者手动编辑配置文件
moltbot configure

配置文件内容：

{
  "channels": {
    "telegram": {
      "botToken": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
      "groups": {
        "*": {
          "requireMention": false
        }
      },
      "allowFrom": ["*"]
    }
  }
}

3设置 DM 安全策略

Moltbot 默认启用 DM 配对保护，需要批准后才能接收消息：

{
  "channels": {
    "telegram": {
      "dmPolicy": "pairing",
      "allowFrom": ["*"]
    }
  }
}

4登录 Telegram 频道

# 登录 Telegram
moltbot channels login telegram

首次登录会提示配置验证信息。

1检查系统状态

# 检查整体状态
moltbot status

# 健康检查
moltbot health

# 深度安全审计
moltbot security audit --deep

2测试 Telegram Bot

1. 在 Telegram 中找到您的 Bot
2. 发送 /start 命令
3. Bot 应该返回配对码
4. 批准配对请求：

# 列出待批准的配对
moltbot pairing list telegram

# 批准配对
moltbot pairing approve telegram 配对码

3发送测试消息

# 通过 CLI 发送测试消息
moltbot message send --target +15555550123 --message "Hello from Moltbot!"

# 与 Agent 对话
moltbot agent --message "你好，Moltbot！" --thinking high

4访问 Web UI

打开浏览器访问：

# 控制面板
http://127.0.0.1:18789/

# WebChat
http://127.0.0.1:18789/webchat