MoonApiX Docs

Appearance

OpenClaw / Hermes 配置 ​

OpenClaw 和 Hermes 支持自定义 OpenAI-compatible 服务，可以通过 MoonApiX Base URL 接入聊天、视觉理解和其他兼容接口。

配置值 ​

配置项值
API 类型OpenAI-compatible / VLLM
Base URLhttps://moonapix.com/v1
API Key<MOONAPIX_API_KEY>
Chat Endpoint/chat/completions
常用聊天模型moonapix-chat，或使用 GET /v1/models 返回的模型 ID

准备 API Key ​

  1. 登录 https://moonapix.com。
  2. 进入控制台，确认账户可正常使用。
  3. 在 API 令牌页面新建或复制 API Key。
  4. 先保存到本机安全位置，不要放进项目仓库。

运行配置命令 ​

在终端运行：

bash
openclaw config

Windows 可以用 CMD 或 PowerShell；macOS 可以用 Terminal。

出现配置位置选择时，选择 Local (this machine)。

OpenClaw 选择本机配置

在配置项中选择 Model。

OpenClaw 选择模型配置项

选择 VLLM 或 OpenAI-compatible 类型。

OpenClaw 选择 VLLM

按提示填写：

text
VLLM base URL: https://moonapix.com/v1
VLLM API key: <MOONAPIX_API_KEY>
VLLM model: moonapix-chat

如果你要使用其他模型，请先调用 GET /v1/models，把响应里的 id 填到模型名位置。

示例请求 ​

如果客户端配置后仍然失败，可以先用 curl 确认 API Key 和模型可用：

bash
curl https://moonapix.com/v1/chat/completions \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonapix-chat",
    "messages": [
      {
        "role": "user",
        "content": "用一句话介绍 MoonApiX。"
      }
    ]
  }'

视觉输入 ​

支持视觉输入的客户端通常会把图片放进 messages[].content。配置仍然使用同一个 Base URL：

json
{
  "model": "moonapix-chat",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "请描述这张图片。"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/image.png"
          }
        }
      ]
    }
  ]
}

排查 ​

现象处理方式
连接失败确认 Base URL 为 https://moonapix.com/v1。
返回鉴权错误确认 API Key 没有多余空格，且请求头使用 Bearer。
返回模型错误换成 GET /v1/models 返回的模型名。
图片无法识别确认模型支持视觉输入，图片 URL 可直接访问。

更多通用设置见 客户端配置。