macOS部署Moltbot需五步：一、安装Node.js 22+；二、用脚本或npm安装CLI工具；三、为终端授予完全磁盘访问和信息权限；四、运行moltbot onboard初始化；五、用status和logs验证服务状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您准备在 macOS 系统上部署 Clawdbot（现名 Moltbot），但遇到依赖缺失、权限异常或配置中断等问题，则很可能是由于系统环境未对齐官方要求所致。以下是针对 Mac 平台的完整安装流程：
一、确认并安装 Node.js 22+
Clawdbot CLI 依赖 Node.js 运行时，且明确要求版本不低于 22；低于该版本将触发语法错误或模块加载失败。必须使用 LTS 或更高版本以确保所有内置 API（如 fetch、WebCrypto）可用。
1、访问 https://nodejs.org 官网，下载并安装 “Node.js 22.x” 或更新的 macOS 安装包（.pkg 格式）。
2、打开终端，执行 node -v 与 npm -v，确认输出版本号均 ≥22。
3、若已安装旧版，需先通过 brew uninstall node 清理残留，再重新安装新版。
二、安装核心 CLI 工具
Moltbot 提供两种官方安装方式：脚本式一键安装与 npm 全局安装。二者均可生成可执行命令 moltbot，但脚本方式自动处理路径与权限，更适合新手。
1、在终端中粘贴并运行脚本安装命令：curl -fsSL https://molt.bot/install.sh | bash。
2、若提示 command not found: moltbot，请重启终端或执行 source ~/.zshrc 刷新 shell 配置。
3、验证安装成功：输入 moltbot --version，应返回类似 moltbot v2026.1.25 的版本信息。
三、授予终端必要系统权限
Clawdbot 在 Mac 上需读取 iMessage 数据库（chat.db）、访问文稿文件夹以执行文件操作，这些行为受 macOS 隐私保护机制拦截。未授权将导致通道初始化失败或技能无响应。
1、前往「系统设置 → 隐私与安全性 → 完全磁盘访问」，点击锁图标解锁，将 Terminal 或 iTerm2 拖入列表。
2、在同一设置页下滑至「信息」权限项，勾选已添加的终端应用。
3、若使用 VS Code 内置终端，须单独为其开启「完全磁盘访问」及「信息」权限，不可复用 Terminal 授权。
四、运行初始化向导
onboard 命令会引导完成模型配置、通道绑定与风险确认，是启动服务前的强制步骤。跳过将导致后续无法连接 AI 后端或启用任何聊天通道。
1、在终端中执行：moltbot onboard --install-daemon。
2、当提示「Do you acknowledge the risks?」时，输入 Yes 并回车。
3、选择 QuickStart 模式，随后按提示粘贴您的模型 API Key（如 MiniMax、Zhipu、Claude 等）。
4、通道配置阶段，如暂不接入 iMessage 或 WhatsApp，可直接按回车跳过，向导仍将生成基础配置文件 ~/.moltbot/config.yaml。
五、验证服务状态与日志
守护进程（daemon）模式下，Moltbot 作为后台服务持续运行。仅靠命令返回成功不代表服务已就绪，必须检查实际进程与日志输出以确认健康状态。
1、执行 moltbot status，确认输出中包含 active (running) 状态标识。
2、查看实时日志流：moltbot logs -f，等待出现 Gateway started on http://127.0.0.1:3000 类似行。
3、若日志中反复出现 Failed to load skill 或 No model provider configured，说明 API Key 未正确写入配置或网络无法连通目标模型服务。
