Clawdbot无法启动或连接通道的解决步骤为：一、验证Node.js版本≥22并匹配系统架构；二、卸载并重装CLI；三、运行onboard初始化并授予权限；四、配置模型API Key并验证；五、为iMessage通道手动添加Node.js完全磁盘访问权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功安装 Clawdbot 最新版但无法正常启动、配置模型或连接通道，则可能是由于环境依赖缺失、权限未授予或配置文件路径错误所致。以下是解决此问题的步骤：
一、验证并修复 Node.js 环境
Clawdbot 要求 Node.js 版本必须为 22 或更高，且需匹配系统架构（ARM64 对应 M 系列 Mac，x64 对应 Intel Windows）。低版本或转译运行将导致 CLI 命令失败、Gateway 启动卡死或模型加载空白。
1、打开终端（Windows 使用 PowerShell，macOS 使用 Terminal），执行：
node -v
2、若返回版本低于 v22.0.0 或提示 command not found，则需重新安装对应架构的 Node.js：
Windows 用户请从 https://nodejs.org/en 下载 v22.x.x LTS 安装包（x64 或 ARM64）；Mac 用户必须下载 macOS Arm64 Installer，不可使用 Rosetta 转译版
3、安装完成后重启终端，再次运行 node -v 确认输出为 v22.x.x
二、重装 Clawdbot CLI（多方案任选）
当 clawdbot 命令不可用、setup 无响应或 install.ps1/install.sh 报错时，说明核心 CLI 未正确注册到系统 PATH 或存在残留冲突，需彻底清除后重装。
1、卸载现有 CLI：
npm uninstall -g clawdbot
2、清除 npm 全局缓存：
npm cache clean --force
3、执行以下任一安装方式（推荐按顺序尝试）：
方案一（macOS/Linux 一键脚本）：
curl -fsSL https://clawd.bot/install.sh | bash
方案二（Windows PowerShell）：
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
iwr -useb https://molt.bot/install.ps1 | iex
方案三（全平台通用 npm 安装）：
npm install -g clawdbot@latest
三、完成初始化与网关配置
安装成功后必须运行 onboard 流程以生成配置文件、安装后台服务并启用 Gateway，否则所有通道（如 iMessage、Telegram）均无法工作。
1、执行初始化向导：
clawdbot onboard --install-daemon
2、过程中出现系统弹窗时，必须点击「允许」：
“终端想要控制辅助功能”、“完全磁盘访问权限”、“防火墙允许联网”三项均不可跳过或拒绝
3、初始化完成后检查状态：
clawdbot status --all
4、确认输出中 Gateway 显示 running、Agents 至少有一个 active，且 Tokens 消耗值非零
四、模型 API Key 配置与验证
模型未认证会导致 Agent 长期处于 bootstrapping 状态、会话返回空内容或 401/404 错误，必须确保 provider、模型 ID 与 API Key 三者严格匹配。
1、粘贴 MiniMax API Key（适用于国内用户）：
clawdbot models auth paste-token --provider minimax
2、设置默认模型（以 M2.1 为例）：
clawdbot models set minimax/abab6.5s-chat
3、若使用 OpenAI：
clawdbot models auth paste-token --provider openai
clawdbot models set openai/gpt-4o-mini
4、验证配置是否生效：
clawdbot models status
输出中需显示 Provider: minimax（或 openai）、Model: abab6.5s-chat（或 gpt-4o-mini）、Token status: valid
五、iMessage 通道权限专项修复
即使 imsg 工具在终端可正常运行，Gateway 仍报 permissionDenied，根本原因是 LaunchAgent 模式下运行的 Node.js 进程未被授予「完全磁盘访问权限」，需手动添加二进制路径。
1、查找当前 Node.js 可执行文件路径：
which node
2、打开「系统设置 → 隐私与安全性 → 完全磁盘访问权限」
3、点击右下角「+」号，选择该路径下的 node 文件（例如 /opt/homebrew/bin/node 或 /usr/local/bin/node）
4、重启网关：
clawdbot gateway restart
5、验证权限是否生效：
imsg chats --limit 1
若返回一条有效聊天记录（含 guid 和 display_name），即表示权限配置成功
