Moltbot(Clawdbot)教程 -01- 部署完整指南

打造你自己的 AI 员工 - 一个可以连接 WhatsApp、Telegram、Discord、Slack 等多平台的个人 AI 助手

重要说明: Moltbot 是 Clawdbot 的新名称（因商标问题于 2026年1月更名）

📋 目录

文章目录

• Moltbot(Clawdbot)教程 -01- 部署完整指南
• • 📋 目录
  • @[toc]
  • 🎯 项目简介
  • 📢 更名说明
  • • 为什么从 Clawdbot 改名为 Moltbot?
    • 对用户的影响
    • 如何迁移
  • 💻 系统要求
  • • 基础要求
    • API 密钥要求
    • 硬件建议
  • 🚀 快速开始
  • • 方法 1: 全局安装 (推荐新手)
    • 方法 2: 从源码安装 (开发者)
  • 📝 详细部署步骤
  • • 第一步: 安装依赖
    • 第二步: 安装 Moltbot
    • 第三步: 配置向导
    • 第四步: 启动网关
    • 第五步: 测试连接
  • ⚙️ 配置说明
  • • 基础配置文件
    • 环境变量配置
  • 🔌 平台集成
  • • 1. WhatsApp 集成
    • 2. Telegram 集成
    • 3. Discord 集成
    • 4. Slack 集成
    • 5. Signal 集成
  • 🛡️ 安全配置
  • • DM(私信)访问控制
    • 沙箱模式
    • 密码保护
  • 🌐 远程访问配置
  • • 方法 1: Tailscale (推荐)
    • 方法 2: SSH 隧道
  • 🎨 高级功能
  • • 1. 浏览器控制
    • 2. Canvas 画布
    • 3. 定时任务 (Cron)
    • 4. Webhook 集成
  • 🔧 常用命令
  • • 网关管理
    • 消息发送
    • 与 AI 对话
    • 会话管理
    • 节点管理
    • 配对管理
    • 诊断工具
  • 💬 聊天命令
  • 🐛 常见问题
  • • 1. 安装问题
    • 2. 网关问题
    • 3. 消息渠道问题
    • 4. 更名相关问题
  • 📚 进阶资源
  • • 官方文档
    • 社区资源
    • 开发指南
  • 🎯 下一步
  • 📄 许可证
  • 🙏 致谢
  • ⚠️ 重要提醒

🎯 项目简介

Moltbot (原 Clawdbot) 是一个开源的个人 AI 助手框架,具有以下特点:

• ✅ 支持多平台消息渠道(WhatsApp、Telegram、Discord、Slack、Signal、iMessage 等)
• ✅ 本地优先的网关架构,数据掌握在自己手中
• ✅ 支持语音唤醒和对话模式
• ✅ 可视化 Canvas 工作区
• ✅ 浏览器控制、定时任务等强大工具
• ✅ 支持 macOS、Linux、Windows(WSL2)
• ✅ 72.1K+ GitHub Stars (截至 2026年1月)

---

📢 更名说明

为什么从 Clawdbot 改名为 Moltbot?

2026年1月，Anthropic 向项目创始人发送商标警告，要求停止使用 “Clawd” 相关名称（因与 “Claude” 过于相似）。

时间线:

• 2024年底: Clawdbot 项目启动
• 2025年12月: 项目在 GitHub 爆红
• 2026年1月24日: Anthropic 发送商标警告
• 2026年1月27日: 正式更名为 Moltbot

对用户的影响

✅ 功能完全相同: Moltbot 就是 Clawdbot，只是换了名字
✅ 配置兼容: ~/.clawdbot/ 配置目录继续使用
✅ 命令兼容: clawdbot 命令作为兼容性 shim 保留
✅ 平滑迁移: 现有安装可以无缝升级

如何迁移

# 老用户升级到 Moltbot
npm update -g moltbot@latest

# clawdbot 命令仍然可用（作为别名）
moltbot --version  # 新命令
clawdbot --version  # 旧命令仍然工作

---

💻 系统要求

基础要求

• Node.js: >= 22.x (必需)

• 包管理器: npm、pnpm 或 bun

• 操作系统

  :

  • macOS (推荐)
  • Linux
  • Windows (需通过 WSL2,强烈推荐)

API 密钥要求

需要以下至少一个 AI 服务的 API 密钥:

• Anthropic Claude (推荐: Claude Opus 4.5)
  • Claude Pro/Max 订阅
  • 或 Anthropic API 密钥
