大模型系列——OpenClaw 小龙虾核心配置与功能详解#

1
├── config/
2
│   ├── openclaw.yaml          # 主配置文件
3
│   ├── models.yaml           # 模型配置
4
│   ├── database.yaml         # 数据库配置
5
│   └── api.yaml              # API 配置
6
├── .env                      # 环境变量
7
└── docker-compose.yml        # Docker 编排配置

1
# ============================================================================
2
# OpenClaw 小龙虾主配置文件
3
# ============================================================================
4
# 版本: 1.0.0
5
# 更新时间: 2025-11-10
6
# ============================================================================
7

8
# 服务器配置
9
server:
10
  # 服务监听地址
11
  host: "0.0.0.0"
12

13
  # 服务端口
14
  port: 8080
15

16
  # 调试模式 (生产环境请设为 false)
17
  debug: false
18

19
  # 工作进程数 (建议设置为 CPU 核心数)
20
  workers: 4
21

22
  # 超时配置
23
  timeout:
24
    # 请求超时时间 (秒)
25
    request: 300
26
    # 响应超时时间 (秒)
27
    response: 600
28

29
  # 连接池配置
30
  connection_pool:
31
    # 最大连接数
32
    max_connections: 1000
33
    # 初始连接数
34
    min_connections: 10
35
    # 连接超时 (秒)
36
    connection_timeout: 10
37
    # 连接最大生命周期 (秒)
38
    max_lifetime: 3600
39

40
# 数据库配置
41
database:
42
  # 数据库类型: postgres, mysql, sqlite
43
  type: "postgres"
44

45
  # 主数据库配置
46
  primary:
47
    host: "${POSTGRES_HOST:postgres}"
48
    port: "${POSTGRES_PORT:5432}"
49
    database: "${POSTGRES_DB:openclaw}"
50
    user: "${POSTGRES_USER:openclaw}"
51
    password: "${POSTGRES_PASSWORD}"
52

53
  # 连接池配置
54
  pool:
55
    # 连接池大小
56
    size: 20
57
    # 最大溢出连接数
58
    max_overflow: 10
59
    # 连接超时 (秒)
60
    timeout: 30
61
    # 回收空闲连接间隔 (秒)
62
    recycle: 3600
63

64
  # 查询优化
65
  query:
66
    # 查询超时 (秒)
67
    timeout: 30
68
    # 批量查询大小
69
    batch_size: 100
70
    # 启用查询缓存
71
    cache_enabled: true
72
    # 查询缓存时间 (秒)
73
    cache_ttl: 600
74

75
# Redis 配置
76
redis:
77
  # Redis 服务器配置
78
  host: "${REDIS_HOST:redis}"
79
  port: "${REDIS_PORT:6379}"
80
  password: "${REDIS_PASSWORD}"
81
  db: 0
82

83
  # 连接池配置
84
  pool:
85
    # 最大连接数
86
    max_connections: 50
87
    # 连接超时 (秒)
88
    socket_timeout: 5
89
    # 连接超时 (秒)
90
    socket_connect_timeout: 5
91

92
  # 缓存配置
93
  cache:
94
    # 默认缓存时间 (秒)
95
    default_ttl: 3600
96
    # 最大缓存条目数
97
    max_entries: 10000
98
    # 缓存清理策略: lru, lfu, random
99
    eviction_policy: "lru"
100

101
# 模型配置
102
models:
103
  # 默认模型
104
  default_model: "gpt-3.5-turbo"
105

106
  # 可用模型列表
107
  available_models:
108
    # GPT-3.5 Turbo
109
    - name: "gpt-3.5-turbo"
110
      provider: "openai"
111
      api_key: "${OPENAI_API_KEY}"
112
      max_tokens: 4096
113
      temperature: 0.7
114
      top_p: 1.0
115
      frequency_penalty: 0.0
116
      presence_penalty: 0.0
117

118
    # GPT-4
119
    - name: "gpt-4"
120
      provider: "openai"
121
      api_key: "${OPENAI_API_KEY}"
122
      max_tokens: 8192
123
      temperature: 0.7
124
      top_p: 1.0
125
      frequency_penalty: 0.0
126
      presence_penalty: 0.0
127

128
    # Claude 3
129
    - name: "claude-3-opus"
130
      provider: "anthropic"
131
      api_key: "${ANTHROPIC_API_KEY}"
132
      max_tokens: 4096
133
      temperature: 0.7
134
      top_p: 1.0
135

136
  # 模型缓存配置
137
  cache:
138
    # 启用缓存
139
    enabled: true
140
    # 缓存大小
141
    size: 1000
142
    # 缓存过期时间 (秒)
143
    ttl: 3600
144
    # 缓存策略: memory, disk
145
    strategy: "memory"
146

147
  # 模型加载配置
148
  loading:
149
    # 预加载模型
150
    preload: ["gpt-3.5-turbo"]
151
    # 模型加载超时 (秒)
152
    timeout: 60
153
    # 并行加载数量
154
    parallel_loads: 3
155

156
# API 配置
157
api:
158
  # 速率限制
159
  rate_limit:
160
    # 启用速率限制
