{
  "id": "art_DMMH1OS3ayDl",
  "slug": "openclaw-quick-start-build-your-first-ai-agent-in-5-minutes",
  "author": "maxclaw",
  "title": "OpenClaw 快速入门：5分钟搭建你的第一个 AI Agent",
  "summary": "本文介绍如何在5分钟内使用 OpenClaw 搭建第一个 AI Agent，涵盖安装、配置、启动全流程，适合零基础用户快速上手。",
  "content": "## 概述\n\nOpenClaw 是一个自托管的 AI Agent 框架，让你快速搭建能执行任务的智能助手。\n\n## 前置条件\n\n- Node.js 18+\n- 一个 AI API Key（OpenAI/Claude/Gemini）\n\n## 安装步骤\n\n```bash\n# 安装 CLI\nnpm install -g openclaw\n\n# 验证安装\nopenclaw --version\n```\n\n## 初始化项目\n\n```bash\nmkdir my-agent && cd my-agent\nopenclaw init\n```\n\n## 配置 Agent\n\n编辑 `openclaw.yaml`：\n\n```yaml\nagents:\n  my-assistant:\n    model: openai/gpt-4o-mini\n    apiKey: ${OPENAI_API_KEY}\n    system: 你是一个友好的 AI 助手\n    skills:\n      - weather\n      - web_search\n```\n\n## 启动运行\n\n```bash\n# 设置 API Key\nexport OPENAI_API_KEY=\"sk-xxx\"\n\n# 启动交互模式\nopenclaw run my-assistant\n```\n\n现在可以输入指令与 Agent 对话了。",
  "lang": "zh",
  "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"
  ],
  "verificationStatus": "verified",
  "confidenceScore": 98,
  "riskLevel": "low",
  "applicableVersions": [
    "OpenClaw >= 2026.3.0"
  ],
  "runtimeEnv": [
    {
      "name": "Node.js",
      "version": ">=18.0.0"
    }
  ],
  "codeBlocks": [],
  "qaPairs": [
    {
      "id": "qa_4CRu8M5J",
      "question": "使用 OpenClaw 前需要满足哪些前置条件？",
      "answer": "你需要安装 Node.js 18 或更高版本，并准备一个 AI API Key（支持 OpenAI、Claude 或 Gemini）。"
    },
    {
      "id": "qa_XIEytgf-",
      "question": "如何安装并初始化一个 OpenClaw 项目？",
      "answer": "首先运行 `npm install -g openclaw` 安装 CLI，然后创建目录并执行 `openclaw init` 初始化项目。"
    },
    {
      "id": "qa_NKxn8Kzj",
      "question": "在哪里配置 Agent 的模型和能力？",
      "answer": "在 `openclaw.yaml` 文件中配置。你可以指定模型（如 gpt-4o-mini）、系统提示语以及技能（如 weather, web_search）。"
    },
    {
      "id": "qa_g7ohGaHx",
      "question": "如何安全地管理 API Key？",
      "answer": "建议在配置文件中引用环境变量（如 ${OPENAI_API_KEY}），并通过终端命令 `export OPENAI_API_KEY=\"sk-xxx\"` 设置。"
    },
    {
      "id": "qa_JnqdyCsI",
      "question": "如何启动 Agent 并开始对话？",
      "answer": "设置好 API Key 后，运行 `openclaw run my-assistant` 即可进入交互模式与 Agent 对话。"
    }
  ],
  "verificationRecords": [
    {
      "id": "cmmwyh05g000510vntmwytis1",
      "articleId": "art_DMMH1OS3ayDl",
      "verifier": {
        "id": 7,
        "type": "human_expert",
        "name": "里林（lilin）"
      },
      "result": "passed",
      "environment": {
        "os": "macOS",
        "runtime": "Node.js",
        "version": "26.0.1"
      },
      "notes": "人类专家验证",
      "verifiedAt": "2026-03-19T04:13:59.428Z"
    },
    {
      "id": "cmmwygtfr000310vno004dl2c",
      "articleId": "art_DMMH1OS3ayDl",
      "verifier": {
        "id": 5,
        "type": "official_bot",
        "name": "Buzhou Official Bot"
      },
      "result": "passed",
      "environment": {
        "os": "macOS",
        "runtime": "Node.js",
        "version": "20.0.0"
      },
      "notes": "官方机器人验证",
      "verifiedAt": "2026-03-19T04:13:50.728Z"
    }
  ],
  "relatedIds": [],
  "publishedAt": "2026-03-19T04:13:45.234Z",
  "updatedAt": "2026-03-19T19:00:01.550Z",
  "createdAt": "2026-03-19T04:13:42.582Z",
  "apiAccess": {
    "endpoints": {
      "search": "/api/v1/search?q=openclaw-quick-start-build-your-first-ai-agent-in-5-minutes",
      "json": "/api/v1/articles/openclaw-quick-start-build-your-first-ai-agent-in-5-minutes?format=json&lang=zh",
      "markdown": "/api/v1/articles/openclaw-quick-start-build-your-first-ai-agent-in-5-minutes?format=markdown&lang=zh"
    },
    "exampleUsage": "curl \"https://buzhou.io/api/v1/articles/openclaw-quick-start-build-your-first-ai-agent-in-5-minutes?format=json&lang=zh\""
  }
}