• OpenAI
  • ChatGPT/GPT-4 API 密钥
• DeepSeek (高性价比选择)
  • DeepSeek API 密钥
  • 支持 DeepSeek-V3、DeepSeek-R1 等模型

硬件建议

• 最低配置: 2GB RAM, 2 核 CPU
• 推荐配置: 4GB+ RAM, 4 核+ CPU
• 磁盘空间: 至少 2GB 可用空间

---

🚀 快速开始

方法 1: 全局安装 (推荐新手)

# 使用 npm 安装
npm install -g moltbot@latest

# 或使用 pnpm
pnpm add -g moltbot@latest

# 运行向导式安装
moltbot onboard --install-daemon

方法 2: 从源码安装 (开发者)

# 克隆仓库
git clone https://github.com/moltbot/moltbot.git
cd moltbot

# 安装依赖(推荐使用 pnpm)
pnpm install

# 构建 UI
pnpm ui:build

# 构建项目
pnpm build

# 运行向导安装
pnpm moltbot onboard --install-daemon

---

📝 详细部署步骤

第一步: 安装依赖

确保已安装 Node.js 22+:

# 检查 Node 版本
node --version

# 如果版本低于 22,建议使用 nvm 安装
# 安装 nvm (如果还没有)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 安装 Node 22
nvm install 22
nvm use 22

第二步: 安装 Moltbot

# 全局安装
npm install -g moltbot@latest

# 验证安装
moltbot --version

第三步: 配置向导

# 运行配置向导
moltbot onboard --install-daemon

向导会引导你完成:

1. ✅ 选择 AI 模型 (Anthropic/OpenAI/DeepSeek)
2. ✅ 配置 API 密钥
3. ✅ 设置消息渠道 (WhatsApp/Telegram/Discord 等)
4. ✅ 配置工作区和技能
5. ✅ 安装后台守护进程

第四步: 启动网关

# 启动网关 (端口 18789)
moltbot gateway --port 18789 --verbose

网关启动后,你可以访问:

• 控制面板: http://localhost:18789
• WebChat: http://localhost:18789/chat

第五步: 测试连接

# 发送测试消息
moltbot message send --to +1234567890 --message "你好,Molty!"

# 直接与助手对话
moltbot agent --message "帮我列一个项目清单" --thinking high

---

⚙️ 配置说明

基础配置文件

配置文件位置: ~/.clawdbot/moltbot.json

最小配置示例:

{
  "agent": {
    "model": "anthropic/claude-opus-4-5"
  }
}

完整配置示例:

{
  "agent": {
    "model": "anthropic/claude-opus-4-5",
    "workspace": "~/clawd"
  },
  "gateway": {
    "port": 18789,
    "bind": "loopback",
    "auth": {
      "mode": "password",
      "password": "your-secure-password"
    }
  },
  "channels": {
    "telegram": {
      "botToken": "YOUR_TELEGRAM_BOT_TOKEN",
      "allowFrom": ["@your_username"]
    },
    "discord": {
      "token": "YOUR_DISCORD_BOT_TOKEN"
    }
  },
  "browser": {
    "enabled": true,
    "color": "#FF4500"
  }
}

环境变量配置

创建 .env 文件:

# AI 模型配置
ANTHROPIC_API_KEY=your-anthropic-key
OPENAI_API_KEY=your-openai-key
DEEPSEEK_API_KEY=your-deepseek-key

# Telegram 配置
TELEGRAM_BOT_TOKEN=your-telegram-bot-token

# Discord 配置
DISCORD_BOT_TOKEN=your-discord-bot-token

# Slack 配置
SLACK_BOT_TOKEN=your-slack-bot-token
SLACK_APP_TOKEN=your-slack-app-token

---

🔌 平台集成

1. WhatsApp 集成

# 登录 WhatsApp
moltbot channels login

# 扫描二维码连接设备

配置示例:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890", "+0987654321"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

2. Telegram 集成

步骤:

1. 与 @BotFather 对话创建机器人
2. 获取 Bot Token
3. 配置到 Moltbot

