# AI 接入说明

## Provider 选择

```text
MODEL_PROVIDER=noop
MODEL_PROVIDER=openclaw
MODEL_PROVIDER=hermes
MODEL_PROVIDER=direct_llm
```

## 统一接口

业务层只调用：

```text
AIService.ask(prompt, context)
```

所以后续切换 OpenClaw、Hermes 或 OpenAI-compatible 模型时，不需要改业务模块。

## OpenClaw

```text
MODEL_PROVIDER=openclaw
OPENCLAW_BASE_URL=http://127.0.0.1:18789
OPENCLAW_API_KEY=
```

适合：

- 飞书/桌面/手机协同
- 工具调用
- 执行网关

## Hermes

```text
MODEL_PROVIDER=hermes
HERMES_BASE_URL=http://127.0.0.1:8080
HERMES_API_KEY=
```

适合：

- 长期记忆
- 技能沉淀
- 自学习

## Direct LLM

```text
MODEL_PROVIDER=direct_llm
DIRECT_LLM_BASE_URL=https://api.openai.com/v1
DIRECT_LLM_API_KEY=
DIRECT_LLM_MODEL=gpt-4.1-mini
```

## 安全原则

AI 可以：

- 查询数据
- 生成报告
- 生成草稿
- 推送提醒

AI 不可以自动：

- 审批付款
- 修改绩效最终分
- 删除业务数据
- 自动投资下单