PI / OMP

PI 与 omp 在配置文件里声明一个兼容 provider：Base URL 按所选协议填 https://api.sagelib.com 或 https://api.sagelib.com/openai，密钥填网关令牌；api 可写在 provider 上，也可按模型分别覆盖。

最后更新：2026-11-14

PI 与 omp（Oh My Pi） 都是终端 Agent，配置方式一致：在配置文件里声明一个兼容 provider；同一个网关里的不同模型还能分别走不同协议。

建议用 CC Switch 来管理 PI 的网关配置（它支持 PI，保存后可一键切换）；omp 手写配置文件即可。下面以 CC Switch 配置 PI 为例。

支持的模型和协议

PI 与 omp 都支持多种协议，api 可以写在 provider 上作默认，也可以写在单个模型上覆盖，所以同一个网关可以按模型混用：

模型详情页的「模型能力」里要包含你选的协议；同时支持多种协议的模型（如 deepseek-v4.1-flash、glm-5.3、kimi-k3）可以任选。

界面配置

打开 CC Switch → 添加供应商 → 自定义配置，打开配置页面。

按下表填写：

配置文件

PI

CC Switch 会把配置写进下面两个文件。

1. ~/.pi/agent/models.json —— 供应商与模型：

{
  "providers": {
    "sagelib-gateway": {
      "name": "SageLib AI 边缘网关",
      "baseUrl": "https://api.sagelib.com/openai/v1",
      "api": "openai-completions",
      "models": [
        {
          "id": "claude-fable-5",
          "name": "Claude Fable 5",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 128000,
          "compat": { "cacheControlFormat": "anthropic" }
        },
        {
          "id": "deepseek-v4-flash-0731",
          "name": "DeepSeek V4 Flash 0731",
          "api": "openai-responses",
          "reasoning": true,
          "input": ["text"],
          "contextWindow": 1000000,
          "maxTokens": 384000,
          "compat": { "thinkingFormat": "deepseek" }
        }
      ]
    }
  }
}

• sagelib-gateway 是供应商标识（也是 PI /model 里的前缀）；
• name 是显示名；
• baseUrl 是网关地址（OpenAI 协议写到 https://api.sagelib.com/openai/v1，Anthropic 协议写到 https://api.sagelib.com/anthropic，不要重复写 /v1）；
• api 写在 provider 上是默认协议，写在单个模型上覆盖（上面 deepseek-v4-flash-0731 就走 openai-responses）；
• 模型字段 id（实际请求模型）、name（显示名）、reasoning、input、contextWindow、maxTokens 按「模型详情页 → 模型限制」填。

2. ~/.pi/agent/auth.json —— 网关令牌（按供应商标识存）：

{
  "sagelib-gateway": {
    "type": "api_key",
    "key": "sk-你的网关密钥"
  }
}

默认模型写在 ~/.pi/agent/settings.json：

{
  "defaultProvider": "sagelib-gateway",
  "defaultModel": "deepseek-v4.1-flash"
}

omp（Oh My Pi）

~/.omp/agent/models.yml —— 供应商与模型（密钥直接写在 apiKey）：

providers:
  sagelib-gateway:
    name: sagelib-gateway
    baseUrl: "https://api.sagelib.com/openai/v1"
    api: openai-completions
    apiKey: sk-你的网关密钥
    models:
      - id: claude-fable-5
        name: Claude Fable 5
        reasoning: true
        input: [text, image]
        contextWindow: 1000000
        maxTokens: 128000
        compat:
          cacheControlFormat: anthropic
      - id: deepseek-v4-flash-0731
        name: DeepSeek V4 Flash 0731
        api: openai-responses
        reasoning: true
        input: [text]
        contextWindow: 1000000
        maxTokens: 384000

• providers 是唯一根键；
• apiKey 先按环境变量名解析，找不到才当字面量（上面是直接写字面量）；
• 单个模型也能覆盖 api / baseUrl。

默认模型写在 ~/.omp/agent/config.yml 的 modelRoles.default：

modelRoles:
  default: sagelib-gateway/deepseek-v4.1-flash

启动并验证

PI：启动 pi → /model → 选 sagelib-gateway/deepseek-v4.1-flash；omp：启动 omp → /model → 选同一个。新开对话发一句话，能收到回复即接通；再到控制台「用量日志」确认这条调用出现。报 404 时先检查 baseUrl 里的 /v1 是否重复。

参考来源

• PI 官网
• omp（Oh My Pi）官网