{
  "channels": {
    "telegram": {
      "botToken": "123456:ABCDEF...",
      "allowFrom": ["@username"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

或通过环境变量:

export TELEGRAM_BOT_TOKEN="123456:ABCDEF..."

3. Discord 集成

步骤:

1. 访问 Discord Developer Portal
2. 创建新应用
3. 添加 Bot 并获取 Token
4. 配置权限并邀请到服务器

{
  "channels": {
    "discord": {
      "token": "YOUR_DISCORD_BOT_TOKEN",
      "dm": {
        "policy": "pairing",
        "allowFrom": ["user_id_1", "user_id_2"]
      },
      "guilds": {
        "guild_id": {
          "channels": ["channel_id_1", "channel_id_2"]
        }
      }
    }
  }
}

4. Slack 集成

# 设置环境变量
export SLACK_BOT_TOKEN="xoxb-..."
export SLACK_APP_TOKEN="xapp-..."

或在配置文件中:

{
  "channels": {
    "slack": {
      "botToken": "xoxb-...",
      "appToken": "xapp-..."
    }
  }
}

5. Signal 集成

需要先安装 signal-cli:

# macOS
brew install signal-cli

# Linux
# 参考官方文档安装

配置:

{
  "channels": {
    "signal": {
      "phoneNumber": "+1234567890",
      "allowFrom": ["+0987654321"]
    }
  }
}

---

🛡️ 安全配置

DM(私信)访问控制

默认情况下,Moltbot 对陌生人的私信采用配对模式:

{
  "channels": {
    "telegram": {
      "dm": {
        "policy": "pairing"  // 需要配对码
      }
    },
    "discord": {
      "dm": {
        "policy": "pairing",
        "allowFrom": ["approved_user_id"]
      }
    }
  }
}

批准配对请求:

moltbot pairing approve telegram <pairing-code>

开放模式(不推荐):

{
  "channels": {
    "telegram": {
      "dm": {
        "policy": "open",
        "allowFrom": ["*"]
      }
    }
  }
}

沙箱模式

对于群组/频道,建议启用沙箱:

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main",  // 非主会话使用 Docker 沙箱
        "allowTools": ["bash", "read", "write"],
        "denyTools": ["browser", "canvas"]
      }
    }
  }
}

密码保护

为网关添加密码保护:

{
  "gateway": {
    "auth": {
      "mode": "password",
      "password": "your-secure-password-here"
    }
  }
}

---

🌐 远程访问配置

方法 1: Tailscale (推荐)

{
  "gateway": {
    "tailscale": {
      "mode": "serve",  // 或 "funnel" (公开访问)
      "resetOnExit": true
    },
    "bind": "loopback",
    "auth": {
      "mode": "password"
    }
  }
}

方法 2: SSH 隧道

# 本地端口转发
ssh -L 18789:localhost:18789 user@remote-server

# 然后访问
# http://localhost:18789

---

🎨 高级功能

1. 浏览器控制

{
  "browser": {
    "enabled": true,
    "color": "#FF4500"
  }
}

2. Canvas 画布

Canvas 是一个可视化工作区,可由 AI 控制:

# macOS/iOS/Android 设备可作为 Canvas 节点
moltbot nodes list

3. 定时任务 (Cron)

{
  "cron": {
    "jobs": {
      "daily-summary": {
        "schedule": "0 9 * * *",
        "task": "发送每日摘要"
      }
    }
  }
}

4. Webhook 集成

{
  "webhook": {
    "enabled": true,
    "port": 18790,
    "endpoints": {
      "/alert": {
        "method": "POST",
        "action": "forward-to-telegram"
      }
    }
  }
}

---

🔧 常用命令

网关管理

# 启动网关
moltbot gateway --port 18789 --verbose

# 后台启动
moltbot gateway --daemon

# 停止网关
moltbot gateway --stop

# 查看状态
moltbot status

消息发送

# 发送消息
moltbot message send --to +1234567890 --message "Hello"

# 发送到 Telegram
moltbot message send --channel telegram --to @username --message "Hi"

与 AI 对话

# 直接对话
moltbot agent --message "你好"

# 高思考模式
moltbot agent --message "分析这个问题" --thinking high

# 详细模式
moltbot agent --message "解释量子计算" --verbose on

会话管理

# 新建会话
moltbot session new

# 列出会话
moltbot session list

# 重置会话
moltbot session reset

# 压缩会话上下文
moltbot session compact

节点管理

# 列出可用节点
moltbot nodes list

# 节点详情
moltbot nodes describe <node-id>

# 调用节点功能
moltbot nodes invoke <node-id> camera.snap

配对管理

# 列出待配对请求
moltbot pairing list

# 批准配对
moltbot pairing approve telegram <code>

