RealRelay.ai
程式碼代理

Oh My Pi 設定指南

在 models.yml 中把 RealRelay.ai 設為 Oh My Pi(omp)的自訂供應商:安裝、新增供應商、設定預設模型並檢查連線。

建立 API 密鑰瀏覽模型目錄
協定
OpenAI Chat Completions
基礎位址
https://www.realrelay.ai/v1
官方文件
github.com
已對照工具官方文件核對
2026-10
實驗性. 尚未在 RealRelay.ai 上完整端對端測試。步驟依據該工具的官方文件；若某一步失敗，請附上錯誤訊息聯絡支援。

概覽

Oh My Pi 是一個終端機程式碼代理,指令是 omp。它源自 Pi,但已是獨立的專案,有自己的設定檔。要把它接上 RealRelay.ai,請在 models.yml 中新增一個自訂供應商。該供應商使用 OpenAI Chat Completions API(/v1/chat/completions)。

  • 一組 API 金鑰,在主控台的 API 金鑰頁面取得。

  • 結尾要含 /v1 的基礎位址。Oh My Pi 會在後面加上 /chat/completions。

  • 一個模型 ID,完全依照 GET /v1/models 列出的寫法,例如 z-ai/glm-5.2。請挑選支援工具呼叫的模型。

這套設定依據 Oh My Pi 的文件撰寫,但尚未在 RealRelay.ai 上完整端對端跑過。Oh My Pi 發版頻繁,如果某個欄位的行為不同,請查閱它的 models.yml 參考文件。如果你使用的是 Pi 本身,請改依 Pi 指南操作;兩者的設定格式無法互通。

安裝

請使用該專案提供的任一種安裝方式。

macOS · Linux
curl -fsSL https://omp.sh/install | sh
Homebrew
brew install can1357/tap/omp
Bun 1.3.14+
bun install -g @oh-my-pi/pi-coding-agent
Windows PowerShell
irm https://omp.sh/install.ps1 | iex

Bun 方式需要 Bun 1.3.14 或更新版本。沒有 Bun 時,安裝指令碼會下載預先建置好的執行檔並核對其校驗碼。如果安裝後找不到 omp,請開啟新的終端機。

設定

  1. 1

    把金鑰放進環境變數

    請把 sk-*** 換成你的金鑰。

    ~/.zshrc · ~/.bashrc
    export REALRELAY_API_KEY="sk-***"

    啟動 omp 前,先執行 source ~/.zshrc,或開啟新的終端機。

    Windows PowerShell
    [Environment]::SetEnvironmentVariable("REALRELAY_API_KEY", "sk-***", "User")

    啟動 omp 前,請關閉並重新開啟終端機。

  2. 2

    在 models.yml 中加入 RealRelay.ai

    建立 ~/.omp/agent/models.yml;如果檔案已存在,請在 providers 底下新增 realrelay 項目。

    ~/.omp/agent/models.yml
    1providers:2  realrelay:3    baseUrl: https://www.realrelay.ai/v14    api: openai-completions5    apiKey: REALRELAY_API_KEY6    compat:7      supportsDeveloperRole: false8    models:9      - id: z-ai/glm-5.210        name: z-ai/glm-5.211        contextWindow: 20000012        maxTokens: 32768
  3. 3

    設為預設模型

    把以下內容加進 ~/.omp/agent/config.yml。你也可以執行 omp setup,在預設模型步驟中選取該模型。

    ~/.omp/agent/config.yml
    modelRoles:  default: realrelay/z-ai/glm-5.2

  • apiKey: REALRELAY_API_KEY 填的是變數的名稱,不加 $。Oh My Pi 會先尋找同名的變數。如果沒有設定,它會把這段文字本身當作金鑰送出,結果就是 401。

  • supportsDeveloperRole: false 會讓 Oh My Pi 以標準的 system 角色送出指示,而不是較新的 developer 角色;RealRelay.ai 上有許多模型會拒絕後者。

  • contextWindow 與 maxTokens 告訴 Oh My Pi 模型能接收與回傳多少內容。RealRelay.ai 不會回報這些數值,所以請依模型目錄頁面設定。這裡顯示的值對 z-ai/glm-5.2 是安全的。

  • 供應商上的 compat 會套用到其下的每個模型;模型自己的 compat 會再合併上去。

  • 使用具名 profile(omp --profile)時,檔案位於 ~/.omp/profiles/<name>/agent/。omp config path 會印出目前使用的資料夾。

