Clawdbot 网关配置
Clawdbot AI 助手网关配置完整指南。了解配置选项、环境变量和高级设置。
Clawdbot 网关配置概述
Clawdbot 网关通过 ~/.clawdbot/clawdbot.json 进行配置。本指南涵盖自定义网关的所有配置选项。
配置文件
位置
~/.clawdbot/clawdbot.json基本结构
{
"gateway": {
"port": 3010,
"host": "localhost"
},
"providers": {},
"agents": {},
"tools": {},
"sessions": {}
}网关设置
核心设置
{
"gateway": {
"port": 3010,
"host": "localhost",
"logLevel": "info",
"maxConnections": 100
}
}选项
| 选项 | 默认值 | 描述 |
|---|---|---|
port | 3010 | WebSocket 服务器端口 |
host | localhost | 绑定地址 |
logLevel | info | 日志详细程度 |
maxConnections | 100 | 最大并发连接数 |
提供商配置
{
"providers": {
"whatsapp": {
"enabled": true,
"authStrategy": "qr",
"dmPolicy": "main"
}
}
}Telegram
{
"providers": {
"telegram": {
"enabled": true,
"token": "${TELEGRAM_BOT_TOKEN}"
}
}
}Discord
{
"providers": {
"discord": {
"enabled": true,
"token": "${DISCORD_BOT_TOKEN}",
"intents": ["GUILDS", "GUILD_MESSAGES", "DIRECT_MESSAGES"]
}
}
}代理配置
单代理
{
"agents": {
"main": {
"workspace": "~/.clawdbot/workspace",
"model": "claude-3-sonnet"
}
}
}多代理
{
"agents": {
"main": {
"workspace": "~/.clawdbot/agents/main/workspace"
},
"work": {
"workspace": "~/.clawdbot/agents/work/workspace"
}
}
}会话配置
会话策略
{
"sessions": {
"dmScope": "main",
"resetTime": "04:00",
"idleMinutes": 60,
"maxHistory": 100
}
}会话选项
| 选项 | 默认值 | 描述 |
|---|---|---|
dmScope | main | DM 会话范围 |
resetTime | 04:00 | 每日重置时间 |
idleMinutes | null | 空闲超时 |
maxHistory | 100 | 历史消息最大数 |
工具配置
工具策略
{
"tools": {
"profile": "full",
"allow": ["*"],
"deny": ["browser"]
}
}提供商特定工具
{
"tools": {
"byProvider": {
"whatsapp": {
"deny": ["exec"]
}
}
}
}环境变量
使用环境变量
{
"providers": {
"telegram": {
"token": "${TELEGRAM_BOT_TOKEN}"
}
}
}常用变量
| 变量 | 描述 |
|---|---|
CLAWDBOT_CONFIG | 配置文件路径 |
CLAWDBOT_LOG_LEVEL | 日志级别覆盖 |
CLAWDBOT_PORT | 端口覆盖 |
CLI 配置
覆盖配置
clawdbot gateway start --port 3011 --log-level debug配置命令
# 查看当前配置
clawdbot config get
# 设置配置值
clawdbot config set gateway.port 3011
# 重置为默认值
clawdbot config reset高级设置
性能
{
"gateway": {
"messageBuffer": 1000,
"processTimeout": 30000,
"streamChunkSize": 50
}
}限制
{
"limits": {
"maxMessageLength": 10000,
"maxConcurrentRequests": 10,
"rateLimitPerMinute": 60
}
}下一步
- Clawdbot 安全 - 安全配置
- Clawdbot 故障排除 - 调试问题
- Clawdbot 网关 - 网关概述