客户端接入
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.json | provider 定义(端点、协议、模型列表) |
auth.json | 密钥 |
settings.json | 默认模型等偏好 |
senpi 本体另有一套:~/.senpi/agent/settings.json,以及项目级 .senpi/settings.json。
| 字段 | 值 |
|---|---|
| provider 协议 | @ai-sdk/openai-compatible |
| Base URL | https://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 项目,升级后配置结构可能变。