Mac 部署 OpenClaw/Moltbot (Clawdbot) 详细教程

是一个基于 GitHub 项目 Clawdbot (https://github.com/clawdbot/clawdbot) 的 Mac 详细部署教程。Clawdbot 已更名 Moltbot （ https://github.com/moltbot/moltbot ）。

Clawdbot 是一个运行在你本地设备（Local-first）的 AI 智能体（Agent），它通常使用 Anthropic 的 Claude 模型作为“大脑”，并可以连接到 Telegram、Discord、WhatsApp 等聊天软件中与你互动。

针对 macOS，你有两种主要的部署方式：

1. 官方一键脚本（推荐）：最快，自动处理依赖。

2. 源码部署（开发者模式）：如果你想修改代码或体验 GitHub 仓库的最新开发版。

准备工作 (Prerequisites)

无论选择哪种方式，你都需要准备以下东西：

1. Anthropic API Key: 因为 Clawdbot 主要由 Claude 驱动，你需要从 Anthropic Console 获取 API Key。

2. 聊天软件 Token: 推荐使用 Telegram 作为入门，你需要通过 Telegram 的 @BotFather 创建一个机器人并获取 Bot Token。

3. 网络环境: 确保你的终端可以正常访问 GitHub 和 Anthropic 的 API。

方法一：官方一键脚本 (最快上手)

这是目前最简单的在 Mac 上部署 Clawdbot 的方法，它会自动配置 Node.js 环境。

1. 打开终端 (Terminal)。

2. 运行安装脚本：

   Bash

   curl -fsSL https://clawd.bot/install.sh | bash
   

3. 按提示操作：脚本会自动安装 Homebrew (如果没有)、Node.js 22+ 和 Clawdbot CLI 工具。

4. 初始化设置： 安装完成后，直接运行以下命令进入交互式设置向导：

   Bash

   clawdbot onboard
   

   • 向导会询问你的 API Key、Telegram Token 等信息，按提示输入即可。

方法二：通过 GitHub 源码部署 (开发者模式)

既然你贴出了 GitHub 链接，如果你想完全掌控代码或进行二次开发，请使用此方法。

1. 环境依赖安装

Clawdbot 依赖较新的 Node.js 版本（建议 v22+）和 pnpm 包管理器。

• 安装 Node.js (如果你还没装):

  Bash

  # 推荐使用 nvm 安装
  nvm install 22
  nvm use 22
  

• 安装 pnpm:

  Bash

  npm install -g pnpm
  

2. 克隆项目

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

3. 初始化与安装依赖

该项目包含多个子模块（submodules），必须完整初始化。

# 初始化子模块
git submodule update --init --recursive

# 安装项目依赖
pnpm install

4. 构建 macOS 本地应用 (可选但推荐)

Clawdbot 提供了一个 macOS 原生应用外壳，用于更好的系统集成（如语音唤醒等）。

./scripts/package-mac-app.sh

• 注意：这一步需要安装 Xcode 命令行工具。构建完成后，应用会出现在 dist/Clawdbot.app。

5. 启动服务 (Gateway)

在源码目录下，你可以使用开发者模式启动：

pnpm dev

或者构建后运行：

pnpm build
pnpm start

配置与运行 (Configuration & Usage)

无论你是通过脚本还是源码安装，核心都在于配置。

1. 运行配置向导

如果你没有在安装时运行 onboard，可以随时手动运行：

clawdbot onboard

• Identity: 给你的机器人起个名字。

• Model Provider: 选择 Anthropic 并粘贴你的 API Key。

• Chat Interface: 选择 Telegram (或其他)，粘贴 Bot Token。

2. 启动网关

配置完成后，启动 Clawdbot 的核心网关服务：

clawdbot gateway

• 此时，你的终端会显示服务已启动，通常监听在 http://127.0.0.1:18789。

3. 与机器人对话

• 打开你的 Telegram（或你配置的聊天软件）。

• 找到你创建的机器人，发送 /start 或直接说话。

• 配对 (Pairing): 第一次对话时，Clawdbot 可能会要求你进行配对。它会在终端显示一个 配对码 (Pairing Code)，或者你需要运行命令来批准你的账号：

  Bash

  # 在终端运行以批准你的 Telegram 用户 ID (如果机器人没有自动回复)
  clawdbot pairing approve telegram <你的TelegramUserID>
  

进阶提示

• 本地控制台: 服务启动后，浏览器访问 http://127.0.0.1:18789 可以查看 Clawdbot 的 Web 控制台（Dashboard），在里面可以直观地查看日志、调试对话和管理技能。

• 保持后台运行: 如果你想让它像服务器一样一直运行，可以使用 pm2 或者 Mac 的 launchd 服务（官方安装脚本会自动尝试设置 launchd）。

• 关于费用: Clawdbot 本身是开源免费的，但它消耗的是 Anthropic 的 API Token。Claude 3.5 Sonnet 或 Opus 模型虽然聪明，但长期大量对话会有一定的 API 费用，请关注 Anthropic 后台的账单。

如果在运行过程中遇到报错，可以使用 clawdbot doctor 命令来自检环境问题。