MaaSLink 在线文档

Override OpenAI Base URL

https://api-cn.rightmaas.com/v1

OpenAI API Key

YOUR_API_KEY

模型

MODEL_ID

配置步骤

1. 01

   确认自定义模型可用

   在 Cursor 中确认账户和当前版本允许使用 Custom Model；若 Models 页没有自定义模型入口或出现套餐错误，请先处理 Cursor 侧限制。

2. 02

   添加 OpenAI 自定义模型

   打开 Settings → Models，选择 Add Custom Model，并选择 OpenAI 协议。

3. 03

   填写密钥与 Override Base URL

   将控制台创建的密钥填入 OpenAI API Key；在 Override OpenAI Base URL 中粘贴本页地址（必须保留末尾 /v1）。不要在此处填写 Claude Code 的 Anthropic 地址。

4. 04

   输入准确模型 ID

   在模型名称字段中粘贴模型广场或控制台显示的完整模型 ID，注意大小写、连字符和版本后缀必须完全一致。

5. 05

   保存并验证

   保存 Provider，在 Cursor 聊天中选择该模型，发送一条不含敏感信息的简单请求确认返回正常。

ANTHROPIC_BASE_URL

https://api-cn.rightmaas.com

ANTHROPIC_AUTH_TOKEN

YOUR_API_KEY

模型

MODEL_ID

配置步骤

1. 01

   安装或更新 Claude Code

   按 Claude Code 官方安装方式完成安装；配置前不要用默认登录流启动，以免混入其他账号凭据。

2. 02

   打开 settings.json

   macOS/Linux 使用 ~/.claude/settings.json，Windows 使用用户目录下的 .claude/settings.json；文件不存在时新建。

3. 03

   写入 env 配置

   在 settings.json 的 env 对象中设置 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL 和三个默认模型变量。下方示例会自动带入当前访问站点的地址；不要自行补 /v1。

4. 04

   映射可用模型

   将 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL 和 ANTHROPIC_DEFAULT_HAIKU_MODEL 设置为控制台支持的精确模型 ID；可先使用同一个 MODEL_ID。

5. 05

   重启终端并测试

   关闭当前终端后重新打开项目目录，执行 claude 并完成一次非敏感测试任务；如提示使用 API key，选择确认。

配置示例

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api-cn.rightmaas.com",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MODEL_ID"
  }
}

base_url

https://api-cn.rightmaas.com/v1

experimental_bearer_token

YOUR_API_KEY

模型

MODEL_ID

配置步骤

1. 01

   安装或更新 Codex

   按 Codex 官方安装方式安装 CLI，并确认可在新的终端窗口执行 codex。

2. 02

   打开配置文件

   macOS/Linux 使用 ~/.codex/config.toml，Windows 使用 C:\Users\<用户名>\.codex\config.toml；目录或文件不存在时新建。

3. 03

   添加 MaaSLink Provider

   将下方 TOML 示例写入 config.toml，把 YOUR_API_KEY 和 MODEL_ID 分别替换为控制台创建的密钥和可用模型 ID。

4. 04

   保留 Responses 协议和 /v1

   不要把 wire_api 改为 chat 或 completions；base_url 末尾的 /v1 对应 /v1/responses 路由。

5. 05

   重启并验证

   关闭所有已打开的 Codex 进程，在新的项目终端执行 codex 并运行一个非敏感任务；认证或模型错误时先检查密钥、模型 ID 和 TOML 格式。

配置示例

model_provider = "maaslink"
model = "MODEL_ID"

[model_providers.maaslink]
name = "MaaSLink"
base_url = "https://api-cn.rightmaas.com/v1"
experimental_bearer_token = "YOUR_API_KEY"
wire_api = "responses"

baseUrl

https://api-cn.rightmaas.com/v1

apiKey

YOUR_API_KEY

模型

MODEL_ID

配置步骤

1. 01

   安装 OpenClaw

   在 macOS、Linux 或 WSL2 执行 curl -fsSL https://openclaw.ai/install.sh | bash，并按安装脚本提示完成安装。

2. 02

   更新并确认版本

   运行 openclaw update 更新 CLI，再执行 openclaw --version 确认安装成功。

3. 03

   编辑配置文件

   打开 ~/.openclaw/openclaw.json（文件不存在时新建），在 models.providers.maaslink 中填写本页的 /v1 地址、YOUR_API_KEY、模型 id 和 name。

4. 04

   设置 provider 与默认模型

   使用 JSON5 示例中的 models.mode: merge、api: openai-completions，并将 agents.defaults.model.primary 设置为 maaslink/MODEL_ID。maaslink 是本教程选用的自定义 ID，不是官方保留名称；如果改名，provider key 与 primary 前缀必须同步。

5. 05

   验证与排障

   运行 openclaw models list、openclaw models set maaslink/MODEL_ID、openclaw models status、openclaw doctor 和 openclaw gateway status，按输出检查模型、密钥和网关状态。API Key 可使用 YOUR_API_KEY 或官方支持的 ${VAR_NAME} / SecretRef 引用。

配置示例

{
  models: {
    mode: "merge",
    providers: {
      maaslink: {
        baseUrl: "https://api-cn.rightmaas.com/v1",
        apiKey: "YOUR_API_KEY",
        api: "openai-completions",
        models: [{ id: "MODEL_ID", name: "MODEL_NAME" }],
      },
    },
  },
  agents: {
    defaults: {
      model: { primary: "maaslink/MODEL_ID" },
    },
  },
}

base_url

https://api-cn.rightmaas.com/v1

api_key

YOUR_API_KEY

模型

MODEL_ID

配置步骤

1. 01

   安装 Hermes Agent

   在 macOS、Linux 或 WSL2 执行 curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash，完成后重新加载 shell。

2. 02

   更新并验证环境

   运行 hermes update 更新 CLI，再执行 hermes doctor 检查依赖和环境。

3. 03

   运行配置向导

   在普通终端执行 hermes model，选择 Custom endpoint，填写本页当前站点的 /v1 地址、YOUR_API_KEY 和可用的 MODEL_ID。hermes model 是完整的 provider/model 配置向导，可新增 provider、执行认证并保存全局默认值。

4. 04

   理解会话切换

   活动聊天会话中的 /model <model> --provider <provider> 只切换已经配置的 provider/model；使用 /model <model> --provider <provider> --global 会同时切换当前会话并持久化到 ~/.hermes/config.yaml。/model 不能新增 provider、执行 OAuth 或提示录入 API Key，这些操作回到 hermes model。

5. 05

   检查手工配置

   等价地编辑 ~/.hermes/config.yaml，将 model.default、provider: custom、base_url、api_key 和 api_mode: chat_completions 写入 model 节点；使用 hermes config get model --json、hermes status 和 hermes doctor 检查结果。API Key 可使用 YOUR_API_KEY 或 ${VAR_NAME} / ${env:VAR_NAME} 引用。

配置示例

model:
  default: MODEL_ID
  provider: custom
  base_url: https://api-cn.rightmaas.com/v1
  api_key: YOUR_API_KEY
  api_mode: chat_completions