首次使用Clawdbot需先安装Node.js（≥v22.17.0）并验证版本，再选择本地安装或阿里云镜像部署，接着执行moltbot onboard初始化配置，最后运行moltbot start启动服务并通过curl和命令验证功能。

如果您是首次接触 Clawdbot，面对命令行、环境依赖和多平台配置感到无从下手，则很可能是尚未完成基础运行环境搭建或未按正确顺序执行初始化流程。以下是针对新手用户的完整部署与操作路径：

一、确认并安装 Node.js（≥v22.17.0）

Clawdbot 依赖 Node.js 运行时环境，且明确要求版本不低于 v22.17.0。低于该版本将导致安装脚本中断或核心功能异常。

1、访问 https://nodejs.org，官网将自动识别 Windows 系统，点击下载 “Windows Installer (64-bit)”（.msi 文件）。

2、双击安装包，全程点击 “Next”，在 “Custom Setup” 页面务必勾选 Add Node.js to PATH，其余选项保持默认。

3、安装完成后，关闭所有已打开的 PowerShell 或 CMD 窗口，重新以普通权限启动 PowerShell。

4、输入命令 node -v 并回车，确认输出为 v22.x.x 或 v24.x.x；再输入 npm -v 验证配套 npm 是否就绪。

二、选择安装方式并执行部署

Clawdbot 提供两种互不冲突的安装路径：本地终端直装适用于有调试需求的用户；云镜像一键部署则专为零配置经验的新手设计。

1、本地安装（需稳定网络及 GitHub 访问能力）：在 PowerShell 中执行 curl -fsSL https://clawd.bot/install.sh | bash。

2、阿里云轻量应用服务器部署（推荐新手）：访问 https://www.aliyun.com/product/swas，搜索 “Moltbot 官方镜像”，选择配置后点击“立即购买”，5分钟内自动完成系统、Clawdbot、百炼模型通道及钉钉/iMessage 接入的全链路初始化。

3、若执行本地安装时提示 “ExecutionPolicy is Restricted”，需以管理员身份打开 PowerShell，运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 解除脚本限制。

三、完成初始化与通道配置

安装成功后必须执行 onboard 初始化，否则无法加载任何消息通道或技能模块。该步骤将生成 ~/.moltbot/config.yaml 配置文件，并引导完成基础授权。

1、在终端中输入 moltbot onboard（Clawdbot 旧版用户可使用 clawdbot onboard）。

2、当提示 “Do you acknowledge the risks?” 时，键入 Yes 并回车。

3、在 “Onboarding mode” 选项中选择 QuickStart，系统将自动启用默认本地代理与基础工具集。

4、如需接入 iMessage，需提前在 macOS 系统设置中授予终端对 “信息” 和 “文稿与桌面文件夹” 的完全磁盘访问权限，否则 imsg chats --limit 3 将返回权限拒绝错误。

四、启动服务并验证运行状态

Clawdbot 启动后会监听本地端口并加载预设技能，可通过 HTTP 接口或 CLI 命令实时观测其响应能力，无需额外配置 Web UI。

1、在终端中运行 moltbot start，观察日志中是否出现 “Agent initialized” 与 “Listening on http://localhost:3000” 字样。

2、新开一个终端窗口，执行 curl http://localhost:3000/health，返回 JSON 中 “status”: “ok” 即表示服务已就绪。

3、发送第一条测试指令：运行 moltbot run "列出当前目录下的所有 .txt 文件"，检查终端是否准确输出匹配文件列表。