配置参考

这一页提供 OpenClaw 所有配置项的完整参考。配置文件默认位于 ~/.openclaw/openclaw.json。

配置文件位置

环境变量

可以通过环境变量覆盖配置：

OPENCLAW_HOME=~/.openclaw
OPENCLAW_STATE_DIR=~/.openclaw/state
OPENCLAW_CONFIG_PATH=~/.openclaw/custom-config.json
OPENCLAW_LOG_LEVEL=info

核心配置

基础设置

{
  "version": "1.0",
  "environment": "development",
  "logLevel": "info",
  "dataDir": "~/.openclaw/data",
  "stateDir": "~/.openclaw/state"
}

Gateway 配置

{
  "gateway": {
    "host": "0.0.0.0",
    "port": 3000,
    "baseUrl": "http://localhost:3000",
    "auth": {
      "enabled": true,
      "type": "token",
      "token": "${GATEWAY_TOKEN}",
      "allowTailscale": true
    },
    "cors": {
      "enabled": true,
      "origins": ["http://localhost:3000"]
    },
    "rateLimit": {
      "enabled": true,
      "maxRequests": 100,
      "windowMs": 60000
    }
  }
}

模型配置

默认模型

{
  "model": {
    "default": "gpt-4",
    "fallback": "gpt-3.5-turbo",
    "timeout": 60000,
    "maxRetries": 3
  }
}

提供商配置

{
  "providers": {
    "openai": {
      "enabled": true,
      "apiKey": "${OPENAI_API_KEY}",
      "models": ["gpt-4", "gpt-3.5-turbo"],
      "baseUrl": "https://api.openai.com/v1"
    },
    "anthropic": {
      "enabled": true,
      "apiKey": "${ANTHROPIC_API_KEY}",
      "models": ["claude-3-opus", "claude-3-sonnet"]
    },
    "local": {
      "enabled": false,
      "baseUrl": "http://localhost:11434",
      "models": ["llama2", "mistral"]
    }
  }
}

模型策略

{
  "modelStrategy": {
    "chat": "gpt-4",
    "summarization": "gpt-3.5-turbo",
    "embedding": "text-embedding-3-small",
    "fallback": {
      "enabled": true,
      "order": ["openai", "anthropic", "local"]
    }
  }
}

Agent 配置

默认 Agent

{
  "agent": {
    "default": {
      "name": "Assistant",
      "model": "gpt-4",
      "systemPrompt": "你是一个有帮助的助手。",
      "temperature": 0.7,
      "maxTokens": 4096,
      "memory": {
        "enabled": true,
        "type": "conversation",
        "maxMessages": 50
      },
      "tools": {
        "enabled": true,
        "requireApproval": ["delete", "send"]
      }
    }
  }
}

Agent 配置项

渠道配置

Web Chat

{
  "channels": {
    "webchat": {
      "enabled": true,
      "port": 3000,
      "path": "/webchat",
      "theme": "default",
      "title": "OpenClaw Chat",
      "welcomeMessage": "你好！有什么可以帮助你的？",
      "features": {
        "markdown": true,
        "codeHighlight": true,
        "fileUpload": false
      }
    }
  }
}

Telegram

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "allowedUsers": [],
      "allowedChats": [],
      "parseMode": "Markdown",
      "disableWebPagePreview": false
    }
  }
}

Discord

{
  "channels": {
    "discord": {
      "enabled": true,
      "botToken": "${DISCORD_BOT_TOKEN}",
      "clientId": "${DISCORD_CLIENT_ID}",
      "guilds": [],
      "intents": ["Guilds", "GuildMessages", "DirectMessages"],
      "prefix": "!"
    }
  }
}

WhatsApp

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "provider": "twilio",
      "accountSid": "${TWILIO_ACCOUNT_SID}",
      "authToken": "${TWILIO_AUTH_TOKEN}",
      "phoneNumber": "${WHATSAPP_PHONE_NUMBER}"
    }
  }
}

飞书

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "${FEISHU_APP_ID}",
      "appSecret": "${FEISHU_APP_SECRET}",
      "encryptKey": "${FEISHU_ENCRYPT_KEY}",
      "verificationToken": "${FEISHU_VERIFICATION_TOKEN}"
    }
  }
}

记忆配置

{
  "memory": {
    "enabled": true,
    "type": "conversation",
    "storage": "sqlite",
    "embedding": {
      "enabled": true,
      "model": "text-embedding-3-small",
      "dimensions": 1536
    },
    "search": {
      "enabled": true,
      "type": "semantic",
      "topK": 5
    },
    "retention": {
      "enabled": true,
      "maxAge": 30,
      "maxMessages": 10000
    }
  }
}

工具配置

{
  "tools": {
    "enabled": true,
    "approvalMode": "selective",
    "requireApproval": ["delete", "send", "execute"],
    "timeout": 30000,
    "maxConcurrent": 5,
    "builtin": {
      "webSearch": {
        "enabled": true,
        "provider": "google"
      },
      "codeExecution": {
        "enabled": true,
        "sandbox": true
      },
      "fileOperations": {
        "enabled": true,
        "allowedPaths": ["~/Documents", "~/Downloads"]
      }
    }
  }
}

技能配置

{
  "skills": {
    "enabled": true,
    "autoUpdate": true,
    "registry": "https://skills.openclaw.ai",
    "installed": [
      "web-search",
      "weather",
      "calculator"
    ],
    "config": {
      "web-search": {
        "provider": "google",
        "apiKey": "${GOOGLE_API_KEY}"
      }
    }
  }
}

安全配置

{
  "security": {
    "encryption": {
      "enabled": true,
      "algorithm": "aes-256-gcm"
    },
    "audit": {
      "enabled": true,
      "logFile": "~/.openclaw/logs/audit.log"
    },
    "rateLimit": {
      "enabled": true,
      "maxRequests": 100,
      "windowMs": 60000
    },
    "contentFilter": {
      "enabled": true,
      "patterns": ["api-key", "password", "secret"]
    }
  }
}

日志配置

{
  "logging": {
    "level": "info",
    "format": "json",
    "outputs": ["console", "file"],
    "file": {
      "path": "~/.openclaw/logs/openclaw.log",
      "maxSize": "10m",
      "maxFiles": 5
    }
  }
}

完整配置示例

{
  "version": "1.0",
  "environment": "production",
  "logLevel": "info",
  
  "gateway": {
    "host": "0.0.0.0",
    "port": 3000,
    "auth": {
      "enabled": true,
      "token": "${GATEWAY_TOKEN}"
    }
  },
  
  "model": {
    "default": "gpt-4",
    "fallback": "gpt-3.5-turbo"
  },
  
  "providers": {
    "openai": {
      "apiKey": "${OPENAI_API_KEY}"
    }
  },
  
  "agent": {
    "default": {
      "model": "gpt-4",
      "memory": {
        "enabled": true
      }
    }
  },
  
  "channels": {
    "webchat": {
      "enabled": true
    },
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}"
    }
  },
  
  "memory": {
    "enabled": true
  },
  
  "tools": {
    "enabled": true
  },
  
  "skills": {
    "enabled": true
  }
}

下一步

• API 参考
• 故障排除
• 安全最佳实践