OpenClaw配置文件详解

0 基础配置

日志配置，不配置默认在/tmp/openclaw/​

{
  "logging": {
    "file": "/path/to/openclaw.log"
  }
}

1 模型配置

"models": {
	"providers": {
	  "localmodel": {  // 模型提供者标识
		"baseUrl": "http://127.0.0.1:29998/v1",
		"apiKey": "no", // 没有这里可以随便填
		"api": "openai-completions", // openai格式
		"models": [
		  {
			"id": "qwen2.5-72b",
			"name": "qwen2.5-72b",  // 模型名
			"reasoning": false,
			"input": [
			  "text"
			],
			"cost": {
			  "input": 0,
			  "output": 0,
			  "cacheRead": 0,
			  "cacheWrite": 0
			},
			"contextWindow": 100000, // 模型上下文窗口大小
			"maxTokens": 10000 // 单次请求允许生成的最大令牌数
		  }
		]
	  }
	}
}

​agents​中配置使用模型

"defaults": {
  "model": {
	"primary": "localmodel/qwen2.5-72b" // 模型提供商/模型名
  },
  "models": {
	"localmodel/qwen2.5-72b": {
	  "alias": "qwen2.5-72b" // 模型别名, 调用时可用这个代替全称
	}
  }
}

2 Gateway配置

"gateway": {
    "port": 18789, 
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token", // 设置为带token访问
      "token": "你的token"
    },
    "tailscale": { // 无需使用
      "mode": "off",
      "resetOnExit": false
    },
	"controlUi": { "enabled": true, "basePath": "/" }, // basePath 可选, 配置后开启自带web页面访问
    "remote": {
      "url": "ws://0.0.0.0:18789",
      "token": "你的token"
    },
    "http": { // 配置后，除原有channel调用，额外支持OpenAI格式调用
      "endpoints": {
           "chatCompletions": { "enabled": true }
      }
    }
  }

可以使用SSH隧道实现远程访问，不用tailscale

# 远程机器执行以下命令
ssh -p 65222 -N -L 18789:127.0.0.1:18789 root@你的ip
# 再访问以下地址
http://127.0.0.1:18789/?token=你的token

如何安装OpenClaw可参考

Linux环境安装OpenClaw（需科学上网）－大模型－曼波资源站 ManboHub