Agents 代理

概述

Agents 是 ClawdBot 中最强大的功能之一。与简单的问答不同， Agent 可以自主规划和执行多步骤任务，调用各种工具，并在需要时创建子代理 来处理复杂的工作流。

想象一下，你只需要说"帮我分析这个项目的代码质量并生成报告"， Agent 就会自动：分析代码结构、运行静态检查、收集测试覆盖率、生成详细报告。

核心功能

探索 Agents 的各项功能：

工作原理

Agent 执行流程

1. 接收任务 - 用户描述想要完成的目标
2. 规划步骤 - Agent 分析任务，制定执行计划
3. 执行操作 - 按计划调用工具、执行命令
4. 观察结果 - 检查每一步的执行结果
5. 调整计划 - 根据结果调整后续步骤
6. 完成报告 - 汇总结果，报告给用户

工具调用

Agent 可以使用的工具包括：

• Shell - 执行终端命令
• Browser - 浏览和操作网页
• File System - 读写文件
• Skills - 调用已安装的技能
• API - 调用外部 API

安全机制

• 所有操作在沙箱环境中执行
• 危险操作需要用户确认
• 可配置允许/禁止的命令
• 执行时间和资源限制

快速开始

启动 Agent 模式

# 在对话中启动 Agent
/agent 帮我分析当前目录的项目结构

# 或使用命令行
clawdbot agent "整理我的下载文件夹"

简单示例

你: /agent 帮我创建一个 Node.js 项目

Agent: 好的，我来帮你创建一个 Node.js 项目。

[步骤 1/4] 创建项目目录...
✓ 已创建 my-project/

[步骤 2/4] 初始化 package.json...
✓ npm init 完成

[步骤 3/4] 安装基础依赖...
✓ 已安装 express, dotenv

[步骤 4/4] 创建基础文件结构...
✓ 已创建 src/index.js, .gitignore, README.md

项目创建完成！目录结构如下：
my-project/
├── src/
│   └── index.js
├── package.json
├── .gitignore
└── README.md

常用 Agent 命令

使用场景

开发工作流

• 自动化代码审查和修复
• 项目脚手架生成
• 依赖更新和版本管理
• 测试编写和执行

数据处理

• 批量文件处理和转换
• 数据清洗和格式化
• 报告生成和分析
• 日志分析和监控

日常自动化

• 文件整理和归档
• 邮件处理和回复
• 日程安排和提醒
• 信息收集和汇总

研究助手

• 网页信息收集
• 文档摘要生成
• 竞品分析
• 技术调研

配置选项

基本配置

# ~/.clawdbot/config.yaml

agents:
  # 是否启用 Agent 功能
  enabled: true

  # 默认工作目录
  workspace: "~/.clawdbot/workspace"

  # 最大执行步骤
  max_steps: 50

  # 单步超时（秒）
  step_timeout: 300

  # 总任务超时（秒）
  task_timeout: 3600

安全配置

agents:
  security:
    # 沙箱模式
    sandbox: true

    # 需要确认的操作
    require_approval:
      - file_delete
      - system_command
      - network_request

    # 禁止的命令
    blocked_commands:
      - "rm -rf"
      - "sudo"
      - "format"

工具配置

agents:
  tools:
    shell:
      enabled: true
      timeout: 60

    browser:
      enabled: true
      headless: true

    filesystem:
      enabled: true
      allowed_paths:
        - "~/projects"
        - "~/documents"