额外的api配置

为降低泄露风险，将API Key配置到系统环境变量，而非直接写入文件： 1. 确认Shell类型：终端输入echo $SHELL，判断为zsh或bash；
2. zsh用户配置： - 输入命令（替换“YOURDASHSCOPEAPIKEY”为实际API Key）：`echo “expor…’

配置环境变量（避免API Key泄露）

为降低泄露风险，将API Key配置到系统环境变量，而非直接写入文件：

1. 确认Shell类型：终端输入echo $SHELL，判断为zsh或bash；
2. zsh用户配置：
   • 输入命令（替换“YOUR_DASHSCOPE_API_KEY”为实际API Key）：echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc；
   • 执行source ~/.zshrc使配置生效；
   • 验证：重新打开终端，输入echo $DASHSCOPE_API_KEY，输出API Key即成功；
3. bash用户配置：
   • 输入命令（替换实际API Key）：echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile；
   • 执行source ~/.bash_profile生效；
   • 验证：重新打开终端，输入echo $DASHSCOPE_API_KEY，输出API Key即成功。
     如果json文件直接配置apikey好了，也不需要弄了（可以先不设置）。

编辑OpenClaw配置文件

OpenClaw模型配置需按指定格式写入~/.openclawd/openclawd.json：

注意两个问题：

1. OpenClaw 无法识别 minimaxai/minimax-m2.1 模型，核心原因是配置文件中的模型定义与实际调用不一致。
   OpenClaw 2026.1.30 要求模型 ID 必须包含 完整命名空间
   错误格式:
   "id": "minimaxai/minimax-m2.1" // ❌ 缺少 provider 前缀
   正确格式应为：
   "id": "nvidia/minimaxai/minimax-m2.1"

2. 错误信息 Invalid config at /root/.openclaw/openclaw.json: Invalid input [plugins] 插件已注册 和 models.providers.nvidia.api: Invalid input，
   核心问题: NVIDIA provider 的 api 字段值无效
   在您的配置中：
   "nvidia": { "baseUrl": "https://integrate.api.nvidia.com/v1", "apiKey": "${DASHSCOPE_API_KEY}", "api": "openai", // ❌ 这里值无效！ "models": [ ... ] }
   OpenClaw 2026.1.30 版本严格要求 api 字段必须为 openai-completions（即使 NVIDIA NIM 兼容 OpenAI API）。 这是 OpenClaw 的硬性验证规则，与实际 API 兼容性无关。

{

  "meta": {

    "lastTouchedVersion": "2026.1.30",

    "lastTouchedAt": "2026-02-06T20:07:20.472Z"

  },

  "wizard": {

    "lastRunAt": "2026-02-06T20:07:20.451Z",

    "lastRunVersion": "2026.1.30",

    "lastRunCommand": "onboard",

    "lastRunMode": "local"

  },

  "auth": {

    "profiles": {

      "qwen-portal:default": {

        "provider": "qwen-portal",

        "mode": "oauth"

      }

    }

  },

  "models": {

    "mode": "merge",

    "providers": {

      "qwen-portal": {

        "baseUrl": "https://portal.qwen.ai/v1",

        "apiKey": "qwen-oauth",

        "api": "openai-completions",

        "models": [

          {

            "id": "qwen-portal/coder-model",

            "name": "Qwen Coder",

            "reasoning": false,

            "input": [

              "text"

            ],

            "cost": {

              "input": 0,

              "output": 0,

              "cacheRead": 0,

              "cacheWrite": 0

            },

            "contextWindow": 128000,

            "maxTokens": 8192

          },

          {

            "id": "qwen-portal/vision-model",

            "name": "Qwen Vision",

            "reasoning": false,

            "input": [

              "text",

              "image"

            ],

            "cost": {

              "input": 0,

              "output": 0,

              "cacheRead": 0,

              "cacheWrite": 0

            },

            "contextWindow": 128000,

            "maxTokens": 8192

          }

        ]

      },

      "nvidia": {

        "baseUrl": "https://integrate.api.nvidia.com/v1",

        "apiKey": "nvapi-AAAA",

        "api": "openai-completions",

        "models": [

          {

            "id": "nvidia/minimaxai/minimax-m2.1",

            "name": "minimax-m2.1",

            "reasoning": false,

            "input": [

              "text"

            ],

            "cost": {

              "input": 0.0025,

              "output": 0.01,

              "cacheRead": 0,

              "cacheWrite": 0

            },

            "contextWindow": 262144,

            "maxTokens": 65536

          }

        ]

      }

    }

  },

  "agents": {

    "defaults": {

      "model": {

        "primary": "nvidia/minimaxai/minimax-m2.1"

      },

      "models": {

        "qwen-portal/coder-model": {

          "alias": "qwen"

        },

        "qwen-portal/vision-model": {},

        "nvidia/minimaxai/minimax-m2.1": {

          "alias": "minimax"

        }

      },

      "workspace": "/root/.openclaw/workspace",

      "compaction": {

        "mode": "safeguard"

      },

      "maxConcurrent": 4,

      "subagents": {

        "maxConcurrent": 8

      }

    }

  },

  "messages": {

    "ackReactionScope": "group-mentions"

  },

  "commands": {

    "native": "auto",

    "nativeSkills": "auto"

  },

  "hooks": {

    "internal": {

      "enabled": true,

      "entries": {

        "boot-md": {

          "enabled": true

        },

        "command-logger": {

          "enabled": true

        },

        "session-memory": {

          "enabled": true

        }

      }

    }

  },

  "channels": {

    "qqbot": {

      "enabled": true,

      "appId": "111",

      "clientSecret": "AAA"

    }

  },

  "gateway": {

    "port": 18789,

    "mode": "local",

    "bind": "loopback",

    "auth": {

      "mode": "token",

      "token": "AAA"

    },

    "tailscale": {

      "mode": "off",

      "resetOnExit": false

    }

  },

  "skills": {

    "install": {

      "nodeManager": "npm"

    }

  },

  "plugins": {

    "entries": {

      "qwen-portal-auth": {

        "enabled": true

      },

      "qqbot": {

        "enabled": true

      }

    }

  }

}

验证模型识别状态

输入clawdbot models list，若配置正确，终端会输出模型信息，示例如下：

Clawdbot 2026.1.24-3 (885167d) - No $999 stand required.
Model                          Input  Ctx    Local Auth  Tags
bailian/qwen3-max-2026-01-23   text   256k   no          default, configured, alias:通义千问 Max Thinking 版

输出包含模型ID、输入类型、上下文窗口大小等信息，说明模型已被识别。

模型连通探测（真实请求验证）

输入openclaw models status –probe`（会产生模型调用费用），
若“Status”显示“ok”，说明模型调用正常；若失败，检查API Key有效性、环境变量配置或网络连接。

重启OpenClaw Gateway

终端输入openclaw gateway restart`，阿里云部署可通过“命令助手”远程执行，重启成功会显示“Restarted LaunchAgent”提示。

对话场景验证

openclaw agent –agent main –message “你是谁？”

补充

注册模型:

Run openclaw configure or set an API key env var.
![[Pasted image 20260207125107.png]]

切换模型

openclaw models list
openclaw models set (模型名)