Skip to Content
aicentos
客户端接入

Senpi (OmO Native)

在 Senpi / OmO 里接入 aicentos —— 配置目录与 openai-compatible provider 的位置

最后更新于:

Senpi 是 pi-mono 的 fork,npm 包名 @code-yeongyu/senpi,可执行文件叫 senpi。它同时是 oh-my-openagent(简称 OmO)的运行时,所以「OmO Native」指的是跑在 senpi harness 上的那一套。

准备工作

curl -fsSL https://get.omo.dev/install.sh | bash
omo

也可以用 bun 装:

bun add -g omo-ai

项目自述 experimental,官方原话是不要押在生产流水线上。

需要填写的配置

配置目录是 ~/.omo/agent/,可用 OMO_CODING_AGENT_DIR 覆盖;旧的 SENPI_* 变量仍然兼容。

文件作用
models.jsonprovider 定义(端点、协议、模型列表)
auth.json密钥
settings.json默认模型等偏好

senpi 本体另有一套:~/.senpi/agent/settings.json,以及项目级 .senpi/settings.json。

字段值
provider 协议@ai-sdk/openai-compatible
Base URLhttps://aicentos.com/v1
API Key控制台创建的 Key
模型控制台「模型广场」中的模型名

配置步骤

在 ~/.omo/agent/models.json 里加一个 provider,协议选 OpenAI 兼容那一类(文档给的映射是 npm: @ai-sdk/openai-compatible):

{
  "providers": {
    "aicentos": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://aicentos.com/v1",
        "apiKey": "sk-你的-API-Key"
      },
      "models": {
        "你的模型名": {}
      }
    }
  }
}

密钥也可以单独放 auth.json,不写进 models.json。然后把默认模型写进 settings.json。

测试

启动 omo 或 senpi,在模型选择器里确认出现 aicentos 下的模型,发一句话确认能返回。

注意事项

  • 两个配置目录别混:OmO 侧在 ~/.omo/agent/,senpi 侧在 ~/.senpi/agent/,改错地方不生效。
  • 项目级 .senpi/settings.json 会覆盖全局设置,排查问题时先看项目目录。
  • 官方文档只给了迁移映射,没有给完整的字面配置片段,上面的结构按 Pi 系约定整理,字段名请以 omo.dev/docs 当前版本核对。
  • experimental 项目,升级后配置结构可能变。

相关链接