Memoh API Key配置指南:接入OpenAI、Anthropic等40+模型提供商实战教程
【免费下载链接】Memoh✨ The open-source multi-agent platform. Every agent gets its own computer, desktop, network, and long-term memory. You can bring your own key, or host your coding agent like Claude Code, Codex and so on.项目地址: https://gitcode.com/gh_mirrors/me/Memoh
Memoh 是一个开源的多智能体平台,每个 AI Agent 都拥有独立的"云端电脑"。本指南带你完成Memoh API Key 配置:通过自带密钥(Bring Your Own Key)接入 OpenAI、Anthropic、DeepSeek、Kimi、智谱 GLM 等 40+ 模型提供商,5 分钟让 AI 助手跑起来。🚀
为什么需要配置 API Key?
Memoh 内置了完整的 Agent 运行时——文件系统、浏览器、终端、长期记忆,但"大脑"由你指定的大模型驱动。配置 API Key 后,你可以:
- 自主选择模型:GPT 系列、Claude 系列、Gemini、GLM、Kimi 等随你切换
- 掌控成本:费用直接走你自己的供应商账单,透明可控
- 本地零成本:接入 Ollama、LM Studio 本地模型,甚至不需要 API Key
💡 如果你的供应商不在预设列表中(如中转站、API 网关),Memoh 也支持自定义 Base URL 接入。
第一步:打开 Providers 提供商设置页
登录 Memoh Web 界面,在左侧导航栏点击Providers进入提供商管理页。这里会列出所有已添加的提供商,每个条目旁边有状态指示灯——绿点表示连接正常。
页面右侧即为配置表单,核心字段有 4 个:
| 字段 | 说明 | 示例 |
|---|---|---|
| Name | 显示名称,随意起名 | OpenAI |
| Client Type | API 协议格式 | OpenAI Responses / Anthropic Messages |
| Base URL | 供应商 API 地址 | 预设模板自动填充 |
| API Key | 你的密钥 | 仅显示后 4 位 |
第二步:选择预设模板,填入 API Key
点击左下角+ Add新增提供商,首先从预设模板下拉框中选择你的供应商(如 OpenAI、Anthropic)。选择后,Base URL 和 Client Type 会自动填充,你只需粘贴 API Key,然后:
- 点击Test Connection(测试连接)——状态灯变绿即成功 ✅
- 点击Save Changes保存
预设模板覆盖 conf/providers/ 目录下的 44 个官方提供商配置,常见 LLM 厂商包括:
- 🇺🇸海外:OpenAI、Anthropic、Google Gemini、xAI (Grok)、Mistral、Fireworks、Cerebras、Groq、Together AI、Perplexity、Cloudflare、Azure OpenAI
- 🇨🇳国内:DeepSeek、Kimi (Moonshot)、智谱 GLM(Zhipu/Z.AI)、MiniMax、Qwen、通义、火山引擎、阿里百炼
- 🌐聚合/中转:OpenRouter、New API、HuggingFace
- 💻本地模型:Ollama、LM Studio、Edge(无需 API Key)
每个模板同时预置了模型清单,比如 conf/providers/openai.yaml 内置了 GPT-5 全系、o 系列、GPT-4o 等数十个模型,并标注了各自的上下文窗口、视觉能力和推理档位。
第三步:导入模型并分配给 Bot
保存提供商后,有两种方式获得模型列表:
- Import Models:一键从供应商的
/models接口拉取全部可用模型 - Add Model:手动添加单个模型
导入完成后,模型会出现在每个 Bot 的会话输入框模型选择器中。如图所示,输入框底部可直接切换当前会话使用的模型(如 MoonshotAI 的 Kimi K2.5):
配置完成后即可跨平台对话——Web 界面、Telegram 等渠道共用同一套模型配置,模型调用记录统一沉淀在 Agent 的长期记忆中:
进阶:Deep Link 一键导入提供商
如果你常用 API 网关或聚合平台,Memoh 支持Deep Link 快捷导入:第三方服务生成一条链接,打开后自动预填 Base URL 和 API Key,你在确认页核对后再点击保存(密钥只显示后 4 位,Memoh 不会静默写入凭据):
https://<你的Memoh地址>/providers/connect#payload=<base64url编码的JSON>payload 中包含base_url、api_key、client_type(协议格式)、template(命中的预设模板)等字段。密钥只放在 URL fragment 中,不会进入服务端日志和 Referer。完整字段说明见 docs/provider-connect-deeplink.md。
常见问题 FAQ
Q:保存后状态灯一直是红色?先点 Test Connection 查看报错。90% 的情况是 API Key 复制不完整,或 Base URL 末尾少了/v1。
Q:想给不同 Bot 用不同模型?可以。每个 Bot 的会话都独立选择模型提供商,甚至可以为压缩(Compaction)等后台任务单独指定更便宜的模型。
Q:API Key 安全吗?密钥在服务器端经过加密存储(由 conf/app.example.toml 中[auth]段的agent_credentials_encryption_key控制),界面一律掩码显示,仅显示后 4 位。
相关路径参考
- 提供商预设模板:conf/providers/
- 添加提供商前端组件:apps/web/src/components/add-provider/index.vue
- 预设列表定义:apps/web/src/constants/provider-presets.ts
- 系统配置文档:docs/configuration.md
配置好 API Key 只是开始——现在去创建一个 Bot,给它一个任务,看看它如何调用浏览器、执行代码、跨会话记住你。🎉
【免费下载链接】Memoh✨ The open-source multi-agent platform. Every agent gets its own computer, desktop, network, and long-term memory. You can bring your own key, or host your coding agent like Claude Code, Codex and so on.项目地址: https://gitcode.com/gh_mirrors/me/Memoh
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考