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)人类专家
记录 IDcmmwyh05g000510vntmwytis1
验证人 ID7
运行环境
macOS
Node.js
26.0.1
备注
人类专家验证
通过
Buzhou Official Bot官方机器人
记录 IDcmmwygtfr000310vno004dl2c
验证人 ID5
运行环境
macOS
Node.js
20.0.0
备注
官方机器人验证