logo
1
2
WeChat Login

OpenClaw Config

OpenClaw DMXAPI 一键配置工具

纯 Go 终端 TUI 工具,零 CGO,支持多平台一键直接运行与 5 平台交叉编译


简介

OpenClaw Config 是一个简洁易用的终端配置工具,帮助用户快速配置 OpenClaw 的 DMXAPI 设置,无需手动编辑配置文件。

主要功能

  • 支持 Linux / macOS / Windows 的一键直接运行,退出后自动清理临时文件
  • 终端交互式配置 DMXAPI 的 Base URL、API Key 和模型
  • 自动检测 API 格式(Claude / Gemini / GPT-5 / 其他 OpenAI 兼容模型)
  • 内置多种预设模型快速选择
  • 支持自定义模型名称
  • 启动时自动检查 CNB Releases 是否有新版本
  • 一键保存配置到 OpenClaw 配置文件
  • 配置保存后,默认依赖 OpenClaw 的 hybrid reload 自动生效;仅部分网关级配置需要手动重启

支持的预设模型

  • Claude 系列:claude-opus-4-6、claude-sonnet-4-6
  • MiniMax:MiniMax-M2.5-cc
  • GLM:glm-5-cc
  • Hunyuan:hunyuan-2.0-thinking-20251109-cc
  • Kimi:kimi-k2.5-cc
  • GPT-5:gpt-5.3-codex、gpt-5.2
  • Gemini:gemini-3.1-pro-preview、gemini-3-flash-preview

前提条件

使用本工具前,请确保已安装 OpenClaw。本工具会修改 OpenClaw 的配置文件;默认情况下,大多数 agent/model 变更会被 OpenClaw 自动热加载。


直接运行

macOS / Linux(推荐)

curl -fsSL https://cnb.cool/dmxapi/openclaw_config/-/git/raw/main/run.sh | sh

指定版本运行:

curl -fsSL https://cnb.cool/dmxapi/openclaw_config/-/git/raw/main/run.sh | env OPENCLAW_CONFIG_VERSION=vX.Y.Z sh

Windows PowerShell

irm https://cnb.cool/dmxapi/openclaw_config/-/git/raw/main/run.ps1 | iex

指定版本运行:

$env:OPENCLAW_CONFIG_VERSION = "vX.Y.Z"; irm https://cnb.cool/dmxapi/openclaw_config/-/git/raw/main/run.ps1 | iex

Windows cmd

curl.exe -fsSL https://cnb.cool/dmxapi/openclaw_config/-/git/raw/main/run.cmd | cmd

指定版本运行:

set OPENCLAW_CONFIG_VERSION=vX.Y.Z && curl.exe -fsSL https://cnb.cool/dmxapi/openclaw_config/-/git/raw/main/run.cmd | cmd

vX.Y.Z 替换为目标 Release Tag,例如 v1.2.3。以上命令都会临时下载对应平台的二进制,直接启动程序,并在退出后自动清理。

手动下载安装

前往 Releases 页面下载对应平台的版本:

平台架构文件
Linuxx64openclaw-config-linux-amd64
LinuxARM64openclaw-config-linux-arm64
Windowsx64openclaw-config-windows-amd64.exe
macOSIntelopenclaw-config-macos-amd64
macOSApple Siliconopenclaw-config-macos-arm64

使用说明

直接运行

上面的命令会直接启动交互界面;程序退出后,临时下载的二进制会自动删除。

Linux / macOS 如需只查看版本:

curl -fsSL https://cnb.cool/dmxapi/openclaw_config/-/git/raw/main/run.sh | sh -s -- --version

手动下载后运行

Linux

# x64 chmod +x openclaw-config-linux-amd64 ./openclaw-config-linux-amd64 # ARM64 chmod +x openclaw-config-linux-arm64 ./openclaw-config-linux-arm64

macOS

# Intel chmod +x openclaw-config-macos-amd64 ./openclaw-config-macos-amd64 # Apple Silicon chmod +x openclaw-config-macos-arm64 ./openclaw-config-macos-arm64

注意:首次运行时 macOS 可能提示"无法验证开发者"。解决方法:

方法一:右键点击文件 → 选择"打开" → 在弹出对话框中再次点击"打开"

方法二:在终端执行以下命令清除隔离标记,然后再运行:

xattr -rd com.apple.quarantine ./openclaw-config-macos-arm64

Windows

在文件所在目录按住 Shift 并右键,选择"在此处打开 PowerShell 窗口",然后执行:

.\openclaw-config-windows-amd64.exe

版本查看

./openclaw-config-<平台> --version # 例:./openclaw-config-macos-arm64 --version

配置字段说明

启动工具后,按顺序填写以下字段:

字段说明
Base URLDMXAPI 的 API 接入地址,默认为 https://www.dmxapi.cn/v1,通常无需修改
API Keydmxapi.cn 申请的 API 密钥,格式为 sk-...
模型从预设列表中选择,或选择"自定义模型..."后输入模型名称

配置完成后

配置保存后,默认依赖 OpenClaw 的 gateway.reload.mode=hybrid 自动生效,大多数 agent/model 变更无需手动重启。

当你修改的是网关级配置(如 gatewaypluginsdiscoverycanvasHost),或怀疑当前运行实例没有及时拾取配置时,再手动执行:

# 需要手动重启网关时执行: openclaw gateway restart

常用命令

命令说明
openclaw gateway restart手动重启后台网关服务
/model在聊天中查看/切换模型
openclaw models list列出所有可用模型
openclaw-cn tui打开终端聊天助手

配置文件位置

配置保存在以下文件中,可手动查看或备份:

  • 主配置:~/.openclaw/openclaw.json
  • API Key:~/.openclaw/agents/main/agent/auth-profiles.json
  • 模型列表:~/.openclaw/agents/main/agent/models.json

本地开发

环境要求

  • Go 1.23+

克隆项目

git clone https://cnb.cool/dmxapi/openclaw_config cd openclaw_config

开发模式(直接运行)

go run .

构建

# 构建当前平台 go build -o openclaw-config . # 交叉编译(5 平台) GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o dist/openclaw-config-linux-amd64 . GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -o dist/openclaw-config-linux-arm64 . GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -o dist/openclaw-config-windows-amd64.exe . GOOS=darwin GOARCH=amd64 CGO_ENABLED=0 go build -o dist/openclaw-config-macos-amd64 . GOOS=darwin GOARCH=arm64 CGO_ENABLED=0 go build -o dist/openclaw-config-macos-arm64 .

测试

go test ./... sh ./run_test.sh

项目结构

openclaw_config/ ├── app.go # TUI 表单逻辑 ├── main.go # 程序入口(参数解析) ├── run.sh # macOS / Linux 直接运行脚本 ├── run.ps1 # Windows PowerShell 直接运行脚本 ├── run.cmd # Windows cmd 直接运行入口 ├── run_test.sh # 直接运行脚本测试 ├── internal/ │ ├── config/ │ │ ├── manager.go # 配置管理器 │ │ └── types.go # 配置类型定义 │ └── models/ │ └── presets.go # 预设模型列表 └── .cnb.yml # CNB 云原生构建配置

CI/CD

项目配置了自动化构建和发布:

  • CNB:推送 Tag 时自动构建 5 个平台并创建 Release
  • GitHub 镜像同步:主分支会同步到 GitHub 镜像仓库

相关链接


作者

yesongyun - yesongyun@foxmail.com


License

MIT

About

openclaw配置工具

Language
Go93.3%
Shell4.9%
Others1.8%