加入我们的 Telegram 社群 (clawdbotCN) 学习分享和了解更多 →
网关
概览

网关

网关是 Clawdbot 的核心组件,负责:

  • 连接各种聊天渠道
  • 路由消息到代理
  • 管理会话和状态
  • 提供 HTTP/WebSocket API

核心概念

网关架构

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  WhatsApp   │     │  Telegram   │     │   Discord   │
└──────┬──────┘     └──────┬──────┘     └──────┬──────┘
       │                   │                   │
       └───────────────────┼───────────────────┘

                    ┌──────▼──────┐
                    │   Gateway   │
                    │  (核心引擎)  │
                    └──────┬──────┘

                    ┌──────▼──────┐
                    │    Agent    │
                    │   (AI 代理)  │
                    └─────────────┘

主要功能

  • 消息路由:将来自不同渠道的消息路由到正确的代理
  • 会话管理:维护对话上下文和历史
  • 认证:处理各渠道的认证和令牌
  • 执行控制:管理代理的执行权限

快速启动

# 前台运行
clawdbot gateway --port 18789 --verbose
 
# 作为服务运行
clawdbot gateway start
 
# 检查状态
clawdbot gateway status

配置

网关配置位于 ~/.clawdbot/clawdbot.json

{
  gateway: {
    mode: "local",
    bind: "loopback",
    port: 18789,
    auth: {
      mode: "token",
      token: "your-secret-token"
    }
  }
}

绑定模式

  • loopback:仅本地访问(127.0.0.1)
  • all:所有网络接口

认证模式

  • token:使用令牌认证
  • none:无认证(不推荐)

相关文档