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

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

苍云烟

4652人浏览 · 2026-01-27 10:29:37

苍云烟 · 2026-01-27 10:29:37 发布

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

向导会引导你完成:

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

第四步: 启动网关

# 启动网关 (端口 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 集成

步骤:

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

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

或通过环境变量:

export TELEGRAM_BOT_TOKEN="123456:ABCDEF..."

3. Discord 集成

步骤:

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

{
  "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

🎯 下一步

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

📄 许可证

Moltbot 采用 MIT 许可证开源。

🙏 致谢

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

特别感谢:

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

⚠️ 重要提醒

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

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

祝你部署顺利! 🦞

如有问题,欢迎访问 GitHub Issues

松山湖开发者村综合服务平台

助力广东及东莞地区开发者，代码托管、在线学习与竞赛、技术交流与分享、资源共享、职业发展，成为松山湖开发者首选的工作与学习平台

更多推荐

HarmonyOS 5.0车机应用开发实战：基于方舟引擎的智能座舱多模态交互系统

松山湖开发者村综合服务平台

【大数据存储与管理】分布式数据库HBase：06 HBase编程实践

松山湖开发者村综合服务平台

（论文速读）基于混合学习的边缘计算物联网系统操作视觉质量检测

松山湖开发者村综合服务平台

所有评论(0)

查看更多评论

苍云烟

@qq_34599132

已为社区贡献1条内容