OpenClaw
新手上手8 分钟阅读

OpenClaw 新手 30 分钟跑通：从 0 到可用

从准备模型 Key 到第一条消息回复，完整覆盖安装、配置、健康检查和常见启动失败的排查方法。

O

OpenClaw Guides

Tutorial Authors

1. 环境准备

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

  • Node.js 22 或更高版本（推荐 LTS 版本）
  • npm 或 pnpm 包管理器
  • 稳定的网络连接

检查 Node.js 版本：

bash
node --version
# 应该输出 v22.x.x 或更高

2. 一键安装

打开终端，运行以下命令：

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

安装脚本会自动检测你的系统环境并完成所有配置。

备选方案：使用 npm

如果你更喜欢直接使用 npm：

bash
# 全局安装 OpenClaw
npm install -g openclaw@latest

# 启动配置向导
openclaw onboard

3. 初始化配置

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

bash
openclaw onboard

配置向导会引导你完成：

  1. API Key 配置 - 输入你的 Anthropic API 密钥
  2. 默认模型选择 - 选择 Claude 3.5 Haiku、Claude 3.5 Sonnet 或 Claude Sonnet 4
  3. 聊天平台连接 - 连接 WhatsApp、Telegram 或 Discord

4. 启动服务

启动 OpenClaw 网关服务：

bash
openclaw gateway start

你应该会看到类似以下的输出：

🦞 OpenClaw Gateway v1.0.0
✓ Model provider connected
✓ Gateway listening on http://127.0.0.1:18789
✓ Ready to receive messages

5. 验证安装

检查服务状态：

bash
openclaw status

如果一切正常，你应该能看到：

Gateway: Running ✓
Model: Connected ✓
Channels: 0 active

故障排查

端口被占用

如果看到 EADDRINUSE 错误：

bash
# 查看是什么进程占用了 3000 端口
lsof -i :18789

# 终止进程或使用其他端口
openclaw gateway start --port 18790

API Key 问题

如果遇到 401 Unauthorized 错误：

bash
# 重新配置 API Key
openclaw config set api-key

下一步