OpenClaw 安装教程：从零到运行

上一篇介绍了 OpenClaw 是什么，这篇我们来动手安装，从零开始让你的 AI 助手跑起来。

整个安装过程大约 5 分钟，完成后你就可以通过浏览器和 AI 助手聊天了。

准备工作

在开始之前，确保你的系统满足以下要求：

• Node.js 22+ — OpenClaw 需要较新的 Node 版本
• 一个 AI 模型的 API Key — 可以是 OpenAI、Anthropic、智谱 AI（GLM）、月之暗面（Kimi）等
• 终端/命令行 — 用于执行安装命令

检查 Node 版本：

node --version
# 应该显示 v22.x.x 或更高

如果没有安装 Node.js，推荐使用 Node.js 官网下载 LTS 版本，或使用 nvm 管理：

# 使用 nvm 安装 Node 22
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

安装 OpenClaw

方式一：一键安装脚本（推荐）

macOS / Linux：

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

Windows PowerShell：

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

这个脚本会自动：

• 检测你的系统
• 安装 Node.js（如果没有）
• 安装 OpenClaw CLI

方式二：npm 全局安装

如果你已经有 Node.js 22+，可以直接用 npm 安装：

npm install -g openclaw@latest

验证安装：

openclaw --version

运行配置向导

安装完成后，运行配置向导：

openclaw onboard --install-daemon

向导会引导你完成：

1. 选择 AI 模型 — 输入你的 API Key，选择默认模型
2. 配置 Gateway — 设置端口（默认 18789）
3. 安装系统服务 — 让 OpenClaw 在后台持续运行

支持的模型提供商

OpenClaw 支持多种 AI 模型：

• OpenAI — GPT-4o、GPT-4、GPT-3.5
• Anthropic — Claude 3.5 Sonnet、Claude 3 Opus
• 智谱 AI — GLM-4（国内用户推荐）
• 月之暗面 — Kimi
• Ollama — 本地运行的开源模型（如 Qwen、Llama）
• 其他 — 支持 OpenAI 兼容 API 的服务商

启动 Gateway

如果安装了系统服务，Gateway 应该已经在运行了。检查状态：

openclaw gateway status

如果需要手动启动：

openclaw gateway --port 18789

打开控制面板

Gateway 运行后，打开浏览器访问：

http://127.0.0.1:18789/

或者用命令打开：

openclaw dashboard

你会在浏览器中看到 OpenClaw 的 Web UI，可以直接和 AI 助手聊天了！

配置文件位置

OpenClaw 的配置文件位于：

~/.openclaw/openclaw.json

你可以手动编辑这个文件来修改配置，比如添加渠道、调整模型参数等。

常用命令速查

命令	说明
openclaw --version	查看版本
openclaw onboard	运行配置向导
openclaw gateway status	检查 Gateway 状态
openclaw gateway --port 18789	启动 Gateway
openclaw dashboard	打开 Web UI
openclaw channels login	登录渠道（如 WhatsApp）
openclaw --help	查看帮助

下一步

现在你的 OpenClaw 已经可以用了！接下来可以：

• 📱 接入飞书 — 在飞书里和 AI 助手聊天
• 💬 接入 Telegram — 用 Telegram 随时随地访问
• 🔧 配置详解 — 了解 openclaw.json 的所有选项

常见问题

Gateway 启动失败？

1. 检查端口是否被占用：lsof -i :18789
2. 检查 Node 版本是否 >= 22
3. 查看日志：journalctl --user -u openclaw-gateway

API Key 无效？

1. 确认 API Key 没有多余空格
2. 检查 API Key 是否有余额
3. 如果使用代理，确保代理正常工作

如何更新 OpenClaw？

npm update -g openclaw@latest

---

安装完成！🎉 下一篇我们会详细介绍 OpenClaw 配置文件，让你完全掌控你的 AI 助手。