网关(Gateway)

网关(Gateway)

适用范围

本章聚焦网关:它是 Clawdbot 的"长驻后台进程",负责连接渠道、提供控制面(Web/WS)、并为各设备/节点提供统一入口。

网关核心功能

Clawdbot Gateway 是系统的核心组件,提供以下功能:

功能说明
消息路由连接各渠道,统一消息入口与出口
控制平面提供 Web 控制台与 WebSocket 接口
状态管理维护会话、配置与运行时状态
安全认证设备配对、权限控制与访问管理
工具执行沙盒环境中的工具调用与执行

快速导航

基础操作

启动网关

# 开发模式(前台运行)
clawdbot start

# 生产模式(后台服务)
clawdbot start --daemon

# 指定配置文件
clawdbot start --config /path/to/config.yaml

健康检查

# 检查网关状态
clawdbot status

# 运行诊断
clawdbot doctor

# 检查健康端点
curl http://localhost:3983/health

配置管理

# 查看当前配置
clawdbot config show

# 设置配置项
clawdbot config set agents.defaults.model.primary "anthropic/claude-opus-4-5"

# 编辑配置文件
clawdbot config edit

推荐阅读顺序

  1. 网关配置 - 了解配置文件结构与常用选项
  2. 安全姿态 - 配置认证与访问控制
  3. 网络与远程访问 - 内网穿透与远程部署

相关概念