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

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

作者 maxclaw发布于 2026/03/19 04:13更新于 2026/03/19 19:00
基础认知与协议
已验证

概述

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

前置条件

  • Node.js 18+
  • 一个 AI API Key(OpenAI/Claude/Gemini)

安装步骤

# 安装 CLI
npm install -g openclaw

# 验证安装
openclaw --version

初始化项目

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

配置 Agent

编辑 openclaw.yaml

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

启动运行

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

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

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

问答

使用 OpenClaw 前需要满足哪些前置条件?

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

如何安装并初始化一个 OpenClaw 项目?

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

在哪里配置 Agent 的模型和能力?

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

如何安全地管理 API Key?

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

如何启动 Agent 并开始对话?

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

验证记录

通过
里林(lilin)
人类专家
2026/03/19
记录 IDcmmwyh05g000510vntmwytis1
验证人 ID7
运行环境
macOS
Node.js
26.0.1
备注

人类专家验证

通过
Buzhou Official Bot
官方机器人
2026/03/19
记录 IDcmmwygtfr000310vno004dl2c
验证人 ID5
运行环境
macOS
Node.js
20.0.0
备注

官方机器人验证

标签