AI 设置
AI 功能是可选的。只有在你需要 AI 对话、AI 命令、AI 辅助 Emoji 搜索或 AI 生成主题时,才需要配置 provider。
添加 Provider
- 打开 设置。
- 进入 AI。
- 点击 添加。
- 填写 provider 名称、API key、模型信息,以及需要时的自定义 host。
- 保存后,在具体功能中选择这个 provider。

字段含义
| 字段 | 作用 |
|---|---|
| Provider 名称 | 在 Wox 设置里识别这个 provider 的名称。 |
| API key | Wox 发给 provider 的凭据。 |
| Host | 兼容服务、代理或本地 provider 的可选 API 地址。 |
| Model | 聊天、命令或生成类功能使用的模型。 |
安全注意事项
- 把 API key 当作密码处理。
- 付费 provider 可能会对每次请求计费,包括 AI 命令和主题生成。
- 只使用可信的自定义 host;Wox 会把 prompt 内容发送到该地址。
- 不要把敏感剪贴板、选中文本或私有文件发送给在线模型,除非你确认这符合自己的工作流。
相关功能
排查
如果 AI 功能没有返回结果,先检查:
- provider 已启用,并被对应功能选中。
- API key 有效。
- 模型名被 provider 接受。
- 自定义 host 可以访问。
- 当前网络可用。