Moltbot 核心官网入口
Moltbot 官方主页:https://molt.bot/ (原名 Clawdbot,2026 年 1 月 27 日正式更名)
官方文档中心:https://docs.molt.bot/ (推荐,包含完整安装、配置、技能开发指南)
GitHub 仓库(最新源码):https://github.com/moltbot/moltbot
技能市场(ClawdHub):https://clawdhub.com/ (100 + 社区开发的技能,如 Todoist 集成、财务跟踪)
Discord 社区(技术支持):https://discord.gg/clawd (8,900 + 成员,实时问题解答)
重要提示:Moltbot 是 Clawdbot 的正式更名版本,原 Clawdbot 官网(https://clawd.bot/)会自动跳转至 Moltbot 主页,所有功能保持不变,仅品牌标识更新。
Moltbot 在线使用指南
1. 官方核心文档资源(推荐优先阅读)
文档类型 链接 适用场景
快速入门向导 https://docs.molt.bot/getting-started 5 分钟完成基础安装与首次交互
消息平台配置 https://docs.molt.bot/channels WhatsApp/Telegram/Discord 等平台配对教程
模型配置指南 https://docs.molt.bot/models 云端 API(Claude/OpenAI)与本地模型(Ollama)设置
主动消息功能 https://docs.molt.bot/features/proactive-messaging 设置提醒、警报、每日简报等主动通知
安全最佳实践 https://docs.molt.bot/security DM 配对、Docker 沙箱、权限管控等安全设置
命令行参考 https://docs.molt.bot/cli 完整 CLI 命令说明,含moltbot onboard、moltbot gateway等
2. 5 分钟快速上手流程(零基础用户推荐)
前置条件(必须满足)
操作系统:macOS、Linux 或 Windows(仅支持 WSL2,不支持原生 Windows)
Node.js ≥22.0.0(核心依赖,低版本会导致安装失败)
AI 模型支持:Claude Pro/Max API 密钥、OpenAI API 密钥或 Ollama 本地模型(二选一)
安装与初始化命令(直接复制执行)
bash
运行
# 1. 全局安装最新版Moltbot(兼容Clawdbot所有指令)
npm install -g moltbot@latest
# 2. 一键启动官方初始化向导(自动配置网关、工作空间、消息平台)
moltbot onboard --install-daemon
# 3. 消息平台配对(选择WhatsApp/Telegram等,按提示完成)
moltbot channels login
# 4. 启动核心网关服务(默认端口18789)
moltbot gateway --port 18789
# 5. 验证安装成功(通过配对的消息平台发送)
消息内容:嗨,你能做什么?
向导交互关键步骤
同意用户协议
选择安装模式(推荐quickstart快速模式)
配置 AI 模型(输入 API 密钥或选择本地模型)
选择消息平台(优先 WhatsApp/Telegram,操作简单)
开启守护进程(推荐,实现后台自动运行)
3. 核心功能使用指南(常用场景)
(1)消息平台配对详细教程
平台 配对步骤 关键注意事项
WhatsApp 1. 执行moltbot channels login→选择 WhatsApp
2. 终端生成二维码
3. 手机 WhatsApp「设置 - 链接设备」扫描二维码 确保手机与电脑在同一局域网,二维码有效期 2 分钟
Telegram 1. 执行moltbot channels login→选择 Telegram
2. 输入 BotFather 获取的 Bot Token
3. 发送/start到机器人完成配对 需先在 Telegram 搜索 @BotFather 创建机器人获取 Token
Discord 1. 执行moltbot channels login→选择 Discord
2. 输入 Bot Token
3. 邀请机器人到服务器 需在 Discord 开发者平台创建应用并添加 Bot 权限
(2)本地模型配置(无需云端 API,完全私有化)
安装 Ollama(本地大模型运行环境):https://ollama.com/
拉取支持工具调用的模型:ollama pull glm-4:7b-flash
修改 Moltbot 配置文件(~/.clawdbot/moltbot.json):
json
{
"agent": {
"model": "ollama/glm-4:7b-flash",
"endpoint": "http://127.0.0.1:11434/v1", // Ollama默认端点
"apiKey": "ollama" // 固定值,无需修改
}
}
重启网关:moltbot gateway restart
(3)常用命令速查(高效管理)
bash
运行
moltbot status # 检查服务状态
moltbot health # 系统健康检查
moltbot logs --follow # 实时查看日志
moltbot configure # 交互配置工具
moltbot skills list # 查看已安装技能
moltbot daemon start # 启动守护进程
4. 本地 Web UI 使用(可视化管理)
安装成功并启动网关后,通过浏览器访问:
Web 控制台:http://127.0.0.1:18789/ (管理会话、查看状态、调试)
Web 聊天界面:http://127.0.0.1:18789/webui (直接与 AI 助手交互,无需消息平台)
5. 常见问题排查(快速解决)
Node.js 版本过低:提示Unsupported engine → 通过 nvm 安装 Node.js 22+
bash
运行
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 22 && nvm use 22
端口 18789 被占用:提示EADDRINUSE → 更换端口:moltbot gateway --port 18790
WhatsApp 配对失败:二维码扫描无反应 → 关闭网关后重新执行moltbot channels login
npm 安装权限不足:提示Permission denied → 添加--unsafe-perm参数:
bash
运行
npm install -g moltbot@latest --unsafe-perm
三、兼容性说明(与 Clawdbot)
指令兼容:安装 Moltbot 后,旧指令clawdbot仍可使用(为兼容旧脚本保留的别名)
bash
运行
clawdbot gateway # 等价于 moltbot gateway
clawdbot channels login # 等价于 moltbot channels login
配置文件迁移:Clawdbot 的配置文件可直接复制到 Moltbot 配置目录
bash
运行
cp ~/.clawdbot/clawdbot.json ~/.clawdbot/moltbot.json
功能完全兼容:Moltbot 保留了 Clawdbot 的所有核心功能,并新增了更多模型支持和安全特性
四、进阶学习资源
技能开发指南:https://docs.molt.bot/skills-development (创建自定义技能)
多代理编排:https://docs.molt.bot/agents/multi-agent (多个 AI 代理协作完成复杂任务)
Docker 部署:https://docs.molt.bot/deployment/docker (容器化部署,提升安全性)
中文社区教程:https://clawdbotcn.cn/moltbot.html (适合国内用户的详细指南)
本资讯来自互联网,如有侵权强联系删除~