OpenClaw
配置指南6 分钟阅读

OpenClaw 配置文件最小模板：一份「安全可用」的 baseline

包含 Model/Gateway/Channel/Skills 的最小配置示例，附带安全默认值和可直接复制的配置片段。

O

OpenClaw Guides

Tutorial Authors

最小可用配置

以下是一份经过验证的最小配置模板，包含了安全的默认值：

json
// ~/.openclaw/openclaw.json
{
  "model": {
    "provider": "anthropic",
    "default": "claude-3-5-sonnet",
    "apiKey": "${ANTHROPIC_API_KEY}"
  },
  "gateway": {
    "port": 18789,
    "host": "127.0.0.1"
  },
  "channels": [
    { "type": "whatsapp", "enabled": false },
    { "type": "telegram", "enabled": false },
    { "type": "discord", "enabled": false }
  ],
  "security": {
    "rateLimiting": {
      "enabled": true,
      "maxRequests": 100,
      "windowMs": 60000
    }
  }
}

配置说明

Model 配置

json
{
  "model": {
    "provider": "anthropic",
    "default": "claude-3-5-sonnet",
    "apiKey": "${ANTHROPIC_API_KEY}"
  }
}

可用模型：

  • claude-3-5-haiku - 快速、经济（$0.25/1M 输入，$1.25/1M 输出）
  • claude-3-5-sonnet - 性能均衡（$3/1M 输入，$15/1M 输出）
  • claude-sonnet-4 - 最新一代，最佳质量（$3/1M 输入，$15/1M 输出）

Gateway 配置

json
{
  "gateway": {
    "port": 18789,
    "host": "127.0.0.1",
    "timeout": 30000
  }
}

安全提示： 永远不要将 host 设置为 0.0.0.0，除非你已经配置了适当的防火墙规则。

Channel 配置

每个渠道可以独立配置：

json
{
  "channels": [
    {
      "type": "whatsapp",
      "enabled": true,
      "sessionPath": "~/.openclaw/whatsapp-session"
    },
    {
      "type": "telegram",
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}"
    },
    {
      "type": "discord",
      "enabled": true,
      "botToken": "${DISCORD_BOT_TOKEN}",
      "intents": ["GUILDS", "GUILD_MESSAGES", "MESSAGE_CONTENT"]
    }
  ]
}

Security 配置

json
{
  "security": {
    "rateLimiting": {
      "enabled": true,
      "maxRequests": 100,
      "windowMs": 60000
    },
    "quotas": {
      "daily": {
        "enabled": true,
        "maxTokens": 100000
      }
    }
  }
}

环境变量

在 OpenClaw 目录下创建 .env 文件：

bash
# ~/.openclaw/.env
ANTHROPIC_API_KEY=sk-ant-xxxxx
TELEGRAM_BOT_TOKEN=123456:ABC-xxxxx
DISCORD_BOT_TOKEN=xxxxx.xxxxx.xxxxx

验证配置

验证你的配置文件：

bash
openclaw config validate

这会检查：

  • 必填字段
  • API Key 有效性
  • 格式正确性

下一步