用 TeeChat OpenAPI 跑 OpenClaw —— 对话与记忆嵌入

发布2026年8月12日修订2026年9月13日

OpenClaw 是许多团队使用的开放 Agent 环境。你可以把 TeeChat OpenAPI 当作它的 OpenAI 兼容后端，同时覆盖 对话与记忆嵌入——不必安装 TeeChat 专用 SDK。嵌入负责向量记忆检索；没有它，Agent 对笔记与历史上下文的「记忆力」会差很多。

请求在 TeeChat 的 机密计算接入点中处理：TLS 连接终止于安全硬件内，用户数据明文仅在安全硬件内短暂出现。你也可以按需核验 OpenAPI 接入点。这是给 Agent 工具准备的便捷路径。

TeeChat 侧准备步骤与接入 WorkBuddy 相同；OpenClaw 的 Provider 字段内容相同——基础地址忽略/v1但配置程序会自动补全（见下文）。

当前模型 id（可能变更——请用下文「查询可用模型」的鉴权 curl 核对）：

用途	模型 id（一字不差）
主对话 / Agent	`Qwen/Qwen3.8-27B`
记忆 / 嵌入	`Qwen/Qwen3-Embedding-0.6B`

准备：TeeChat 账号与 API 密钥

与 WorkBuddy 的 TeeChat 侧流程相同。请为 OpenClaw 单独创建一把密钥，便于日后只吊销这一把而不影响其它工具。

1. 注册 TeeChat

若还没有账号，请先注册——下载桌面版或使用网页对话。

2. 登录（网页或桌面版）

在浏览器或桌面应用中打开 TeeChat 并登录。

3. 创建 API 密钥

打开 TeeChat → 设置 → 通用 → 账户 → API 密钥。

TeeChat 设置：账户 → API 密钥（例如 OpenClaw）

在标签框填入例如 openclaw。
点击 创建密钥。
创建后，完整的 sk-… 只会在界面上显示这一次；点复制并妥善保存，勾选「我已将密钥保存在安全位置」，再点完成。

TeeChat：完整 API 密钥仅显示一次，请复制并保存

完整密钥仅显示一次。服务器未保存可恢复明文；若创建后未及时保存则无法重新读取，可将其吊销并重新生成一把新密钥。

同一账号下各密钥的用量共用一个 词元池（token pool）；分开多个密钥便于只吊销个别集成，而不影响其它工具。

4. 查询可用模型（必鉴权）

GET /v1/models 需要 API 密钥。在浏览器地址栏直接打开该 URL（无 Authorization）会返回 401，属正常行为。请用终端：

export TEECHAT_OPENAPI_KEY='sk-…'
curl -sS https://openapi.teechat.ai/v1/models \
  -H "Authorization: Bearer $TEECHAT_OPENAPI_KEY"

可选：若已安装 jq，可追加 | jq '.data[].id' 只列出模型 id。确认列表中的对话 id 与嵌入 id，再填入 OpenClaw。

OpenClaw × TeeChat OpenAPI —— 对话 · 记忆嵌入 · 机密计算

开始 OpenClaw 之前

已完成上文准备（已保存 sk-…）。
已安装 OpenClaw，终端可运行 openclaw（见安装说明）。
Node 满足 OpenClaw 要求（推荐 Node 26——见 Node.js）。

为 TeeChat OpenAPI 配置对话模型

用下面 三种方式之一 打开模型 / Provider 设置。它们填写的是 同一组 字段（见下一节）。

方式 A — 首次安装（`openclaw onboard`）

第一次安装，或完整重置之后：

openclaw onboard --install-daemon

提示时选择 QuickStart (recommended)。进入 Model/auth provider 后，按下文字段填写。

方式 B — 重新配置模型（`openclaw configure`）

OpenClaw 已装好，只想改模型 / Provider：

openclaw configure --section model

（无子命令的 openclaw config 也会进入同一类交互向导。）

方式 C — Control UI 仪表盘

openclaw gateway status    # 网关需在运行
openclaw dashboard         # 打开 http://127.0.0.1:18789/

若界面询问，请粘贴网关 token（引导流程生成，或 openclaw gateway auth-token --show）。
打开 Settings → Agents & Tools → Models（或 Model Providers）。
使用 Model setup / 添加或编辑 Custom OpenAI 兼容 Provider，填写与 CLI 向导相同的值。
需要直接改文件时，用 System → Config（表单或 Raw JSON）编辑 ~/.openclaw/openclaw.json。

需要填写的信息（A / B / C 相同）

字段	填写内容
Model/auth provider	先选 More…，再选 Custom Provider (Any OpenAI or Anthropic compatible endpoint)
API Base URL	`https://openapi.teechat.ai` —（不需要 /v1，配置程序会自动补全）
API key	Paste API key now → 粘贴 TeeChat 的 `sk-…`
Endpoint compatibility	OpenAI-compatible
Model ID	`Qwen/Qwen3.8-27B`（或以「查询可用模型」curl 返回的当前对话 id 为准）

关于 /v1： OpenClaw 自定义 Provider 填写站点源地址即可，配置程序会自动补全路径。与 WorkBuddy 的字段含义一致；若某处已含 /v1，也可按该界面规则填写。

CLI 填好后的示例（openclaw configure --section model / onboard）：

