OpenClaw安装步骤详解：从下载到配置完整指南

安装OpenClaw：

要开始使用OpenClaw，咱们先把环境搭建起来。整个安装过程本身不复杂，但需要留意几个关键步骤，特别是对Windows用户来说，可以避开不少坑。

1. 安装Node.js

第一步通常会被Node.js卡住。如果你打开命令行工具时提示没有安装Node.js，别慌，这是必经之路。

直接访问官方下载地址：https://nodejs.org/en/download/。

找到“Windows installer (.msi)”这个选项，点击下载。下载完成后，直接运行安装包，按照默认指引完成安装就行。这个过程主要是为后续的脚本运行和包管理铺路。

2. 预先安装Git（可选但推荐）

接下来是Git。虽然OpenClaw的安装脚本也能自动帮你装，但那速度有时候实在考验耐心。为了节省时间，不如咱们自己先装好。

打开PowerShell（管理员或普通用户模式都可以，后面会提到区别），输入这条命令：

winget install --id Git.Git -e --source winget

3. 设置PowerShell执行策略

这里有个Windows系统特有的小门槛。出于安全考虑，系统默认禁止运行脚本，这会导致后续的OpenClaw安装指令直接失效。

处理方法很简单，在PowerShell里输入以下命令，放开当前用户的脚本执行权限：

powershell Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

4. 运行OpenClaw安装脚本

准备工作就绪，现在进入正题。请务必以管理员身份打开一个新的PowerShell窗口。这一步很关键，如果不是管理员权限，安装后可能会遇到诸如“找不到Windows计划任务”、“gateway.cmd启动失败”等问题。虽然用openclaw gateway run命令也能前台启动，但openclaw gateway start这种后台服务就无法正常运作。

接着，访问https://openclaw.ai/，获取安装指令。在管理员权限的PowerShell中执行：

powershell -c "irm https://openclaw.ai/install.ps1 | iex"

命令跑完之后，记得重启所有已经打开的PowerShell或CMD窗口。这是为了让系统能正确识别新安装的Node.js环境，避免出现“命令找不到”的尴尬。

安装过程配置指南

脚本运行后，会进入一个交互式配置向导。面对一堆选项可能会有点懵，这里有几个推荐配置帮你快速通过：

配置项	配置内容
I understand this is powerful and inherently risky. Continue	选择 “Yes”
Onboarding mode	选择 “QuickStart”
Model/auth provider	选择 “Skip for now”（后续可以随时配置）
Filter models by provider	选择 “All providers”
Default model	使用默认配置即可
Select channel (QuickStart)	选择 “Skip for now”（同样可以后续配置）
Configure skills now (recommended)	选择 “No”（先装上主程序，技能可以慢慢加）
Enable hooks	按空格键选中 “Skip for now”，然后按回车键进入下一步。
How do you want to hatch your bot	选择 “Hatch in TUI”。

安装过程通常需要3到10分钟，具体时间取决于你的网络速度。如果遇到进度条长时间不动，不妨按一下回车键试试刷新。当你看到终端里出现“Clawdbot installed successfully”这行字时，恭喜，安装大功告成。

日常运维命令

装好之后，日常怎么管理它呢？下面这些命令是你的工具箱：

• openclaw status – 查看运行状态
• openclaw update – 更新OpenClaw
• openclaw doctor – 进行系统检查
• openclaw logs --follow – 实时查看日志
• openclaw gateway start – 在后台启动网关（关闭终端也不影响运行）
• openclaw gateway stop – 关闭网关
• openclaw gateway restart – 重启网关
• openclaw gateway status – 查看网关状态
• openclaw gateway run – 在前台启动网关（方便调试，日志直接输出在终端）
• openclaw dashboard – （临时性）启动带Token的网关面板
• openclaw onboard – 重新运行配置向导
• openclaw models status – 查看模型状态
• openclaw channels add – 添加通讯频道
• openclaw channels list – 查看已配置的频道
• openclaw channels remove feishu – 删除指定频道（以飞书为例）
• openclaw skills list – 查看已安装的技能列表
• openclaw skills install – 安装指定技能
• openclaw skills remove – 卸载指定技能
• openclaw skills disable – 临时禁用某个技能（不卸载）
• openclaw security audit – 运行安全扫描

配置文件详解

配置是发挥OpenClaw能力的关键。以连接千问大模型和飞书为例，我们来拆解一下配置文件里的主要模块。这里有一个Windows上的小提示：系统默认可能不显示文件扩展名，导致你修改了半天config.json文件，实际上却在改一个叫config.json.txt的文件。记得在文件资源管理器的“查看”选项卡里，勾选上“文件扩展名”选项。当然，你如果更喜欢在网页管理界面上操作，那也没问题。

一个典型的配置文件骨架长这样：

{
  "meta": {...},
  "wizard": {...},
  "auth": {...},
  "models": {...},
  "agents": {...},
  "channels": {...},
  "tools": {...},
  "gateway": {...}
}

咱们挑几个核心部分看看：

Meta（元信息）

这部分是系统自动写入的，记录着配置文件最后一次被触碰的版本和时间，主要用于内部维护，一般不需要手动修改。

Wizard（配置向导记录）

同样由系统维护，记录向导运行的历史，非核心功能配置。

Auth（认证配置）

这里存放的是认证相关的配置，注意，它通常不直接包含你的API密钥。

Models（模型配置）

这里是自定义大模型的地方，也是配置的核心之一。

• mode: 通常保持默认的“merge”。
• providers: 定义模型提供商，例如“bailian”（阿里云百炼）。
• baseUrl: 指定模型服务的API地址。
• apiKey: 最关键的部分，填入你从模型提供商处申请到的密钥。
• api: 接口协议规范，例如“openai-completions”，表示遵循OpenAI的接口格式。

Agents（智能体配置）

这里配置所有智能体（Agent）的默认行为，比如默认使用哪个模型。

Channels（频道配置）

配置你的通讯平台，比如飞书。需要填入从对应开放平台获取的App ID和App Secret。

Tools（工具配置）

控制AI可以使用哪些工具，比如是否启用网页搜索（Web Search）功能。

Gateway（网关配置）

配置本地网关的运行参数，比如端口号、鉴权模式等。大部分情况下，系统生成的默认配置就够用了，除非你有特殊的网络或安全需求。