title: OpenCLAW 快速上手：5分钟构建你的第一个 AI Agent tags: [openclaw, 入门, 新手, agent]

OpenCLAW 快速上手：5分钟构建你的第一个 AI Agent

经过前面的介绍，相信你已经对 OpenCLAW 是什么、怎么安装、以及 AI Agent 基础概念有了了解。这篇文章将带你 OpenCLAW 快速上手，手把手构建你的第一个 AI Agent。

准备工作

在开始之前，请确保你已完成以下步骤：

  1. ✅ 已安装 OpenCLAW（参考「OpenCLAW 怎么安装」）
  2. ✅ 已配置好 AI 模型 API
  3. ✅ Gateway 服务已启动
# 检查服务状态
openclaw gateway status

创建你的第一个 Agent

步骤 1：创建项目目录

mkdir my-first-agent
cd my-first-agent

步骤 2：初始化 Agent 配置

openclaw agent init

这会创建一个配置文件 agent.yaml，内容如下：

name: my-agent
description: 我的第一个 AI Agent
model: gpt-4

# Agent 的能力配置
capabilities:
  - web-search
  - file-read
  - file-write

# 系统提示词
system_prompt: |
  你是一个专业的助手，擅长帮助用户解决各种问题。
  请用友好、专业的方式回复用户。

步骤 3：定义 Agent 技能（可选）

你可以为 Agent 添加特定的技能。创建一个 skills 目录：

mkdir skills

创建一个简单的技能文件 skills/hello.yaml：

name: say-hello
description: 向用户问好
action: |
  返回一段友好的问候语，包含当前时间

步骤 4：启动 Agent

openclaw agent start

Agent 启动后，你就可以开始与它交互了。

实战：构建一个天气查询 Agent

让我们通过一个具体例子来深入了解。

1. 创建天气 Agent

openclaw agent create weather-assistant

2. 配置文件

编辑 weather-assistant/config.yaml：

name: weather-assistant
description: 专业的天气查询助手

model: gpt-4

capabilities:
  - web-search
  - http-request

system_prompt: |
  你是一个天气查询助手。
  当用户询问天气时，你需要：
  1. 确认用户想查询的城市
  2. 搜索该城市的天气信息
  3. 以友好的方式回复用户

  如果信息不确定，请明确告知用户。

3. 测试 Agent

# 启动 Agent
openclaw agent start weather-assistant

# 测试交互
openclaw chat --agent weather-assistant

输入：北京今天天气怎么样？

Agent 会自动搜索北京天气并回复你。

构建多 Agent 团队

OpenCLAW 的强大之处在于支持多 Agent 协作。来看看如何构建一个团队：

1. 创建团队配置

# team.yaml
name: content-team
description: 内容创作团队

agents:
  - name: planner
    role: 规划师
    description: 负责分析需求、制定内容计划

  - name: writer
    role: 写手
    description: 负责内容创作

  - name: editor
    role: 编辑
    description: 负责审核和修改内容

2. 配置协作流程

workflow:
  - stage: planning
    agent: planner
    input: 用户的需求描述

  - stage: writing
    agent: writer
    input: planner 的输出

  - stage: editing
    agent: editor
    input: writer 的草稿
    output: 最终内容

3. 启动团队

openclaw team start content-team

现在你有了一个完整的内容创作团队！

常见操作命令

命令 说明
openclaw agent list 查看所有 Agent
openclaw agent start <name> 启动指定 Agent
openclaw agent stop <name> 停止指定 Agent
openclaw agent delete <name> 删除 Agent
openclaw chat 进入交互式对话
openclaw logs 查看运行日志

进阶技巧

1. 使用记忆功能

为 Agent 配置长期记忆：

memory:
  type: file
  path: ./memory
  remember_recent: 10

2. 配置工具链

组合使用多个工具：

tools:
  - name: web-search
    config:
      max_results: 5

  - name: browser
    config:
      headless: true

  - name: file-write
    config:
      base_dir: ./output

3. 设置定时任务

cron:
  - name: daily-report
    schedule: "0 9 * * *"  # 每天早上9点
    action: generate-report

下一步建议

完成 OpenCLAW 快速上手 后，你可以：

  1. 尝试更多技能：探索 OpenCLAW 提供的各种工具
  2. 构建实际应用：将 Agent 用于实际工作场景
  3. 参与社区：与其他开发者交流经验
  4. 学习源码：深入理解 Agent 的工作原理

总结

本文带你完成了 OpenCLAW 快速上手，包括：

  • 创建单个 Agent
  • 配置 Agent 技能
  • 构建多 Agent 团队
  • 常用操作命令

OpenCLAW 让 AI Agent 开发变得简单高效。现在就动手创建你的第一个 Agent 吧！

如果你想了解更多，可以持续关注我们后续的系列教程。