OpenClaw 安装教程（二）：安装 OpenClaw 与初始化配置

上篇我们已经完成了 Node.js 环境的安装和配置。本篇将正式安装 OpenClaw，并通过 onboard 向导完成初始化配置，包括选择 AI 模型、配置 API Key 和安装后台服务。

👉 如果你还没完成环境准备，先阅读 第一篇：Windows 环境准备与 Node.js 安装

安装 OpenClaw

打开 PowerShell（以管理员身份运行），选择以下任一方式安装：

方法一：PowerShell 一键安装（推荐）

iwr -useb https://openclaw.ai/install.ps1 | iex

这行命令会从 OpenClaw 官网下载安装脚本并自动执行，是最快的安装方式。

方法二：npm 全局安装

npm install -g openclaw@latest

如果你更习惯 npm 方式，也可以用这个命令安装。两种方式效果相同。

验证安装

安装完成后，打开一个新的 PowerShell 窗口，输入：

openclaw --version

如果显示版本号，说明安装成功！

运行 onboard 初始化向导

首次安装后，需要运行初始化向导来完成配置。在 PowerShell 中执行：

openclaw onboard --install-daemon

--install-daemon 参数表示同时安装 Gateway 后台服务。

向导会依次引导你完成以下配置步骤：

步骤 1：欢迎界面

显示 OpenClaw 的 logo 和欢迎信息。按 Enter 继续。

步骤 2：选择 AI 模型提供商

onboard 会列出支持的模型提供商供你选择：

• Anthropic — Claude 系列模型（推荐，推理能力强）
• OpenAI — GPT-4o / GPT-4 系列模型
• Google — Gemini 系列模型
• 其他 — 支持兼容 OpenAI API 的第三方服务

使用上下箭头选择，按 Enter 确认。推荐新手选择 Anthropic，Claude 模型在代码编写和工具调用方面表现优秀。

步骤 3：配置 API Key

选择模型提供商后，向导会提示你输入对应的 API Key。

获取 API Key 的方法：

• Anthropic：访问 console.anthropic.com → API Keys → Create Key
• OpenAI：访问 platform.openai.com/api-keys → Create new secret key
• Google：访问 aistudio.google.com/apikey → Create API Key

将你的 API Key 粘贴到向导中（输入时不会显示字符，这是正常的安全设计），然后按 Enter。

步骤 4：选择默认模型

向导会列出该提供商下可用的模型，选择一个作为默认模型。推荐：

• Anthropic：选择 Claude Sonnet（性价比最高）
• OpenAI：选择 GPT-4o（速度快、能力强）
• Google：选择 Gemini 2.0 Flash

步骤 5：安装 Gateway 后台服务

如果启动时带了 --install-daemon 参数，向导会自动将 OpenClaw Gateway 安装为系统服务。Gateway 是 OpenClaw 的核心后台进程，负责：

• 与 AI 模型 API 通信
• 管理聊天频道的消息收发
• 执行工具调用（文件读写、日历操作等）
• 运行定时任务和自动化流程

安装过程中可能会提示需要管理员权限，按 Y 确认即可。

验证安装结果

安装完成后，让我们验证一切是否正常：

1. 检查 Gateway 状态

openclaw gateway status

应该显示 running 或类似 "Gateway is running" 的信息。

2. 检查配置文件

OpenClaw 的配置文件存储在用户目录下：

# 查看配置目录
ls ~/.openclaw-autoclaw

你应该能看到 config.yaml、workspace 等目录结构。

3. 手动测试对话

openclaw chat

这会进入交互式聊天模式，你可以直接在终端与 AI 对话。试着输入 "你好" 测试一下。

常见问题

Q: 安装时报错 "EACCES: permission denied"？

这是 npm 全局安装目录权限问题。尝试以管理员身份运行 PowerShell，或者参考第一篇中的 npm 全局路径配置部分。

Q: onboard 过程中网络连接超时？

如果你在中国大陆，可能需要配置代理才能访问 Anthropic / OpenAI 的 API。确保你的网络能正常访问这些服务。

Q: API Key 验证失败？

请检查 API Key 是否正确复制（没有多余空格），以及账户是否有足够余额。可以在对应平台的后台查看 Key 状态和使用量。

Q: Gateway 无法启动？

查看日志：openclaw gateway logs，根据错误信息排查。常见原因包括端口被占用、Node.js 版本过低等。

下一篇预告

到这一步，OpenClaw 已经安装并运行在你的电脑上了！下一篇我们将完成最后一步——连接聊天频道，让你可以通过飞书、Telegram 等平台与 AI 助手对话。

• 打开浏览器控制面板
• 连接飞书机器人
• 连接 Telegram Bot
• 发送第一条消息测试
• 常用命令和排错技巧

👉 继续阅读：OpenClaw 安装教程（三）：连接频道与开始使用