在 OpenClaw 中使用 Muapi

将 Muapi 作为 OpenAI 兼容自定义提供商接入 OpenClaw，即可在其智能体和已连接频道中使用 Muapi 文本模型。

1. 创建密钥并选择模型

在 Muapi 控制台创建 API 密钥，然后列出可用文本模型：

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

选择响应中 capabilities.tools: true 的模型，以便 OpenClaw 调用工具。

2. 配置自定义提供商

在运行 OpenClaw gateway 的环境中设置 MUAPI_API_KEY。将提供商和默认模型添加到 OpenClaw 配置文件（通常为 ~/.openclaw/openclaw.json）：

{
  models: {
    mode: "merge",
    providers: {
      muapi: {
        baseUrl: "https://api.muapi.ai/v1",
        apiKey: "${MUAPI_API_KEY}",
        api: "openai-completions",
        models: [{ id: "YOUR_MODEL_ID", name: "Muapi text model" }],
      },
    },
  },
  agents: { defaults: { model: { primary: "muapi/YOUR_MODEL_ID" } } },
}

将两处 YOUR_MODEL_ID 替换为 Muapi 模型列表中的准确 ID。不要将密钥放入共享项目文件。如果 OpenClaw 作为服务运行，请确保服务环境中有 MUAPI_API_KEY。

3. 启动并验证模型

openclaw models list
openclaw tui

尝试一项会使用工具的小任务，例如让智能体总结工作区中的文件。确认模型能在终端中工作后，再连接消息频道。

故障排查

• 模型未显示时，检查提供商 ID、模型准确 ID 和 JSON5 语法。
• 身份验证失败时，确认 gateway 进程可读取 MUAPI_API_KEY。
• 模型不调用工具时，选择 capabilities.tools: true 的模型。
• 从小任务开始，并在 Muapi 控制台查看用量；长时间智能体会话可能发送大量上下文。

当前配置选项请参阅 OpenClaw 自定义提供商文档和模型配置指南。