Moltbot

Moltbot macOS 应用安装

Moltbot.app 是在 macOS 上运行 Moltbot 的推荐方式。它常驻菜单栏，自动管理 Gateway。

太长不看

# 1. 安装应用（从发布页下载或使用 brew） # 2. 从「应用程序」启动 Moltbot.app # 3. 完成引导权限设置 # 4. 连接你的渠道： moltbot channels login # 5. 验证： moltbot health

分步指南

1. 安装 Moltbot.app

从 Moltbot 发布页下载最新版本，或通过 Homebrew 安装：

brew install --cask moltbot

2. 启动应用

从「应用程序」文件夹打开 Moltbot.app。你会在菜单栏看到一个新图标。

3. 完成引导设置

应用会引导你完成初始设置：

  1. 权限检查清单 - 授予所需的 TCC 权限（辅助功能、自动化等）
  2. Gateway 设置 - 应用会自动启动内置的 Gateway
  3. 初始配置 - 设置你偏好的 AI 模型和基本设置
如果你的版本没有引导向导，请手动运行以下命令：
moltbot setup moltbot channels login moltbot gateway

4. 验证 Gateway 状态

在菜单栏应用中，检查：

  • Gateway Status: 应显示「运行中」或「本地」
  • Connection Mode: 应为「本地」

你也可以通过命令行验证：

moltbot health

5. 连接你的渠道

使用命令行连接消息平台：

moltbot channels login

这个交互式命令会：

  • 显示可用渠道（WhatsApp、Telegram、Discord、Slack）
  • 引导你完成每个渠道的认证
  • 将凭证安全存储在 ~/.clawdbot/credentials/

例如，连接 WhatsApp：

moltbot channels login whatsapp

用手机扫描二维码，即可连接！

Gateway 管理

理解 Gateway 模式

模式说明使用场景
Bundled应用运行自己的 Gateway默认，最简单
Local应用连接到外部 Gateway开发
Remote应用连接到远程服务器高级

检查 Gateway 状态

在菜单栏点击 Moltbot 图标，查看「Gateway 状态」。或通过命令行：

moltbot health

重启 Gateway

如果遇到问题，点击菜单栏 Moltbot 图标，选择「重启 Gateway」。或通过命令行：

moltbot gateway restart

常见问题

权限被拒绝错误

macOS 需要明确授予自动化权限。前往「系统设置」→「隐私与安全性」→「辅助功能」，将 Moltbot.app 添加到允许列表。

Gateway 无法启动

检查端口是否已被占用。终止冲突进程或在设置中更改 Gateway 端口。

lsof -i :18789
应用无法连接到 Gateway

确保应用和命令行使用相同的端口。默认 WebSocket: ws://127.0.0.1:18789。检查 ~/.clawdbot/moltbot.json 中的端口设置。

文件位置

内容位置
配置~/.clawdbot/moltbot.json
凭证~/.clawdbot/credentials/
会话~/.clawdbot/agents/<agentId>/sessions/
日志/tmp/moltbot/
工作空间~/clawd

更新应用

通过 Homebrew

brew upgrade moltbot

手动更新

  1. 下载最新版本
  2. 替换 /Applications 中的应用
  3. 重新启动
更新时会保留你的配置（~/.clawdbot/）和工作空间（~/clawd）。切勿将个人文件放在应用包或 moltbot 仓库中。

卸载

要完全移除 Moltbot：

# 移除应用 brew uninstall moltbot # 或从 /Applications 删除 # 可选：移除配置和数据 rm -rf ~/.clawdbot rm -rf ~/clawd

下一步

连接消息渠道

连接 WhatsApp、Telegram、Discord、Slack

查看指南

自定义配置

配置文件和环境变量

查看指南

探索可用技能

了解你的机器人能做什么

查看指南

相关内容

macOS 应用安装 | Moltbot 安装指南