网关
网关是 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:无认证(不推荐)