# Senpi (OmO Native)

来源: https://docs.aicentos.com/clients/senpi

Language: zh-CN

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

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

## 准备工作

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

也可以用 bun 装：

```bash
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`）：

```json
{
  "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 项目，升级后配置结构可能变。

## 相关链接

* [OmO 文档](https://omo.dev/docs)
* [senpi 仓库](https://github.com/code-yeongyu/senpi)
* [oh-my-openagent 仓库](https://github.com/code-yeongyu/oh-my-openagent)