openclaw install

OpenClaw 安装与配置指南：
开启智能代理与自动化的第一步

这篇指南详细介绍了 OpenClaw 的两种主流安装方式、初始化流程以及核心操作命令。无论你是想要一键搞定的新手，还是有 Node 开发经验的专业人士，都可以用几行命令开启高效的 AI 自动化之旅。

OpenClaw 安装自动化配置CLI 命令新手指南部署

开始前必须要知道的流程

Script

推荐方案：一键脚本

你可以无需准备任何环境，直接通过一行安全检测脚本全自动安装 OpenClaw。

Package

开发者选装：包管理器

若你本身就有 Node.js ≥ 22.0.0 和 npm/pnpm，通过包管理器全局安装也是一种选择。

Setup

交互式配置向导

安装后通过 onboard 命令可以直接启动向导，按提示一路完成模型、认证和基础配置。

CLI

强大的内置命令

从管理服务到配置智能代理，OpenClaw 自带清晰的 CLI，可以应对不同场景的使用需求。

方案一：一键脚本安装 (推荐)

这是最简单的方式，也是大部分用户的首选。你不需要提前安装任何运行时，因为脚本内部会自动执行 Node 检测并为你提供环境支持。如果你希望通过命令参数自动化执行，也可以在末尾加上不启动向导的配置。

macOS / Linux / WSL2

使用 Bash 脚本

下载 CLI，自动完成全局安装，并直接启动配置向导。

curl -fsSL https://openclaw.ai/install.sh | bash

Windows

使用 PowerShell 脚本

自动检测 Node 环境并安装 CLI。当前的示例参数会跳过向导。

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

方案二前置：环境要求

如果你不想使用前面的一键脚本，而是执意要走“纯前端”模式通过包管理器安装，请务必保证自己系统上的基础环境达标。

必须环境

Node.js≥ 22.0.0
包管理器npm ≥ 10.0.0 (或 pnpm ≥ 8.0.0)

验证当前环境

node --version # 应该显示 v22.x.x 或更高版本
npm --version  # 应该显示 10.x.x 或更高版本

包管理器安装 (针对开发者)

如果你熟悉前端开发环境并且已经准备好了 Node，你可以选择以下任意一种终端方式将 OpenClaw 安装到机器全局。我们推荐使用 npm 或 pnpm。

首选方案

使用 npm 安装

这是 Node.js 默认自带的包管理器，是最简单快速的方式。

npm install -g openclaw@latest

推荐方案

使用 pnpm 安装

如果你经常开发前端项目，强烈推荐 pnpm，速度更快，空间更省。

npm install -g pnpm 
pnpm add -g openclaw@latest

可选方案

使用 bun 安装

如果你的环境中本身就使用 bun，也可以通过 bun 全局安装。

bun install -g openclaw@latest

最后一步

验证是否安装成功

运行以下命令，如果出现对应版本号则说明安装无误。

openclaw --version

快速开始：详细配置三步曲

程序本体就位后，你需要简单配置 AI 模型和通信渠道。以下是跑通整个自动化流程必须经历的关键步骤与详细演示。

前提条件

完成了 OpenClaw 安装（可参考上方一键脚本或包管理器方式）
准备好至少一个 AI 模型的 API Key（如 MiniMax、Kimi、Claude 等）
有一个常用的聊天平台账号（Telegram、Discord、飞书等）

第一步

运行引导向导 (Onboard)

执行这一步将启动交互式配置大厅，它能帮你自动准备好所有环境目录。

启动配置向导

在终端执行以下命令：

启动交互式配置向导
安装守护进程（可选）
创建必要的配置文件和目录

openclaw onboard --install-daemon

1. 选择配置模式

推荐选择 QuickStart，它会引导你完成最基础的配置。

? 选择配置模式:
  ❯ QuickStart - 快速开始（推荐新手）
    Custom - 自定义配置（高级用户）

2. 配置 AI 模型

选择你要使用的 AI 模型供应商。国内用户推荐选择无需翻墙且响应速度强的 MiniMax 或 Kimi。

? 选择 AI 模型供应商:
  ❯ MiniMax M2.5(CN) - 国内可用，中文支持好
    Kimi - 月之暗面，长文本处理强
    DeepSeek - 推理能力强，代码能力出色
    Claude - Anthropic 出品（需国际网络）
    Ollama - 本地模型，完全离线

3. 输入 API Key

