OpenClaw

跑在你自己设备上的 AI 助理

OpenClaw Foundation OpenAI 兼容格式 macOSLinuxWindows

OpenClaw 是开源 AI 助理，自带 Gateway 跑在你自己的机器上，可通过 Discord、Slack、Telegram、WhatsApp 等 20+ 渠道交互，模型后端以插件方式替换。适合想自托管、并把 Agent 接到聊天平台的团队。它通过 models.providers 支持任意 OpenAI 兼容端点。

网关 base_url（国内站）https://api.shinloo.com/v1填到各工具的 base_url / OPENAI_BASE_URL / apiBase 之类设置里。OpenAI 线路填 /v1；Anthropic / Gemini 线路填网关根 https://api.shinloo.com。

OpenAI 兼容调用路径https://api.shinloo.com/v1/chat/completionsOpenAI 线路的客户端用这个地址（GET /v1/models 可查你的 Key 可用模型）。

推荐模型（国内站已开通）deepseek-v4.1-flashqwen3.8-max-0902glm-5.3以上为本站公示的模型名，实际可用清单以你的 Key 调 GET /v1/models 返回为准。

省事版 — 一键接入

脚本从 OpenClaw 的官方来源安装，把网关配置写进工具自己的配置文件（写之前先备份原文件），再发一次真请求验证。会提示你粘贴网关 Key（也可用 --key 传入）； --uninstall 只还原它写进去的内容。

shell

curl -fsSL https://api.shinloo.com/agents/openclaw/setup | bash

1 · 安装

从 OpenClaw 自己的官方来源安装。

安装

curl -fsSL https://openclaw.ai/install.sh | bash
# 或 npm（npm 11.16+）：
npm install -g openclaw@latest --allow-scripts=openclaw
# 或不安装、直接用 npx：
npx openclaw@latest

2 · 配置 — 指向国内站网关

网关 base URL https://api.shinloo.com/v1；Key 在控制台创建。

配置

国内站 https://api.shinloo.com（OpenAI 兼容格式，原生支持）：
编辑 ~/.openclaw/openclaw.json：
{
  "agents": { "defaults": { "model": { "primary": "quantoport/gpt-5.1-codex-max" } } },
  "models": {
    "providers": {
      "quantoport": {
        "baseUrl": "https://api.shinloo.com/v1",
        "apiKey": "${QUANTOPORT_API_KEY}",
        "api": "openai-completions",
        "models": [ { "id": "gpt-5.1-codex-max", "name": "GPT-5.1 Codex Max" } ]
      }
    }
  }
}
然后重启 Gateway：openclaw gateway restart。

3 · 验证

发一次请求，能返回就说明走的是国内站网关。

验证

openclaw models list
# 能列出 quantoport 下的模型即配置生效；也可 openclaw gateway status 确认 Gateway 在运行，再发一句 prompt 验证。

4 · 常见坑

provider 的 api 必须写 "openai-completions"；自定义非 api.openai.com 地址时，OpenClaw 会自动关闭不支持的 developer role 兼容。
自定义 provider 的模型要在 models.providers.<id>.models[] 里登记 id，否则 Agent 侧看不到该模型。
apiKey 支持 ${ENV_VAR} 形式从环境变量注入，避免明文；模型引用格式是 provider/model，例如 quantoport/<model-id>。
模型名以你站实际开通的为准。

工具侧步骤的官方来源： github.com/openclaw/openclaw raw.githubusercontent.com/openclaw/openclaw/main/docs/concep raw.githubusercontent.com/openclaw/openclaw/main/docs/instal