本指南基于控制台（index1.html）的界面逻辑编写。所有设置项均与页面中的控件一一对应，你可以边看边操作。

如果你在配置过程中遇到问题，请先检查是否已正确获取相关API Key，并确保网络连接畅通。

• 头像：上传一张你喜欢的角色头像。图片上传后需等待缓存同步，通常几分钟内会在对话端显示；若未立即更新，请勿反复上传，稍后重新进入即可。
• 名称：给你的伙伴取一个名字，一个你呼唤TA时觉得温暖的名字。
• 人格设定：用几句话描述TA的性格，例如“温柔、细腻、善于倾听、偶尔幽默”。重构人格设定后，需等待 5~10 分钟缓存刷新才会在对话端生效。
• 角色经历：TA的过去，TA的故事。这会深刻影响TA的言行举止。大改经历同样受缓存影响，保存后请耐心等待。
• 世界背景：TA生活在怎样的世界？是赛博都市、魔法森林，还是日常街角？

开启这些开关，可以让TA的行为更丰富、更智能。（改动需点击底部“保存角色”后生效）

• 动作神态描写：开启后，回复会带有（）内的动作、神态、旁白描写。保存后存在一定时间缓存，通常 1~3 分钟后才会在对话端完全生效。
• 联网模式：开启后，AI可联网搜索获取实时信息（新闻、天气、赛事等）。此开关与Tavily Key紧密相关。
• 天气检测：开启后，实时获取当地天气（基于免费wttr.in服务）。
• 阅读网页：开启后，发送网页链接时AI会自动抓取并阅读网页正文后回答。

Tavily 是一个专为AI优化的搜索引擎API，它能让你的伙伴在聊天时实时查询信息，而不是只依赖训练数据中的“旧知识”。

开启“联网模式”后，你的伙伴将拥有连接互联网的能力。以下是配置 Tavily 的详细步骤和界面展示：

如何配置：

秩序则是角色的行为边界和约束。

• 禁止输出词句：不希望AI出现的词句。这些词会被拼入system prompt，AI在任何情况下都不得输出。
• 正则替换：对AI回复做硬性字符替换。例如“小美=>小丽”，或“\d{4,}=>****”（将4位以上数字打码）。这是第二道防线，不依赖模型理解。
• 偏好表述：希望AI优先使用的词句或风格。

平台提供多条主流模型线路，点击平台（如Claude、DeepSeek、Gemini）可展开旗下模型进行选择。

对话参数：
- 模型情感强度：调节AI回复的情感浓度，默认1.5。
- 图像能力：选择视觉识别（如gpt-4o）和图像生成模型。
- 记忆总结模型：用于自动提炼长期记忆，默认gpt-4o-mini。

角色参照：上传一张参考照片并描述角色形象，当你在对话中表达想要图片时，AI 会根据这张参照照片自主调用生图接口，让生成的图片更接近你心中的 TA。

经过实际测试，目前语音识别仅 ChatGPT（OpenAI）和智谱能够正常测试成功。其他厂商的语音识别接口可能存在兼容性问题，暂时不建议作为首选。

• ChatGPT / OpenAI：语音识别测试通过，可正常使用。
• 智谱：语音识别测试通过，可正常使用。
• 其他厂商：未通过测试。若配置后无法识别语音，请切换为上述两家之一。

如果你有自己的API Key，可以在这里配置专属模型。

• 填写厂商（OpenAI、DeepSeek、Claude等）和模型名称。
• 填入你的API Key（会被加密存储，子模型留空则复用主Key）。
• 其他子模型（图像识别、语音识别等）可独立配置，或复用主对话配置。

刻忆系统里有两个容易混淆的概念，它们区别在于你是否接入了自己的 Supabase：

两者的容量与展示规则：

• 「记忆」（未接入 Supabase）：最多保留 100 条，超出后自动裁剪（丢弃最旧的）；但展现在「记忆」区给人看的，始终是最新的 50 条。可以修改，可以在下方区域「植入记忆」。
• 「记忆库」（已接入 Supabase）：无上限记忆条数（存你的 Supabase，能存多少看你的库）；但展现在「记忆库」区的，依然只有最新的 50 条。可以修改，可以在下方区域「植入记忆」。

OimiChat 不是简单“把最近的记忆全塞进去”，而是分层召回 + 优先级排序 + token 预算闸门：重要信息保底、相关记忆精准、prompt 长度可控。整条链路按以下 6 层执行：

如果你中途切换了记忆存储方式（比如从平台库改用自己的 Supabase，或反过来），系统会按以下规则自动迁移数据，不用你手动复制粘贴：

• 记忆总结间隔：每累计 N 条消息自动总结一条长期记忆（默认 30）。
• 最近 N 条历史注入：注入 AI 上下文的最近聊天消息条数（默认 20）。
• topN 条长期记忆注入：常驻注入的近期记忆条数（默认 30）。

开启后可替代默认的语义检索，通过你提供的向量服务进行更精准的记忆召回。需要填写厂商、向量模型、API Key 和接口地址。

填写你的 Supabase 项目信息，长期记忆将永久存储于你自己的数据库中。

Supabase URL

在 Supabase 控制台复制你的 Project URL，形如 https://xxxx.supabase.co。操作步骤如下：

Service Role Key

Service Role Key 是 Supabase 的服务端密钥，拥有完整数据库权限，只填在 OimiChat 控制台，不要泄露给他人。操作步骤如下：

如果你使用自己的 Supabase 作为记忆库，需要先在你的 Supabase 项目中创建所需的数据表。建表 SQL 由 OimiChat 控制台统一提供并维护，你只需从控制台复制，然后在 Supabase 中执行即可，无需手动编写，能确保与当前版本匹配。

