⚙️ 高级配置

基础配置玩腻了？来搞点高级的

🎯 什么时候需要高级配置？

• 你想让工作消息和个人消息用不同的 AI 助手
• 你需要在公司访问家里的 OpenClaw
• 你担心 Anthropic 挂了，想准备备用方案
• 你想精细控制会话保存和上下文长度

💡 配置文件位置：~/.openclaw/openclaw.json
📝 修改后重启生效：openclaw gateway restart

🔧 配置项详解

🦞 Gateway 配置

控制网关的端口、绑定地址、认证方式

gateway.port 默认: 18789

Gateway 监听的端口号

💡 本地开发可以不改，服务器部署建议改个不常用的端口

gateway.bind 默认: loopback

绑定地址，loopback 表示只允许本地访问

💡 远程访问要改成 '0.0.0.0'，但一定要配合认证！

gateway.auth.mode 默认: token

认证模式：token、password、disabled

💡 生产环境绝对不要用 disabled！

🤖 Agent 配置

配置 AI 模型、回退策略、上下文长度

agents.defaults.model.provider 默认: anthropic

默认模型提供商

💡 推荐 anthropic，claude opus 最聪明

agents.defaults.model.model 默认: claude-opus-4

具体模型名称

💡 opus 最强，sonnet 性价比高，haiku 最快

agents.defaults.model.fallbacks 默认: []

模型故障时的备用模型列表

💡 建议配置至少一个备用，避免服务中断

💾 Session 配置

管理会话的保存、清理、上下文限制

sessions.maxHistory 默认: 100

单个会话最大保存多少条消息

💡 太大消耗 token，太小失去上下文

sessions.autoPrune 默认: true

是否自动清理旧会话

💡 开启后能省内存，但要小心重要记录被删

sessions.contextWindow 默认: 200000

模型上下文窗口大小（token）

💡 根据你的模型实际能力设置

🚀 高级功能

🎯

多代理路由

不同的消息路由给不同的 AI Agent 处理

适用场景：

工作消息用工作 Agent，私人消息用私人 Agent

配置示例：

{
  "routing": {
    "rules": [
      {
        "from": ["+86138xxxxxxxx"],
        "agent": "personal"
      },
      {
        "from": ["work-group-id"],
        "agent": "work"
      }
    ]
  }
}

🌐

远程访问

通过 Tailscale 或 SSH 隧道远程连接 Gateway

适用场景：

在公司访问家里的 OpenClaw，或把 Gateway 放云服务器

配置示例：

{
  "gateway": {
    "tailscale": {
      "mode": "serve",
      "hostname": "my-openclaw"
    }
  }
}

🔄

模型故障转移

主模型挂了自动切换到备用模型

适用场景：

确保服务高可用， anthropic 挂了切 openai

配置示例：

{
  "agents": {
    "defaults": {
      "model": {
        "provider": "anthropic",
        "model": "claude-opus-4",
        "fallbacks": [
          { "provider": "openai", "model": "gpt-4" },
          { "provider": "anthropic", "model": "claude-sonnet-4" }
        ]
      }
    }
  }
}

🌍 环境变量

这些环境变量可以覆盖配置文件中的设置，适合 Docker 或 CI/CD 环境：

变量名	说明	示例
`OPENCLAW_HOME`	OpenClaw 主目录	`~/.openclaw`
`OPENCLAW_STATE_DIR`	状态文件目录	`~/.openclaw/state`
`OPENCLAW_CONFIG_PATH`	配置文件路径	`~/.openclaw/openclaw.json`
`OPENCLAW_LOG_LEVEL`	日志级别	`info \| debug \| error`

📋 完整配置示例

这是一个生产环境可用的完整配置模板，根据你的需求修改：

{
  // Gateway 基础配置
  "gateway": {
    "port": 18789,
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "your-secure-token-here"
    },
    "tailscale": {
      "mode": "off"
    }
  },

  // AI Agent 配置
  "agents": {
    "defaults": {
      "model": {
        "provider": "anthropic",
        "model": "claude-opus-4",
        "temperature": 0.7,
        "maxTokens": 4096,
        "fallbacks": [
          { "provider": "anthropic", "model": "claude-sonnet-4" }
        ]
      },
      "tools": ["browser", "node", "canvas"]
    }
  },

  // 会话管理
  "sessions": {
    "maxHistory": 100,
    "autoPrune": true,
    "contextWindow": 200000
  },

  // 频道配置（简化示例）
  "channels": {
    "telegram": {
      "token": "YOUR_BOT_TOKEN",
      "dmPolicy": "pairing",
      "allowFrom": ["@your_username"]
    }
  }
}

💡 配置技巧

🧪 测试配置

• 修改前备份原配置
• 先用 openclaw doctor 检查
• 小步修改，一次改一处
• 加 --verbose 查看详细日志

🔒 安全第一

• 远程访问必须开认证
• Token 要够长够随机
• 不要在 Git 提交配置
• 定期检查访问日志

←

📱 频道配置

工具与技能 🛠️

→