在 ChatBox 中使用 OpenVeer

详细指导如何在 ChatBox 桌面客户端中配置和使用 OpenVeer API 服务，本指南将帮助您在 ChatBox 中配置 OpenVeer API，以便使用丰富的 AI 模型资源。

准备工作

在开始之前，请确保：

1. 已安装 ChatBox\
   从 ChatBox GitHub 下载并安装适合您操作系统的版本，或访问 ChatBox 官网

2. 已获取 OpenVeer API 密钥\
   登录 OpenVeer 控制台 获取您的 API 密钥（以 sk- 开头）

第一步：启动 ChatBox 并开始配置

首次启动 ChatBox 或添加新的 AI 提供商时：

1. 启动 ChatBox 应用
2. 如果是首次使用，会自动弹出配置向导
3. 点击 "使用自己的 API Key 或本地模型" 按钮
4. 如果已经配置过，可以点击左下角的 ⚙️ 设置 图标，或使用快捷键 Ctrl+, (Windows/Linux) / Cmd+, (macOS)

ChatBox 配置向导，选择使用自己的 API Key

第二步：配置 OpenVeer API

2.1 选择 AI 模型提供商

在设置页面中：

1. 找到 AI 模型提供商 或 AI Provider 设置项
2. 在下拉菜单中选择 OpenAI API（使用 GPT 系列模型）、Claude API（使用 Claude 系列模型）或 Gemini API（使用 Gemini 系列模型）

ChatBox 设置页面，选择 OpenAI API 作为提供商

2.2 配置 API 信息

选择 OpenAI API 后，填写以下配置信息：

选择 Claude API 后，填写以下配置信息：

选择 Gemini API 后，填写以下配置信息：

填写 OpenVeer 的 API Key 和 API Host

2.3 选择模型

配置完成后，在 模型 或 Model 下拉菜单中选择您要使用的模型：

推荐模型：

从模型列表中选择您需要使用的 AI 模型

第三步：开始使用

配置完成后，您就可以开始使用 ChatBox 与 AI 对话了：

1. 返回主界面
2. 在输入框中输入您的问题或需求
3. 按 Enter 或点击发送按钮
4. AI 将使用 OpenVeer 的模型为您生成回复

ChatBox 对话界面，开始与 AI 交流

调整模型参数（可选）

您可以根据需要调整以下参数：

高级功能

多会话管理

ChatBox 支持创建多个对话会话：

1. 点击 新建对话 按钮
2. 可以为不同的任务创建独立的会话
3. 在左侧会话列表中切换不同的对话

保存和导出对话

1. 右键点击对话会话
2. 选择 导出 选项
3. 可以导出为 Markdown、JSON 等格式

使用提示词模板

1. 在设置中找到 提示词 或 Prompts 设置
2. 可以保存常用的提示词模板
3. 在对话中快速调用预设的提示词

常见问题

Q1: 无法连接到 OpenVeer 服务？

解决方案：

1. 检查 API Host：
   * 确保填写的是 https://api.openveer.com
   * 不要添加 /v1 或其他路径

2. 验证 API Key：
   * 确认 API Key 正确且以 sk- 开头
   * 在 OpenVeer 控制台 检查密钥是否有效

3. 检查网络连接：
   * 确保能够访问 https://api.openveer.com
   * 如果在国内，可能需要配置代理

Q2: 模型列表中没有显示 OpenVeer 的模型？

解决方案：

1. 手动输入模型名称：
   * 在模型输入框中直接输入模型 ID
   * 例如：gpt-4o、gpt-4o-mini、claude-sonnet-4-5-20250929

2. 刷新模型列表：
   * 重启 ChatBox 应用
   * 重新配置 API 信息

Q3: 对话时出现错误提示？

常见错误及解决方案：

Q4: 如何查看 API 使用情况和费用？

登录 OpenVeer 控制台 查看：

• 📊 API 调用统计
• 💰 费用明细
• 📈 使用趋势图表
• 🔍 详细的请求日志

Q5: ChatBox 支持哪些平台？

ChatBox 支持多个平台：

• 🪟 Windows - Windows 10/11
• 🍎 macOS - macOS 10.15+
• 🐧 Linux - 各主流发行版
• 🌐 Web - 浏览器版本

使用技巧

1. 快捷键

充分利用 ChatBox 的快捷键提升效率：

2. 优化提示词

编写更好的提示词以获得更好的回复：

❌ 不好的提示：

帮我写代码

✅ 好的提示：

请帮我用 Python 编写一个函数，实现以下功能：
1. 接收一个字符串列表作为输入
2. 过滤掉长度小于 3 的字符串
3. 返回按字母顺序排序的结果
请包含详细注释和示例用法

3. 利用对话历史

ChatBox 会保存对话历史：

• AI 会记住当前会话中的上下文
• 可以基于之前的回答继续提问
• 适合进行深入的探讨和迭代

4. 切换模型

根据不同任务切换合适的模型：

• 写作任务 - 使用 gpt-4o 或 claude-sonnet-4-5
• 代码任务 - 使用 claude-sonnet-4-5
• 快速问答 - 使用 gpt-4o-mini
• 多模态 - 使用 gemini-2.0-flash-exp

功能特性

使用 ChatBox + OpenVeer，您可以：

• 💬 流畅对话 - 实时流式输出，体验更流畅
• 🎯 多会话管理 - 同时管理多个独立对话
• 💾 本地存储 - 对话记录保存在本地，保护隐私
• 📤 导出对话 - 支持多种格式导出对话记录
• 🎨 界面简洁 - 简洁美观的用户界面
• 🔒 开源免费 - 完全开源，免费使用
• 🌍 跨平台 - 支持 Windows、macOS、Linux
• 🚀 性能优秀 - 轻量级应用，运行流畅

支持与帮助

如果您在使用过程中遇到任何问题：

• 📚 OpenVeer 文档中心
• 📚 ChatBox GitHub
• 💬 Discord 社区
• 🐦 Twitter @OpenVeer_