OpenClaw：已填写 TeeChat OpenAPI 的 Custom Provider

命令行逐步说明（含截图）

方式 A、方式 B 会看到这些步骤。仪表盘（方式 C）用表单收集同样的信息。

1. More…

在 Model/auth provider 中选择 More…，才能看到自定义接入点（不要停在内置的 OpenAI / Anthropic 等项）。

OpenClaw：在 Model/auth provider 选择 More…

2. Custom Provider

选择 Custom Provider (Any OpenAI or Anthropic compatible endpoint)。

OpenClaw：选择 Custom Provider

3. Paste API key now → OpenAI-compatible → Model ID

API Base URL： https://openapi.teechat.ai（不需要 /v1，配置程序会自动补全）。
How do you want to provide this API key? → Paste API key now，再粘贴 TeeChat 密钥。
Endpoint compatibility → OpenAI-compatible。
Model ID → Qwen/Qwen3.8-27B。

模型 id 可能变更——若 TeeChat 更新模型后对话失败，请重新跑上文「查询可用模型」的鉴权 curl，并改此字段。

然后：

openclaw gateway status
openclaw dashboard

在 Control UI 发一句短消息。能正常回复即表示对话可用。接下来配置 记忆嵌入。

记忆嵌入（让 OpenClaw 真正「聪明」——必配）

OpenClaw 的向量记忆搜索需要嵌入后端。请指向 同一把 TeeChat API 密钥，模型为 Qwen/Qwen3-Embedding-0.6B。

1. 可选冒烟测试

export TEECHAT_OPENAPI_KEY='sk-…'
curl -sS https://openapi.teechat.ai/v1/embeddings \
  -H "Authorization: Bearer $TEECHAT_OPENAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"Qwen/Qwen3-Embedding-0.6B","input":"OpenClaw memory smoke"}'

应返回 200。失败时先检查密钥/配额，再继续配置 OpenClaw。

2. 配置 memory search

嵌入 仍需配置。当前正式版 OpenClaw（如 npm 2026.7.1-2）里：

顶层 memory 只负责引擎开关：backend + citations（不要往这里塞 search——会 memory: Invalid input）。
嵌入 provider / 模型 / 远端写在 agents.defaults.memorySearch（见 Control UI Config 表单里该路径，或 memory config 概念文档；Settings → Memory 没有这些字段）。

请打开 Config → Raw JSON（或编辑 ~/.openclaw/openclaw.json），在现有配置上合并（保留 doctor 恢复的 memory.backend）：

{
  "memory": {
    "backend": "builtin",
    "citations": "auto"
  },
  "agents": {
    "defaults": {
      "memorySearch": {
        "provider": "openai-compatible",
        "model": "Qwen/Qwen3-Embedding-0.6B",
        "remote": {
          "baseUrl": "https://openapi.teechat.ai/v1",
          "apiKey": "sk-…"
        }
      }
    }
  }
}

也可用 CLI：

openclaw config set agents.defaults.memorySearch.provider openai-compatible
openclaw config set agents.defaults.memorySearch.model 'Qwen/Qwen3-Embedding-0.6B'
openclaw config set agents.defaults.memorySearch.remote.baseUrl 'https://openapi.teechat.ai/v1'
openclaw config set agents.defaults.memorySearch.remote.apiKey 'sk-…'

（remote.baseUrl 必须带 /v1。改完后 openclaw config validate，再重建索引。）

场景	基础地址
对话 Custom Provider	`https://openapi.teechat.ai`（不需要 /v1，配置程序会自动补全）
记忆嵌入 `agents.defaults.memorySearch.remote.baseUrl`	`https://openapi.teechat.ai/v1`（要 `/v1`）
WorkBuddy 自定义模型 URL	`https://openapi.teechat.ai/v1`

3. 重建索引

openclaw gateway restart   # 若在磁盘上改了配置
openclaw memory index --force
openclaw memory status

memory status 应显示嵌入 provider 健康（而不是只能关键词 / 已禁用）。

使用建议

一个工具一把密钥。 在 TeeChat 里打好标签；设备遗失时只吊销对应密钥即可。
配额。 对话与嵌入共用账号的 API 词元池。
三扇门，同一张表。 onboard、configure --section model 与仪表盘需要同一组自定义 Provider 值。
需要证明时再核验。 核验 OpenAPI 接入点对日常 OpenClaw 使用是可选的。

检查清单

已有 TeeChat 账号并已登录
已创建标签为 openclaw 的专用密钥并保存 sk-…
鉴权 curl GET /v1/models 返回模型列表（无密钥时浏览器打开为 401）
已通过 onboard 或 configure --section model 或仪表盘打开模型设置
More… → Custom Provider → 基础地址（不需要 /v1，配置程序会自动补全）→ 粘贴密钥 → OpenAI-compatible → Qwen/Qwen3.8-27B
短消息对话测试成功
（可选）curl 嵌入对 Qwen/Qwen3-Embedding-0.6B 返回 200
记忆搜索：agents.defaults.memorySearch → TeeChat /v1 + 同一密钥；memory index --force 健康

修订记录

2026年9月13日对话模型 id → Qwen/Qwen3.8-27B
2026年8月12日准备节后增加 OpenClaw × TeeChat 题图。

← 全部文章