根据选择的模型供应商，前往官方控制台申请并粘贴对应的 API Key。

MiniMax：访问平台 api.minimax.chat 申请
Kimi：访问平台 platform.moonshot.cn 申请
DeepSeek：访问平台 platform.deepseek.com 申请

? 输入 API Key: [粘贴你的 API Key]
✓ 正在验证 API Key...
✓ 认证成功！

4. 跳过可选配置

首次配置时，建议跳过渠道和插件的配置，后续可单独设置以免流程冗长。

? 是否现在配置 Channel（渠道）? 
  ❯ 跳过，稍后配置

? 是否现在安装 Skills（技能）?
  ❯ 跳过，稍后安装

5. 打开 Web UI

配置结束后，浏览器会自动打开 OpenClaw 的可视化大盘，日常管理全在这里。

? 是否打开 Web Dashboard?
  ❯ 是

✓ Dashboard 地址: http://127.0.0.1:18789

第二步

连接聊天平台 (Channels)

建议先连接一个常用的外部聊天平台进行交互测试，让你能在手机或桌面随时唤起智能体。

快速接入 Telegram（官方推荐）

Telegram 是最容易配置的终端，极其适合快速体验测试：

在 Telegram 中搜索 @BotFather
发送 /newbot 指令创建新机器人
按提示设置机器人名称和唯一用户名
复制获得的 Bot Token

获得 Token 后回到终端依次执行添加命令：

将终端列表中光标移动至 Telegram 并回车
粘贴刚刚获取的 Token 完成接入！

openclaw channels add

第三步

测试你的第一个对话

验证成果的时候到了，如果一切正常，你的 AI 就会热情地回应你！

方式一：在聊天终端中测试

打开你刚才绑定的聊天平台
找到你的专属智能机器人
发送文本：“你好，OpenClaw！”
如果机器人正常回复，说明配置成功！

方式二：使用原生命令行测试

你也可以不依赖任何通讯软件，直接在当前终端里开始思考对话测试：

openclaw agent --message "你好，请自我介绍一下" --thinking high

日常操作命令

我们为你整理了最常使用的命令行工具，只要熟悉这几条指令，完全足够应付绝大多数日常交互。

服务与管理

# 打开 Web Dashboard
openclaw dashboard

# 查看运行状态或日志
openclaw status
openclaw logs

# 诊断与停止服务
openclaw doctor
openclaw stop

Agent 相关互动

# 测试与助手对话
openclaw agent --message "你好" --thinking high

# 查看或添加新 Agent
openclaw agents list
openclaw agents add <agent-name>

Skill 与环境更新

# 查看和安装新技能
openclaw skills list
npx clawhub@latest install <skill-name>

# 更新 OpenClaw 到最新版本
openclaw update

继续看其他案例

打造专属的个性化 AI 助手

拒绝千篇一律的机械化回复，通过三大核心配置文件为你的 AI 注入有趣的灵魂。

查看案例

接入邮件，让 AI 助手开始处理收件箱

通过 Gmail API 和 OAuth 授权，让 Openclaw 读邮件、筛重点、起草回复。

查看案例

Openclaw X

使用 Bird Skill 复用浏览器登录态，把 Openclaw X 变成发帖、回复、监控提及、阅读帖子串和自动化运营的一体化工作流。

查看案例

Openclaw 订阅配置

把 GPT、Gemini、Claude 的现有订阅接进 Openclaw，让 Openclaw Codex、Openclaw Gemini 和 Openclaw Claude 尽量避开额外 API 计费。

查看案例

Openclaw Skills 入门

了解怎么把重复任务封装成可复用的 Skills，让 AI 按固定步骤、规则和边界稳定执行。

查看案例

Openclaw 浏览器自动化

了解 Openclaw Browser 的两条上手路线：Playwright MCP 和 browser-use，以及它们分别该怎么安装。

查看案例

让 AI 帮你谈价省钱

了解 OpenClaw 如何自己查库存、联系经销商，并跨浏览器、邮件和消息渠道多轮谈价，最终帮用户省下 4200 美元。

查看案例

Openclaw 接管 GitHub 工作流

了解如何让 Openclaw 帮你写代码、提 PR、做 Code Review、整理 Issue 和生成 Changelog，把重复的 GitHub 操作全部交给 AI 自主完成。

查看案例

AI 求职助手：投简历、跟进面试

