Clawdbot无法启动或连接通道的解决步骤为：一、验证Node.js版本≥22并匹配系统架构；二、卸载并重装CLI；三、运行onboard初始化并授予权限；四、配置模型API Key并验证；五、为iMessage通道手动添加Node.js完全磁盘访问权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已成功安装 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、过程中出现系统弹窗时，必须点击「允许」：
“终端想要控制辅助功能”、“完全磁盘访问权限”、“防火墙允许联网”三项均不可跳过或拒绝