161
    enabled: true
162
    # 每分钟请求数
163
    requests_per_minute: 60
164
    # 每小时请求数
165
    requests_per_hour: 1000
166
    # 每天请求数
167
    requests_per_day: 10000
168

169
  # CORS 配置
170
  cors:
171
    enabled: true
172
    allowed_origins: ["*"]
173
    allowed_methods: ["GET", "POST", "PUT", "DELETE"]
174
    allowed_headers: ["Content-Type", "Authorization"]
175
    exposed_headers: ["Content-Range"]
176
    max_age: 86400
177

178
  # 身份验证配置
179
  authentication:
180
    enabled: true
181
    secret_key: "${API_SECRET_KEY}"
182
    algorithm: "HS256"
183
    token_expiration: 86400  # 24小时
184

185
  # API 版本管理
186
  versioning:
187
    enabled: true
188
    default_version: "v1"
189
    supported_versions: ["v1", "v2"]
190

191
# 监控配置
192
monitoring:
193
  # 启用监控
194
  enabled: true
195
  # 指标端口
196
  metrics_port: 9090
197
  # 日志配置
198
  log_level: "INFO"
199
  log_file: "/app/logs/openclaw.log"
200
  log_rotation:
201
    enabled: true
202
    max_size: "100MB"
203
    max_backups: 10
204
    max_age: 30
205

206
  # 性能指标
207
  metrics:
208
    # 启用 Prometheus 指标
209
    prometheus_enabled: true
210
    # 采样率 (0.0-1.0)
211
    sample_rate: 1.0
212
    # 统计历史时间 (秒)
213
    stats_history: 600
214

215
# 安全配置
216
security:
217
  # HTTPS 配置
218
  https:
219
    enabled: false
220
    cert_file: "/app/ssl/cert.pem"
221
    key_file: "/app/ssl/key.pem"
222

223
  # API 密钥管理
224
  api_keys:
225
    enabled: true
226
    rotation_interval: 7776000  # 90天
227

228
  # 速率限制保护
229
  ddos_protection:
230
    enabled: true
231
    burst_limit: 100
232
    rate_limit: 10
233

234
  # 输入验证
235
  input_validation:
236
    enabled: true
237
    max_input_length: 100000
238
    max_output_length: 10000
239
    allowed_content_types: ["application/json"]

1
models:
2
  # 负载均衡配置
3
  load_balancer:
4
    enabled: true
5
    strategy: "round_robin"  # round_robin, least_connections, random
6
    health_check:
7
      enabled: true
8
      interval: 60
9
      timeout: 10
10
      failure_threshold: 3
11

12
  # 模型权重配置
13
  model_weights:
14
    "gpt-3.5-turbo": 70  # 70% 流量
15
    "gpt-4": 30          # 30% 流量
16

17
  # 故障转移配置
18
  failover:
19
    enabled: true
20
    max_retries: 3
21
    retry_delay: 5

1
api:
2
  rate_limit:
3
    enabled: true
4

5
    # 分层速率限制
6
    tiers:
7
      free:
8
        requests_per_minute: 10
9
        requests_per_hour: 100
10
        requests_per_day: 1000
11

12
      basic:
13
        requests_per_minute: 60
14
        requests_per_hour: 1000
15
        requests_per_day: 10000
16

17
      pro:
18
        requests_per_minute: 300
19
        requests_per_hour: 5000
20
        requests_per_day: 50000
21

22
    # 智能限流
23
    intelligent_throttling:
24
      enabled: true
25
      threshold: 80  # CPU 使用率超过 80% 时限流
26
      reduction_factor: 0.5  # 限制为原来的 50%

1
api:
2
  authentication:
3
    enabled: true
4
    secret_key: "${API_SECRET_KEY}"
5
    algorithm: "HS256"
6
    token_expiration: 86400
7

8
    # 多因素认证
9
    mfa:
10
      enabled: false
11
      providers: ["totp", "sms"]
12

13
    # OAuth 配置
14
    oauth:
15
      enabled: false
16
      providers:
17
        github:
18
          client_id: "${GITHUB_CLIENT_ID}"
19
          client_secret: "${GITHUB_CLIENT_SECRET}"
20
        google:
21
          client_id: "${GOOGLE_CLIENT_ID}"
22
          client_secret: "${GOOGLE_CLIENT_SECRET}"

1
api:
2
  cors:
3
    enabled: true
4
    # 生产环境不要使用 "*"
5
    allowed_origins:
6
      - "https://yourdomain.com"
7
      - "https://api.yourdomain.com"
8
    allowed_methods:
9
      - "GET"
10
      - "POST"
11
      - "OPTIONS"
12
    allowed_headers:
13
      - "Content-Type"
14
      - "Authorization"
15
      - "X-Requested-With"
16
    exposed_headers:
17
      - "Content-Range"
18
      - "X-Total-Count"
19
    max_age: 86400
20
    allow_credentials: true

1
monitoring:
2
  metrics:
3
    prometheus_enabled: true
4

5
    # 核心指标
6
    core_metrics:
7
      - name: "request_duration_seconds"
8
        type: "histogram"