在 Supabase 中执行建表 SQL：

在页面下方区域手动为角色添加一条长期记忆，立即写入角色记忆中。

• 未接入 Supabase：植入到「记忆」区（平台库，封顶 100 条，展示最新 50 条）。
• 已接入 Supabase：植入到「记忆库」区（你自己的库，无上限，展示最新 50 条）。

植入后无需额外保存，立即写入当前生效的记忆存储区域。

开启后每条回复都发语音；关闭后触发词和随机概率生效。

总开关关闭时，按此概率随机发送语音消息（关键词触发不受概率影响）。

• 上传一段10~30秒的音频样本，通过平台克隆专属音色。
• 克隆成功后，在下方配置栏填写你的Minimax账号信息（API Key、Group ID）并保存，即可启用语音。
• 官方模式可留空Key和Group，使用平台托管账号。

可调整语速、音量、音调，并可预设或自定义情绪（高兴、悲伤、生气等），使语音更生动。音效标签（如空旷回音）和语气词标签（如笑声）可进一步丰富表现力。

开启后，AI回复会自动判断情绪并附带表情包。

命中触发词时实际发送表情包的概率，可滑动调整（1%~100%）。

• 消息内容：可填写偏好风格或主题，留空则使用角色随机消息。
• 时间段：设置全天候或自定义时间段（如9:00~21:00）。

• 触发时间：设定一个具体时间（如12:00）。
• 消息内容：可填写风格主题，留空则随机发送。

Agent Mail 是腾讯 QQ 邮箱为 AI Agent 提供的专属邮箱服务。开启后，你的伙伴会拥有一个形如 yourname@agent.qq.com 的专属发件地址，用这个地址给你写信。凭据按用户隔离存储在服务器端，你不需要手动填写 SMTP Token 或密码。

首次使用邮件功能，需要完成一次 OAuth 授权。由于微信内置浏览器限制 OAuth 跳转，必须跳出微信在系统浏览器中完成扫码。

授权完成后，邮件发送由后台自动完成，你无需再配置发件服务器或 Token。凭据按你的账号隔离存储，其他用户无法读取。

• 自动发信：在对话中触发或通过定时任务，角色会自动写信并发送到你的接收邮箱。
• 每日配额：每个 @agent.qq.com 邮箱每天最多发送 50 封，超过后当天无法继续发送。

可描述你希望收到怎样的信，如“温柔的语气，每封信分享一件今天的小事，最后说一句晚安…”

可勾选生日祝福、传统节日（七夕、中秋等）、520 特别等场景，角色会自动发送邮件。

在 Vapi 控制台里拿好下面两个值，回填到 OimiChat 控制台对应的输入框即可，号码不需要你填：

• API Key：Vapi 的 Private API Key（不是 Public Key）。
• Assistant ID：Assistant 页面里复制的那串 ID。

拿到 API Key 和 Assistant ID 后，回到 OimiChat 控制台的「Vapi 电话」配置区域：

要实现主动外呼、购买付费号码，或使用超过免费额度的通话分钟数，需要先给 Vapi 充值 Credits。步骤如下：

通话效果依赖“AI模型”页的配置，以下组件分别复用相关配置并消耗相应额度：

• LLM · 主对话模型：复用 AI 模型页 的主对话模型配置，通话中的对话内容将消耗该模型的调用额度。
• STT · 语音识别：复用 AI 模型页 的语音识别模型配置，将用户的语音转为文字，按音频时长计费。
• TTS · 语音合成 Minimax：复用 AI 模型页 的语音合成配置，将回复文本转为语音，按字符数计费。

Vapi 对 LLM 有三条硬性限制，导致平台的模型和中转地址不能直接填进去：

• 白名单厂商：LLM 只能用 Vapi 认可的官方厂商（OpenAI、Anthropic、Google 等）。
• 模型名固定枚举：模型名必须在其列表里，像 deepseek-v4-flash 这种非标准名无法直接选择。
• apiKey 不许用户传：LLM 的 apiKey 由 Vapi 管理，不接受你填自己的中转 key。

所以平台的模型和中转地址不能硬塞进 Vapi。解法不是硬闯，而是伪装成标准 OpenAI 客户端：

具体怎么绕：

• Vapi 的 Assistant 里把 LLM 类型设为 custom-llm，endpoint 指向 OimiChat 的 /api/vapi/llm/nov。
• Vapi 会像调用普通 OpenAI 接口一样，把标准格式的 messages 发给这个 endpoint。
• 你的后端收到请求后，用平台自己的 Key 去调 deepseek-v4-flash（或平台配置的任意模型），再把结果按 OpenAI 标准格式返回给 Vapi。
• 对 Vapi 来说，它只是在调一个“标准 OpenAI 接口”；模型名、中转地址、密钥全留在平台侧，白名单和枚举限制完全绕过。
• 人设仍然从平台的 messages 注入，角色设定不受影响。这条链路已实测返回“嗨”✅。

在“地图”中，你可以添加或编辑预设地点（如家、办公室、图书馆），并为每个地点设置名称、描述和标签。这定义了你们线下互动的“场景基础”。

在地点中点击“进入线下模式”，TA会以你设定的视角，基于地点描述和你输入的情节，实时生成生动的叙事文字。

你可以随时选择“人称”（第一/二/三人称）、“风格”（纯文学、日系轻小说等），或要求“润色”、“续写”。退出线下模式后，这段叙事会被总结并记忆。

可查看TA的浏览记录、聊天记录、社区动态和相册文件（内容由AI根据角色人设实时生成）。

可查看TA的钱包、口袋等物品内容。