# 拒绝配对
moltbot pairing reject telegram <code>

诊断工具

# 运行健康检查
moltbot doctor

# 检查配置
moltbot config validate

# 查看日志
moltbot logs --tail 100

---

💬 聊天命令

在 WhatsApp/Telegram/Discord 等平台发送以下命令:

• /status - 查看当前会话状态
• /new 或 /reset - 重置会话
• /compact - 压缩会话上下文
• /think <level> - 设置思考级别 (off|minimal|low|medium|high|xhigh)
• /verbose on|off - 开关详细模式
• /usage off|tokens|full - 使用统计
• /activation mention|always - 群组激活模式
• /restart - 重启网关(仅管理员)

---

🐛 常见问题

1. 安装问题

Q: Node 版本不兼容

# 使用 nvm 切换版本
nvm install 22
nvm use 22

Q: pnpm 安装失败

# 清除缓存重试
pnpm store prune
pnpm install --force

2. 网关问题

Q: 端口被占用

# 查看占用端口的进程
lsof -i :18789

# 杀死进程
kill -9 <PID>

# 或使用其他端口
moltbot gateway --port 18800

Q: 无法访问网关

# 检查防火墙
sudo ufw status
sudo ufw allow 18789

# 检查绑定地址
# 确保 gateway.bind 设置为 "loopback" 或 "0.0.0.0"

3. 消息渠道问题

Q: WhatsApp 连接失败

# 删除旧凭证重新登录
rm -rf ~/.clawdbot/credentials/whatsapp*
moltbot channels login

Q: Telegram Bot 无响应

# 验证 Bot Token
curl https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getMe

# 检查 webhook 配置
moltbot channels telegram webhook --check

Q: Discord Bot 离线

# 检查 Bot 权限
# 确保 Bot 有以下权限:
# - Read Messages
# - Send Messages
# - Embed Links
# - Attach Files

4. 更名相关问题

Q: 我的旧 Clawdbot 配置还能用吗?

可以! Moltbot 完全向后兼容:

• 配置目录 ~/.clawdbot/ 继续使用
• clawdbot 命令作为别名保留
• 所有配置文件无需修改

Q: 需要重新安装吗?

不需要! 直接升级即可:

npm update -g moltbot@latest

Q: 官方文档链接变了吗?

是的,新的官方地址:

• 网站: https://molt.bot (原 clawd.bot)
• 文档: https://docs.molt.bot
• GitHub: https://github.com/moltbot/moltbot

---

📚 进阶资源

官方文档

• 主文档: https://docs.molt.bot
• 配置参考: https://docs.molt.bot/gateway/configuration
• 架构说明: https://docs.molt.bot/concepts/architecture
• 安全指南: https://docs.molt.bot/gateway/security

社区资源

• GitHub: https://github.com/moltbot/moltbot
• Discord: https://discord.gg/clawd
• DeepWiki: https://deepwiki.com/moltbot/moltbot
• X/Twitter: @moltbot

开发指南

• 贡献指南: CONTRIBUTING.md
• 技能开发: https://docs.molt.bot/tools/skills
• 工具集成: https://docs.molt.bot/tools

---

🎯 下一步

1. ✅ 完成基础部署 - 按照本指南完成安装
2. ✅ 连接第一个渠道 - 从 Telegram 或 Discord 开始
3. ✅ 配置安全策略 - 设置 DM 配对和沙箱
4. ✅ 启用高级功能 - 浏览器控制、Canvas、Cron
5. ✅ 自定义技能 - 添加自己的工作流和自动化
6. ✅ 加入社区 - 分享经验,获取帮助

---

📄 许可证

Moltbot 采用 MIT 许可证开源。

---

🙏 致谢

感谢 Moltbot/Clawdbot 社区的所有贡献者!

特别感谢:

• Peter Steinberger (项目创始人 @steipete)
• Mario Zechner (支持和 pi-mono)
• 所有 72,000+ Star 的支持者
• 全球 Discord 社区成员

---

⚠️ 重要提醒

警惕加密货币诈骗: 项目更名期间出现了假冒的 $CLAWD 代币诈骗。

❌ Moltbot 与任何加密货币、代币、NFT 无关
❌ 不要购买任何声称与 Moltbot/Clawdbot 相关的代币
✅ 官方项目永久免费开源

---

祝你部署顺利! 🦞

如有问题,欢迎访问 GitHub Issues