了解如何用 Openclaw 全网搜集岗位、定制简历求职信、批量发送，并整理收件箱回复，把求职最耗时的重复劳动全部交给 AI。

查看案例

AI 租房助手：找房、比价、谈价一站搞定

了解如何用 Openclaw 全网抓取租房信息、跨平台比价、批量发送询盘，并帮你和房东多轮沟通谈价，把租房最耗时的部分全部交给 AI。

查看案例

方案一：一键脚本安装 (推荐)

macOS / Linux / WSL2

使用 Bash 脚本

下载 CLI，自动完成全局安装，并直接启动配置向导。

curl -fsSL https://openclaw.ai/install.sh | bash

Windows

使用 PowerShell 脚本

自动检测 Node 环境并安装 CLI。当前的示例参数会跳过向导。

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

方案二前置：环境要求

如果你不想使用前面的一键脚本，而是执意要走“纯前端”模式通过包管理器安装，请务必保证自己系统上的基础环境达标。

必须环境

Node.js≥ 22.0.0
包管理器npm ≥ 10.0.0 (或 pnpm ≥ 8.0.0)

验证当前环境

node --version # 应该显示 v22.x.x 或更高版本
npm --version  # 应该显示 10.x.x 或更高版本

包管理器安装 (针对开发者)

如果你熟悉前端开发环境并且已经准备好了 Node，你可以选择以下任意一种终端方式将 OpenClaw 安装到机器全局。我们推荐使用 npm 或 pnpm。

首选方案

使用 npm 安装

这是 Node.js 默认自带的包管理器，是最简单快速的方式。

npm install -g openclaw@latest

推荐方案

使用 pnpm 安装

如果你经常开发前端项目，强烈推荐 pnpm，速度更快，空间更省。

npm install -g pnpm 
pnpm add -g openclaw@latest

可选方案

使用 bun 安装

如果你的环境中本身就使用 bun，也可以通过 bun 全局安装。

bun install -g openclaw@latest

最后一步

验证是否安装成功

运行以下命令，如果出现对应版本号则说明安装无误。

openclaw --version

快速开始：详细配置三步曲

程序本体就位后，你需要简单配置 AI 模型和通信渠道。以下是跑通整个自动化流程必须经历的关键步骤与详细演示。

前提条件

完成了 OpenClaw 安装（可参考上方一键脚本或包管理器方式）
准备好至少一个 AI 模型的 API Key（如 MiniMax、Kimi、Claude 等）
有一个常用的聊天平台账号（Telegram、Discord、飞书等）

第一步

运行引导向导 (Onboard)

执行这一步将启动交互式配置大厅，它能帮你自动准备好所有环境目录。

启动配置向导

在终端执行以下命令：

启动交互式配置向导
安装守护进程（可选）
创建必要的配置文件和目录

openclaw onboard --install-daemon

1. 选择配置模式

推荐选择 QuickStart，它会引导你完成最基础的配置。

? 选择配置模式:
  ❯ QuickStart - 快速开始（推荐新手）
    Custom - 自定义配置（高级用户）

2. 配置 AI 模型

选择你要使用的 AI 模型供应商。国内用户推荐选择无需翻墙且响应速度强的 MiniMax 或 Kimi。

? 选择 AI 模型供应商:
  ❯ MiniMax M2.5(CN) - 国内可用，中文支持好
    Kimi - 月之暗面，长文本处理强
    DeepSeek - 推理能力强，代码能力出色
    Claude - Anthropic 出品（需国际网络）
    Ollama - 本地模型，完全离线

3. 输入 API Key

根据选择的模型供应商，前往官方控制台申请并粘贴对应的 API Key。

MiniMax：访问平台 api.minimax.chat 申请
Kimi：访问平台 platform.moonshot.cn 申请
DeepSeek：访问平台 platform.deepseek.com 申请

? 输入 API Key: [粘贴你的 API Key]
✓ 正在验证 API Key...
✓ 认证成功！

4. 跳过可选配置

首次配置时，建议跳过渠道和插件的配置，后续可单独设置以免流程冗长。

? 是否现在配置 Channel（渠道）? 
  ❯ 跳过，稍后配置

? 是否现在安装 Skills（技能）?
  ❯ 跳过，稍后安装

5. 打开 Web UI

配置结束后，浏览器会自动打开 OpenClaw 的可视化大盘，日常管理全在这里。

? 是否打开 Web Dashboard?
  ❯ 是

