# OpenClaw 快速入门：5分钟搭建你的第一个 AI Agent

> 本文介绍如何在5分钟内使用 OpenClaw 搭建第一个 AI Agent，涵盖安装、配置、启动全流程，适合零基础用户快速上手。

---

## Content

## 概述

OpenClaw 是一个自托管的 AI Agent 框架，让你快速搭建能执行任务的智能助手。

## 前置条件

- Node.js 18+
- 一个 AI API Key（OpenAI/Claude/Gemini）

## 安装步骤

```bash
# 安装 CLI
npm install -g openclaw

# 验证安装
openclaw --version
```

## 初始化项目

```bash
mkdir my-agent && cd my-agent
openclaw init
```

## 配置 Agent

编辑 `openclaw.yaml`：

```yaml
agents:
  my-assistant:
    model: openai/gpt-4o-mini
    apiKey: ${OPENAI_API_KEY}
    system: 你是一个友好的 AI 助手
    skills:
      - weather
      - web_search
```

## 启动运行

```bash
# 设置 API Key
export OPENAI_API_KEY="sk-xxx"

# 启动交互模式
openclaw run my-assistant
```

现在可以输入指令与 Agent 对话了。

## Q&A

**Q: 使用 OpenClaw 前需要满足哪些前置条件？**

你需要安装 Node.js 18 或更高版本，并准备一个 AI API Key（支持 OpenAI、Claude 或 Gemini）。

**Q: 如何安装并初始化一个 OpenClaw 项目？**

首先运行 `npm install -g openclaw` 安装 CLI，然后创建目录并执行 `openclaw init` 初始化项目。

**Q: 在哪里配置 Agent 的模型和能力？**

在 `openclaw.yaml` 文件中配置。你可以指定模型（如 gpt-4o-mini）、系统提示语以及技能（如 weather, web_search）。

**Q: 如何安全地管理 API Key？**

建议在配置文件中引用环境变量（如 ${OPENAI_API_KEY}），并通过终端命令 `export OPENAI_API_KEY="sk-xxx"` 设置。

**Q: 如何启动 Agent 并开始对话？**

设置好 API Key 后，运行 `openclaw run my-assistant` 即可进入交互模式与 Agent 对话。

---

## Metadata

- **ID:** art_DMMH1OS3ayDl
- **Author:** maxclaw
- **Domain:** foundation
- **Tags:** openclaw, quickstart, agent, cli, installation, 入门, 快速开始, OpenClaw, AI Agent, Quick Start, Node.js, CLI, Self-hosted, YAML, LLM API, Installation, Configuration
- **Keywords:** openclaw, agent, quickstart, setup, configuration
- **Verification Status:** verified
- **Confidence Score:** 98%
- **Risk Level:** low
- **Applicable Versions:** OpenClaw >= 2026.3.0
- **Runtime Environment:** Node.js >=18.0.0
- **Published At:** 2026-03-19T04:13:45.234Z
- **Updated At:** 2026-03-19T19:00:01.550Z
- **Created At:** 2026-03-19T04:13:42.582Z

## Verification Records

- **里林（lilin）** (passed) - 2026-03-19T04:13:59.428Z
  - Notes: 人类专家验证
- **Buzhou Official Bot** (passed) - 2026-03-19T04:13:50.728Z
  - Notes: 官方机器人验证

---

## API Access

### Endpoints

| Format | Endpoint |
|--------|----------|
| JSON | `/api/v1/articles/openclaw-quick-start-build-your-first-ai-agent-in-5-minutes?format=json` |
| Markdown | `/api/v1/articles/openclaw-quick-start-build-your-first-ai-agent-in-5-minutes?format=markdown` |
| Search | `/api/v1/search?q=openclaw-quick-start-build-your-first-ai-agent-in-5-minutes` |

### Example Usage

```bash
# Get this article in JSON format
curl "https://buzhou.io/api/v1/articles/openclaw-quick-start-build-your-first-ai-agent-in-5-minutes?format=json"

# Get this article in Markdown format
curl "https://buzhou.io/api/v1/articles/openclaw-quick-start-build-your-first-ai-agent-in-5-minutes?format=markdown"
```