OpenClaw 安装自动化配置CLI 命令新手指南部署
开始前必须要知道的流程
Script
推荐方案:一键脚本
你可以无需准备任何环境,直接通过一行安全检测脚本全自动安装 OpenClaw。
Package
开发者选装:包管理器
若你本身就有 Node.js ≥ 22.0.0 和 npm/pnpm,通过包管理器全局安装也是一种选择。
Setup
交互式配置向导
安装后通过 onboard 命令可以直接启动向导,按提示一路完成模型、认证和基础配置。
CLI
强大的内置命令
从管理服务到配置智能代理,OpenClaw 自带清晰的 CLI,可以应对不同场景的使用需求。
方案一:一键脚本安装 (推荐)
这是最简单的方式,也是大部分用户的首选。你不需要提前安装任何运行时,因为脚本内部会自动执行 Node 检测并为你提供环境支持。如果你希望通过命令参数自动化执行,也可以在末尾加上不启动向导的配置。
macOS / Linux / WSL2
使用 Bash 脚本
下载 CLI,自动完成全局安装,并直接启动配置向导。
Windows
使用 PowerShell 脚本
自动检测 Node 环境并安装 CLI。当前的示例参数会跳过向导。
方案二前置:环境要求
如果你不想使用前面的一键脚本,而是执意要走“纯前端”模式通过包管理器安装,请务必保证自己系统上的基础环境达标。
必须环境
- Node.js≥ 22.0.0
- 包管理器npm ≥ 10.0.0 (或 pnpm ≥ 8.0.0)
推荐配置
- 系统支持Linux、macOS、Windows 10/11
- 硬件推荐至少 8GB 内存与 2GB 可用存储
包管理器安装 (针对开发者)
如果你熟悉前端开发环境并且已经准备好了 Node,你可以选择以下任意一种终端方式将 OpenClaw 安装到机器全局。我们推荐使用 npm 或 pnpm。
首选方案
使用 npm 安装
这是 Node.js 默认自带的包管理器,是最简单快速的方式。
推荐方案
使用 pnpm 安装
如果你经常开发前端项目,强烈推荐 pnpm,速度更快,空间更省。
可选方案
使用 bun 安装
如果你的环境中本身就使用 bun,也可以通过 bun 全局安装。
最后一步
验证是否安装成功
运行以下命令,如果出现对应版本号则说明安装无误。
快速开始:详细配置三步曲
程序本体就位后,你需要简单配置 AI 模型和通信渠道。以下是跑通整个自动化流程必须经历的关键步骤与详细演示。
前提条件
- 完成了 OpenClaw 安装(可参考上方一键脚本或包管理器方式)
- 准备好至少一个 AI 模型的 API Key(如 MiniMax、Kimi、Claude 等)
- 有一个常用的聊天平台账号(Telegram、Discord、飞书等)
第一步
运行引导向导 (Onboard)
执行这一步将启动交互式配置大厅,它能帮你自动准备好所有环境目录。
启动配置向导
在终端执行以下命令:
- 启动交互式配置向导
- 安装守护进程(可选)
- 创建必要的配置文件和目录
1. 选择配置模式
推荐选择 QuickStart,它会引导你完成最基础的配置。
2. 配置 AI 模型
选择你要使用的 AI 模型供应商。国内用户推荐选择无需翻墙且响应速度强的 MiniMax 或 Kimi。
3. 输入 API Key
根据选择的模型供应商,前往官方控制台申请并粘贴对应的 API Key。
- MiniMax:访问平台 api.minimax.chat 申请
- Kimi:访问平台 platform.moonshot.cn 申请
- DeepSeek:访问平台 platform.deepseek.com 申请
4. 跳过可选配置
首次配置时,建议跳过渠道和插件的配置,后续可单独设置以免流程冗长。
5. 打开 Web UI
配置结束后,浏览器会自动打开 OpenClaw 的可视化大盘,日常管理全在这里。
第二步
连接聊天平台 (Channels)
建议先连接一个常用的外部聊天平台进行交互测试,让你能在手机或桌面随时唤起智能体。
快速接入 Telegram(官方推荐)
Telegram 是最容易配置的终端,极其适合快速体验测试:
- 在 Telegram 中搜索 @BotFather
- 发送 /newbot 指令创建新机器人
- 按提示设置机器人名称和唯一用户名
- 复制获得的 Bot Token
获得 Token 后回到终端依次执行添加命令:
- 将终端列表中光标移动至 Telegram 并回车
- 粘贴刚刚获取的 Token 完成接入!
第三步
测试你的第一个对话
验证成果的时候到了,如果一切正常,你的 AI 就会热情地回应你!
方式一:在聊天终端中测试
- 打开你刚才绑定的聊天平台
- 找到你的专属智能机器人
- 发送文本:“你好,OpenClaw!”
- 如果机器人正常回复,说明配置成功!
方式二:使用原生命令行测试
你也可以不依赖任何通讯软件,直接在当前终端里开始思考对话测试:
日常操作命令
我们为你整理了最常使用的命令行工具,只要熟悉这几条指令,完全足够应付绝大多数日常交互。