跳转到内容
最近更新

OpenClaw 高级配置详解

这篇指南面向已经完成基础安装的用户，重点解释更安全的路由、网关保护、技能安装和 browser relay 相关能力。

配置文件与推荐工作流

常见配置路径：

  • ~/.openclaw/openclaw.json
  • ~/.openclaw/.env

推荐流程：

  1. 优先使用 CLI 修改配置
  2. 用 openclaw config get 检查结果
  3. 重启 gateway
  4. 发送测试消息验证
Command
openclaw config set key.value "value"openclaw config get || trueopenclaw gateway restart || openclaw restart

路由与模型控制

当你需要这些能力时，应进入高级配置：

  • 主模型与 fallback 模型
  • 提供商级路由
  • 更严格的通道控制
  • 面向不同任务的策略限制

常见目标：

  • 日常任务使用更便宜的模型
  • 复杂任务使用更强模型
  • 当主提供商失败时自动切到 fallback

网关令牌与安全访问

gateway token 用于保护网关或相关控制入口，应该被当作 API Key 一样对待。

示意结构：

JSON
{  "gateway": {    "bind": "127.0.0.1",    "port": 18789,    "token": "REDACTED_TOKEN"  }}

最佳实践：

  • 尽量只绑定 localhost
  • token 放在 .env 或其他密钥管理环境
  • 不要把 token 提交到 git

如果你先想理解概念，可以看 网关令牌术语页。

浏览器中继与网络敏感工作流

浏览器中继（browser relay）是把 OpenClaw 的浏览器操作或浏览器侧会话桥接回网关的机制，常出现在需要浏览器自动化、网页验证或浏览器代理场景中。

在以下场景要特别谨慎：

  • 依赖浏览器自动化或浏览器侧验证
  • 希望网关只信任已经鉴权和隔离的 relay 流量
  • 需要把代理、沙箱和 tunnel 结合到浏览器工作流里

运维建议：

  • relay 流量尽量限制在受控网络边界内
  • relay 和 gateway token、localhost 绑定一起使用
  • 每次改动后都检查日志

如果概念还不清楚，先看 浏览器中继术语页。

技能、插件与自定义扩展

OpenClaw 的技能和插件可以显著扩展能力，但它们本质上仍然是高风险代码入口。

典型流程：

Command
openclaw plugins install @xxx/yyyopenclaw gateway restart || trueopenclaw logs | tail -n 100

如果你使用社区或自定义仓库：

Command
mkdir -p ~/.openclaw/skillscd ~/.openclaw/skillsgit clone https://github.com/someone/some-skill-repo.git

建议：

  • 把技能视为代码，不是普通内容
  • 新技能优先在隔离环境测试
  • 技能和 allowlist、策略控制、日志监控一起使用

如果你想继续浏览示例，进入 技能中心。

安全与运维检查清单

  • 密钥全部放进 .env
  • 命令 allowlist 保持最小
  • 不把网关直接暴露到公网
  • 每次重要改动后都重启并重新测试
  • 长期运行优先选择 Docker 或 VPS 隔离环境

相关 OpenClaw 指南