🐫 CaMeL Hub
English 控制台

在 Obsidian 中接入 CaMeL Hub:Text Generator 插件配置教程

Obsidian 是一款本地优先、基于 Markdown 双向链接的笔记软件,本身不带任何 AI 能力——所有智能写作功能都来自社区插件。其中最常用的是 Text Generator:它在笔记内直接提供续写、总结、问答等 AI 命令。Text Generator 支持接入任意 OpenAI 兼容端点,把它指向 CaMeL Hub 后,一个 API Key 就能在 GPT、Claude、Gemini、DeepSeek 之间自由切换——不同模板配不同模型,不用为每家官方账号单独开卡。

Obsidian ↗

  1. 安装 Text Generator 插件

    打开 Obsidian 设置 → 第三方插件(Community plugins)。如果是第一次装社区插件,先点击开启第三方插件退出安全模式。点击浏览(Browse),搜索 Text Generator(作者 nhaouari),安装并启用。

  2. 打开 Text Generator 设置页

    回到设置页,在左侧插件选项列表里找到 Text Generator 并点击进入。这里配置插件要连接的 AI 服务商和端点。

  3. 选择自定义 / OpenAI 兼容的服务商

    Text Generator 内置了多家服务商可选,找到标注为 Custom、OpenAI-Compatible 或类似字样的选项(具体文案随插件版本略有差异)。这个模式允许你填自己的端点,而不是绑定官方 OpenAI 账号。

  4. 填入 API Key

    在 CaMeL Hub 控制台的令牌(Token)页生成一个密钥,粘贴到 Text Generator 服务商设置里名为 API Key(部分版本叫 Secret Key)的字段。

  5. 填入 Base URL / API Endpoint

    在名为 Base URL、Base Path 或 API Endpoint 的字段里,填入 CaMeL Hub 的 OpenAI 兼容基础地址:
    https://api.camel-hub.com/v1

  6. 选择模型

    在 Model 下拉框里选择模型(如果列表拉不出来,就用旁边的自由文本模型字段),填入准确的模型名称——长文写作和总结推荐 claude-sonnet-5,追求速度和低成本可以用 deepseek-v4-flash。填完保存设置。
    claude-sonnet-5
gpt-5.4
deepseek-v4-flash

  7. 在笔记里生成文字

    把光标放到想要插入内容的位置,通过左侧功能区的手形图标、命令面板(搜索 Generate Text)或自定义快捷键触发生成。Text Generator 会把光标周围的笔记内容当作上下文发给模型,并把回复写回笔记。

  8. (可选)搭建提示词模板

    Text Generator 支持把常用提示词(比如总结、改写、提取待办事项)存成模板笔记,放在指定的模板文件夹里。可以在模板的 frontmatter 里为不同模板指定不同的 CaMeL Hub 模型,让不同任务各用各的模型。

常见问题

Text Generator 的模型下拉框是空的,拉不出模型列表怎么办?

部分版本的下拉框依赖插件向 /models 端点发起请求,但并非每种自定义服务商模式都会调用它。遇到空列表时改用旁边的自由文本模型字段,手动填入准确的模型名,比如 gpt-5.5 或 claude-sonnet-5;同时确认 Base URL 结尾是 /v1,后面没有多余路径。

密钥明明复制对了,插件却提示 API Key 无效?

先检查粘贴时有没有带上多余的空格或换行,再确认服务商模式确实选的是 Custom/OpenAI-Compatible——Text Generator 里有些内置服务商不读 API Key 这个字段,会去别处找凭据。不确定密钥是否还有效,就去控制台令牌页重新生成一个。

在 Obsidian 里用 CaMeL Hub,选哪个模型比较合适?

写长文、改写、总结密集笔记内容,claude-sonnet-5、gpt-5.4 这类模型输出更连贯;如果只是快速补全或批量处理大量笔记,更在意速度和成本,可以换成 deepseek-v4-flash 或 gpt-5.4-mini。

为什么生成的文字是一整段蹦出来,而不是一个字一个字流式输出?

是否逐字流式输出取决于 Text Generator 的版本和所选服务商模式——部分自定义服务商路径会等完整回复到达后再一次性插入笔记。这是插件端的行为,不是 CaMeL Hub 端点决定的;如果在意这点,可以查插件更新日志或服务商设置里有没有流式开关。