驗證

  1. 1

    直接呼叫端點

    用你的金鑰執行這段指令。若收到含 choices 陣列的 JSON 回覆,就代表位址、金鑰與模型都沒問題。

    Terminal
    1curl -sS "https://www.realrelay.ai/v1/chat/completions" \2  -H "Authorization: Bearer sk-***" \3  -H "content-type: application/json" \4  -d '{"model": "z-ai/glm-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'
  2. 2

    確認 Oh My Pi 看得到模型

    omp models realrelay 應會印出一張含有你的模型的表格。第二個指令會送出一個提示詞,印出回答後結束。

    Terminal
    omp models realrelayomp --model realrelay/z-ai/glm-5.2 -p "Reply with OK"
  3. 3

    在專案中啟動工作階段

    送出一則簡短訊息。收到回覆即確認整條路徑暢通,而該請求也會出現在主控台的用量日誌中。

    Terminal
    cd /path/to/your/projectomp --model realrelay/z-ai/glm-5.2

模型

在工作階段中,/model 會開啟模型中心。你可以在那裡為目前的工作階段選擇模型,或把它指派給 default 角色以長期保留。在命令列中,--model 的值是供應商名稱、一個斜線,再接完整的模型 ID。

Oh My Pi 只提供你在供應商底下列出的 RealRelay.ai 模型。每個模型新增一個項目,並各自設定上限。沒有設定上限時,它會假設上下文為 128,000 token、輸出為 32,768 token。

~/.omp/agent/models.yml → providers.realrelay.models
1      - id: z-ai/glm-5.22        name: z-ai/glm-5.23        contextWindow: 2000004        maxTokens: 327685      - id: deepseek/deepseek-v4-pro6        name: deepseek/deepseek-v4-pro7        contextWindow: 2000008        maxTokens: 32768

對於會先思考再回答的模型,請把它標示為推理模型,並由低到高列出它接受的推理強度層級。之後 Oh My Pi 就會連同你選的層級一起送出 reasoning_effort。

~/.omp/agent/models.yml → providers.realrelay.models
1      - id: z-ai/glm-5.22        name: z-ai/glm-5.23        contextWindow: 2000004        maxTokens: 327685        reasoning: true6        thinking:7          mode: effort8          efforts: [low, medium, high]9        compat:10          supportsReasoningEffort: true

哪些模型適合代理使用,請見選擇模型。

疑難排解

  • 401 或「Invalid token」。啟動 omp 的終端機中沒有設定 REALRELAY_API_KEY,或是 models.yml 中的變數名稱拼錯了。這兩種情況下,送出的金鑰都會是變數名稱本身。

  • 找不到供應商或模型。models.yml 驗證失敗,Oh My Pi 因此退回使用內建模型。請留意啟動時的錯誤提示。自訂供應商必須有 baseUrl、apiKey 與 api。

  • 404。baseUrl 缺少 /v1,或已經以 /chat/completions 結尾。

  • 400 並提到 developer 角色。請在供應商的 compat 底下加上 supportsDeveloperRole: false。

  • 400 並提到 reasoning_effort。該模型不接受這個欄位。請從它的項目中移除推理設定。

  • 出現未知 compat 鍵的警告。該鍵拼錯了,或此版本未使用它。檔案仍會載入;請修正或移除該鍵。

  • 長時間工作階段中出現上下文錯誤。contextWindow 大於模型的實際上限。請調低到模型目錄頁面上的數值。