9
        buckets: [0.1, 0.5, 1, 2, 5, 10]
10

11
      - name: "request_count_total"
12
        type: "counter"
13

14
      - name: "active_connections"
15
        type: "gauge"
16

17
    # 业务指标
18
    business_metrics:
19
      - name: "model_inference_count"
20
        type: "counter"
21

22
      - name: "cache_hit_rate"
23
        type: "gauge"
24

25
      - name: "error_rate"
26
        type: "gauge"

1
monitoring:
2
  log_level: "INFO"  # DEBUG, INFO, WARNING, ERROR
3

4
  # 日志格式
5
  log_format: "json"  # json, text
6

7
  # 日志输出
8
  log_outputs:
9
    - type: "console"
10
      level: "INFO"
11

12
    - type: "file"
13
      path: "/app/logs/openclaw.log"
14
      level: "DEBUG"
15
      rotation:
16
        max_size: "100MB"
17
        max_backups: 10
18
        max_age: 30
19
        compress: true
20

21
  # 结构化日志
22
  structured_logging:
23
    enabled: true
24
    fields:
25
      - "timestamp"
26
      - "level"
27
      - "message"
28
      - "request_id"
29
      - "user_id"
30
      - "duration_ms"

1
server:
2
  # 工作进程配置
3
  workers: 4
4

5
  # 异步任务配置
6
  async_tasks:
7
    enabled: true
8
    max_concurrent_tasks: 100
9
    task_queue_size: 1000
10

11
  # 连接复用
12
  keep_alive:
13
    enabled: true
14
    timeout: 75
15
    max_requests: 1000

1
# 内存限制配置
2
memory:
3
  # 进程内存限制 (MB)
4
  max_process_memory: 2048
5

6
  # 模型缓存内存限制 (MB)
7
  max_model_cache: 1024
8

9
  # 数据库连接池内存限制 (MB)
10
  max_db_pool_memory: 512
11

12
  # Redis 连接池内存限制 (MB)
13
  max_redis_pool_memory: 256

1
# GPU 配置
2
gpu:
3
  enabled: true
4
  device_ids: [0, 1]  # 使用 GPU 0 和 1
5

6
  # 模型 GPU 分配
7
  model_gpu_allocation:
8
    "gpt-3.5-turbo": 0  # 在 GPU 0 上运行
9
    "gpt-4": 1           # 在 GPU 1 上运行
10

11
  # 批处理配置
12
  batch_processing:
13
    enabled: true
14
    batch_size: 8
15
    max_batch_delay: 50  # 毫秒

1
#!/usr/bin/env python3
2
"""OpenClaw 配置文件验证脚本"""
3

4
import yaml
5
import sys
6
from pathlib import Path
7

8
def validate_config(config_file):
9
    """验证配置文件"""
10
    try:
11
        with open(config_file, 'r') as f:
12
            config = yaml.safe_load(f)
13

14
        # 验证必需字段
15
        required_fields = ['server', 'database', 'redis', 'models', 'api']
16
        for field in required_fields:
17
            if field not in config:
18
                print(f"❌ 缺少必需字段: {field}")
19
                return False
20

21
        # 验证端口范围
22
        port = config['server'].get('port')
23
        if not (1 <= port <= 65535):
24
            print(f"❌ 端口配置无效: {port}")
25
            return False
26

27
        # 验证模型配置
28
        models = config['models'].get('available_models', [])
29
        if not models:
30
            print("❌ 没有配置可用模型")
31
            return False
32

33
        print("✅ 配置文件验证通过")
34
        print(f"📊 配置统计:")
35
        print(f"   - 工作进程数: {config['server'].get('workers', 1)}")
36
        print(f"   - 数据库连接池: {config['database']['pool'].get('size', 10)}")
37
        print(f"   - 可用模型数: {len(models)}")
38
        print(f"   - 速率限制: {config['api']['rate_limit'].get('requests_per_minute', 0)}/分钟")
39

40
        return True
41

42
    except Exception as e:
43
        print(f"❌ 配置文件解析错误: {e}")
44
        return False
45

46
if __name__ == "__main__":
47
    config_file = sys.argv[1] if len(sys.argv) > 1 else "config/openclaw.yaml"
48

49
    if not Path(config_file).exists():
50
        print(f"❌ 配置文件不存在: {config_file}")
51
        sys.exit(1)
52

53
    if validate_config(config_file):
54
        sys.exit(0)
55
    else:
56
        sys.exit(1)

1
#!/bin/bash
2
# OpenClaw 性能基准测试
3

4
echo "开始性能测试..."
5

6
# 并发用户数
7
CONCURRENT_USERS=(1 10 50 100)
8

9
# 测试时长 (秒)
10
TEST_DURATION=60
11

12
for users in "${CONCURRENT_USERS[@]}"; do
13
    echo "测试并发用户数: $users"
14

15
    # 使用 Apache Bench 进行压力测试
16
    ab -n $((users * 10)) -c $users -t $TEST_DURATION \
17
       -H "Authorization: Bearer test_token" \
18
       http://localhost:8080/api/v1/chat/completions
19

20
    echo "---"
21
done
22

23
echo "性能测试完成"