✓ Dashboard 地址: http://127.0.0.1:18789

第二步

连接聊天平台 (Channels)

建议先连接一个常用的外部聊天平台进行交互测试，让你能在手机或桌面随时唤起智能体。

快速接入 Telegram（官方推荐）

Telegram 是最容易配置的终端，极其适合快速体验测试：

在 Telegram 中搜索 @BotFather
发送 /newbot 指令创建新机器人
按提示设置机器人名称和唯一用户名
复制获得的 Bot Token

获得 Token 后回到终端依次执行添加命令：

将终端列表中光标移动至 Telegram 并回车
粘贴刚刚获取的 Token 完成接入！

openclaw channels add

第三步

测试你的第一个对话

验证成果的时候到了，如果一切正常，你的 AI 就会热情地回应你！

方式一：在聊天终端中测试

打开你刚才绑定的聊天平台
找到你的专属智能机器人
发送文本：“你好，OpenClaw！”
如果机器人正常回复，说明配置成功！

方式二：使用原生命令行测试

你也可以不依赖任何通讯软件，直接在当前终端里开始思考对话测试：

openclaw agent --message "你好，请自我介绍一下" --thinking high

日常操作命令

我们为你整理了最常使用的命令行工具，只要熟悉这几条指令，完全足够应付绝大多数日常交互。

服务与管理

# 打开 Web Dashboard
openclaw dashboard

# 查看运行状态或日志
openclaw status
openclaw logs

# 诊断与停止服务
openclaw doctor
openclaw stop

Agent 相关互动

# 测试与助手对话
openclaw agent --message "你好" --thinking high

# 查看或添加新 Agent
openclaw agents list
openclaw agents add <agent-name>

Skill 与环境更新

# 查看和安装新技能
openclaw skills list
npx clawhub@latest install <skill-name>

# 更新 OpenClaw 到最新版本
openclaw update

OpenClaw 安装与配置指南：开启智能代理与自动化的第一步

开始前必须要知道的流程

推荐方案：一键脚本

开发者选装：包管理器

交互式配置向导

强大的内置命令

方案一：一键脚本安装 (推荐)

使用 Bash 脚本

使用 PowerShell 脚本

方案二前置：环境要求

必须环境

推荐配置

验证当前环境

包管理器安装 (针对开发者)

使用 npm 安装

使用 pnpm 安装

使用 bun 安装

验证是否安装成功

快速开始：详细配置三步曲

前提条件

运行引导向导 (Onboard)

启动配置向导

1. 选择配置模式

2. 配置 AI 模型

3. 输入 API Key

4. 跳过可选配置

5. 打开 Web UI

连接聊天平台 (Channels)

快速接入 Telegram（官方推荐）

测试你的第一个对话

方式一：在聊天终端中测试

方式二：使用原生命令行测试

日常操作命令

服务与管理

Agent 相关互动

Skill 与环境更新

继续看其他案例

打造专属的个性化 AI 助手

接入邮件，让 AI 助手开始处理收件箱

Openclaw X

Openclaw 订阅配置

Openclaw Skills 入门

Openclaw 浏览器自动化

让 AI 帮你谈价省钱

Openclaw 接管 GitHub 工作流

AI 求职助手：投简历、跟进面试

AI 租房助手：找房、比价、谈价一站搞定

OpenClaw 安装与配置指南：开启智能代理与自动化的第一步

开始前必须要知道的流程

推荐方案：一键脚本

开发者选装：包管理器

交互式配置向导

强大的内置命令

方案一：一键脚本安装 (推荐)

使用 Bash 脚本

使用 PowerShell 脚本

方案二前置：环境要求

必须环境

推荐配置

验证当前环境

包管理器安装 (针对开发者)

使用 npm 安装

使用 pnpm 安装

使用 bun 安装

验证是否安装成功

快速开始：详细配置三步曲

前提条件

运行引导向导 (Onboard)

启动配置向导

1. 选择配置模式

2. 配置 AI 模型

3. 输入 API Key

4. 跳过可选配置

5. 打开 Web UI

连接聊天平台 (Channels)

快速接入 Telegram（官方推荐）

测试你的第一个对话

方式一：在聊天终端中测试

方式二：使用原生命令行测试

日常操作命令

OpenClaw 安装与配置指南：
开启智能代理与自动化的第一步

OpenClaw 安装与配置指南：
开启智能代理与自动化的第一步