AI Agent 概念

了解 OpenClaw AI Agent 概念、Agent 如何工作以及如何配置 Agent 行为。

什么是 AI Agent?

OpenClaw 中的 AI Agent 是一个自主实体,能够接收消息、使用 AI 模型处理消息并通过连接的渠道做出回应。与简单的聊天机器人不同,Agent 支持:

  • 工具调用 — 调用外部 API、运行代码、与服务交互
  • 会话管理 — 按发送者维护隔离的对话上下文
  • 记忆系统 — 跨对话存储和回忆信息
  • 多 Agent 路由 — 根据上下文将消息路由到专门的 Agent

Agent 工作原理

用户消息 → Gateway → 消息路由器 → Agent → AI 模型 → 响应

                                工具 / 记忆
  1. 消息通过渠道(WhatsApp、Telegram 等)到达
  2. Gateway 将其传递给消息路由器
  3. 路由器根据工作区规则选择合适的 Agent
  4. Agent 使用其配置的 AI 模型处理消息
  5. Agent 可能调用工具、访问记忆或路由到子 Agent
  6. 响应通过渠道返回

Agent 配置

Agent 在 ~/.openclaw/openclaw.json 中配置:

{
  "agents": {
    "default": {
      "provider": "openai",
      "model": "gpt-4o",
      "systemPrompt": "You are a helpful assistant.",
      "temperature": 0.7,
      "maxTokens": 4096
    }
  }
}

关键配置选项

选项说明默认值
providerAI 模型提供商(openai、anthropic、ollama 等)openai
model模型名称gpt-4o
systemPromptAgent 行为的系统提示词
temperature响应创造性(0-2)0.7
maxTokens最大响应长度4096

多 Agent 路由

OpenClaw 支持多个 Agent 配合工作区隔离:

{
  "agents": {
    "coder": {
      "provider": "anthropic",
      "model": "claude-sonnet-4-20250514",
      "systemPrompt": "You are an expert programmer."
    },
    "writer": {
      "provider": "openai",
      "model": "gpt-4o",
      "systemPrompt": "You are a creative writer."
    }
  },
  "routing": {
    "default": "coder",
    "rules": [
      {
        "match": "write|story|blog",
        "agent": "writer"
      }
    ]
  }
}

会话

会话按发送者维护对话历史:

  • 私聊 — 同一发送者的多条消息共享一个会话
  • 群聊 — 每个群组有独立的隔离会话
  • 会话重置 — 发送 /reset 或配置自动过期

工具

Agent 可以使用工具与外部系统交互:

  • 文件系统访问
  • 网页浏览
  • API 调用
  • 代码执行
  • 数据库查询

下一步