Clawdbot 概念

Clawdbot 概念概述

理解 Clawdbot 的核心概念有助于您有效地配置和使用 AI 助手。本节涵盖 Clawdbot 的基本构建块。

关键概念

网关架构

网关是中央守护进程，它：

• 维护所有消息提供商连接
• 公开类型化的 WebSocket API
• 管理代理运行时和会话
• 处理消息路由

了解更多关于网关架构

会话

Clawdbot 将每个代理的一个直接聊天会话视为主要会话：

• 直接聊天折叠到 agent:<agentId>:<mainKey>
• 群组/频道聊天有自己的键
• 会话状态由网关拥有

多代理路由

运行多个隔离的代理，具有独立的：

• 工作区（文件、人格规则）
• 状态目录
• 会话存储
• 认证配置文件

代理运行时

代理运行时处理：

• 消息处理
• 工具执行
• 上下文管理
• 响应生成

会话管理

DM 范围选项

会话键

会话生命周期

• 会话被重用直到过期
• 每日重置默认为本地时间凌晨 4:00
• 可选的空闲重置通过 idleMinutes

多代理设置

什么是代理？

代理是一个完全作用域的大脑，具有：

• 工作区：文件、AGENTS.md、SOUL.md、人格规则
• 状态目录：认证配置文件、模型注册表
• 会话存储：聊天历史 + 路由状态
• 技能：通过工作区的 skills/ 文件夹按代理

单代理模式（默认）

• agentId 默认为 main
• 会话键为 agent:main:<mainKey>
• 工作区在 ~/.clawdbot/workspace

添加代理

# 添加新代理
clawdbot agents add work

# 列出带绑定的代理
clawdbot agents list --bindings

路由规则

消息通过绑定路由到代理：

{
  "bindings": [
    {
      "agentId": "alex",
      "match": {
        "channel": "whatsapp",
        "peer": { "kind": "dm", "id": "+15551230001" }
      }
    }
  ]
}

消息处理

流式传输和分块

Clawdbot 支持流式响应：

• 部分消息更新
• 输入指示器
• 长响应的分块投递

重试策略

失败的消息会重试：

• 指数退避
• 可配置的重试限制
• 错误处理

状态存储位置

下一步

• Clawdbot 网关 - 网关配置
• Clawdbot 工具 - 工具配置
• Clawdbot 频道 - 频道设置