omp Custom Provider 设置
使用 Tokiway OpenAI-compatible 提供程序、环境支持的 API 密钥、模型 ID 和准确的模型限制来配置 omp (Oh My Pi)。
什么是omp（Oh My Pi）？
omp，也称为Oh My Pi，是一个具有内置和自定义模型提供程序的终端编码代理。
本 omp 指南在 models.yml 中声明了 Tokiway OpenAI-compatible 提供程序。 API 键是从环境变量解析的，并且模型上下文和输出值必须与所选模型匹配。 models.yml 文件控制提供程序传输、环境支持的凭据、模型 ID、上下文窗口和最大输出。 YAML 缩进或复制的限制可能会阻止加载或产生无效请求，因此请使用 omp 模型检查提供程序，并在将其用于活动工作之前测试一个小型只读任务。
omp 会把内置目录、~/.omp/agent/models.yml、运行时发现和扩展注册的模型合并成一个 registry。Tokiway 属于 models.yml 自定义 Provider，最终以 tokiway/<model-id> 选择。
第一步：设置 omp 能解析的凭证
export TOKIWAY_API_KEY="sk-..."apiKey 的解析规则是“环境变量名或字面值”：若名为 TOKIWAY_API_KEY 的变量存在就使用其值，否则会把这串文字当成 Key。因此配置后一定要确认环境变量存在。
第二步：编辑 ~/.omp/agent/models.yml
providers:
tokiway:
baseUrl: __API_BASE_URL__/v1
api: openai-completions
apiKey: TOKIWAY_API_KEY
authHeader: true
models:
- id: YOUR_TOKIWAY_MODEL_ID
name: Tokiway / YOUR_TOKIWAY_MODEL_ID
contextWindow: 128000
maxTokens: 8192authHeader: true 会让 omp 为每个请求注入 Authorization: Bearer <key>。contextWindow 与 maxTokens 必须来自对应 Tokiway 模型，不能沿用示例值。
第三步：检查 Provider 是否“加载”且“可用”
omp models
omp models find YOUR_TOKIWAY_MODEL_IDomp 的模型可以进入 registry 却仍不可选择。官方定义的可用条件是：Provider 不在有效的 disabledProviders 中，并且它是 keyless 或拥有可解析凭证。即使 Key 有效，只要 tokiway 被禁用，整个 Provider 仍会消失。
凭证冲突时按 omp 的优先级排查
同一个 Provider 有多份 Key 时，omp 依次使用：运行时 --api-key、models.yml 的 apiKey、本地 auth store 的 API Key、OAuth、Provider 环境变量、最后才是自定义 Provider fallback。models.yml 中给 Tokiway 固定的 Key 会优先于旧 OAuth，这正适合自定义 Base URL。
首次验证选择 tokiway/YOUR_TOKIWAY_MODEL_ID，执行只读任务并检查 Tokiway 日志。若 Provider 不出现，先检查 YAML 与 disabledProviders；若出现但不可选，检查 Key 是否解析；若 401，确认环境变量和 authHeader；若 400，再检查模型能力与 Token 上限。
官方资料
推荐模型怎么选？
omp (Oh My Pi) 提供商 FAQ
models.yml 中 apiKey 应该包含什么？
使用 TOKIWAY_API_KEY。当该环境变量存在时，omp 会将其值解析为提供程序密钥。
为什么我的自定义提供商不可用？
检查 models.yml 语法，确保提供程序不在禁用的 Provider 中，并确认 API 键变量可用于 omp。
我可以从另一个模型复制上下文值吗？
否。声明您选择的 Tokiway 型号的实际 contextWindow 和 maxTokens。
omp 和 Oh My Pi 是同一个工具吗？
是的。本页介绍 Oh My Pi 终端编码代理及其 ~/.omp/agent/models.yml 提供程序配置。
如何验证 omp 正在使用 Tokiway？
运行omp模型，选择tokiway/<model-id>，执行只读任务，并在Tokiway日志中确认确切的模型。
配置资料
本页配置以 Tokiway 教程和官方资料为依据，最后核验于 2026-09-08。
其他客户端
