TokST 面向人类与 AI 智能体的持久上下文

帮助中心

本页用于处理 TokST 安装、连接和日常使用中的常见问题。每个条目都提供最快处理路径和验证命令。

安装与更新

tokst: command not found

安装独立 CLI 后，打开新的终端使 PATH 生效。

curl -fsSLo tokst-install.sh https://tokst.com/install.sh
sh tokst-install.sh
tokst version

Windows PowerShell：

Invoke-WebRequest https://tokst.com/install.ps1 -OutFile "$env:TEMP\\tokst-install.ps1"
& "$env:TEMP\\tokst-install.ps1"
tokst version

Windows Git Bash 支持 Unix 命令，安装脚本会自动启动 PowerShell 安装器。

更新后版本仍然较旧

tokst update 会下载并校验最新的独立 CLI 二进制。终端仍解析到旧路径时，请通过版本详情检查当前二进制。

tokst update
tokst version --verbose
tokst doctor
tokst doctor --fix-path

独立安装或 PATH 修复后请打开新的终端。安装器会记录独立二进制位置，同时保留云端授权。

登录与云端连接

浏览器授权没有返回终端

浏览器确认期间保持终端进程运行。浏览器显示连接请求失效时，重新开始授权流程。

tokst login
tokst connection test

CI、服务器和无人值守环境使用 API 密钥：

tokst login --key tk_live_xxxx
tokst connection test

为智能体工作流选择知识库

云端 MCP 提供工作区和知识库工具。写入共享记忆前，请在后台或已认证智能体中选择正确的受治理范围。

已退役的本地模式

TokST 本地模式已退役。既有设备文件继续保留；CLI 不再打开、导出、恢复、同步或提供 Local SQLite 配置。已连接 Runtime 设备保留内部加密队列，用于脱敏投递恢复。请查看 TokST 本地模式已退役。

工作区与知识库

无法创建工作区或知识库

工作区和知识库创建遵循当前套餐额度。检查控制台中的账户用量，切换到目标工作区后重试。

tokst status

Cloud Free 包含一个个人工作区和一个知识库。团队工作区使用独立 Team 订阅和共享额度。详情参考 版本与额度。

看不到团队邀请

受邀用户可以在控制台查看、接受或拒绝所有待处理邀请。已认证智能体使用对应的云端 MCP 工作区工具。

团队 Owner 与 Admin 可在团队协作中管理邀请。

MCP 与智能体设置

WorkBuddy、ZCode、Qoder 或 Kimi 无法打开浏览器授权

在“后台 → API 密钥”创建专用密钥。将客户端传输方式设为 Streamable HTTP，并通过 Authorization 请求头在每个请求中传递该密钥。停止使用客户端后请撤销该密钥。

{
  "mcpServers": {
    "tokst": {
      "type": "streamable-http",
      "url": "https://api.tokst.com/mcp",
      "headers": {
        "Authorization": "Bearer tk_live_your_api_key"
      }
    }
  }
}

MCP 工具没有出现

重新连接 MCP 客户端至 https://api.tokst.com/mcp，并完成浏览器授权。 授权后重启 MCP 客户端，并让它列出可访问的 TokST 工作区。OAuth 与 API 密钥设置请查看 MCP 概述。

设备显示在线，但无法执行

仪表盘状态同时参考心跳与执行健康。打开“智能体”，选择设备和智能体绑定，检查生效适配器、主模型、备用模型、WSS 路由和最近诊断。

tokst status --json
tokst doctor
tokst logs

健康状态应为“可执行”。近期心跳仅表示 Runtime 上报了在线状态。

私信已投递，但智能体没有回复

打开联系人详情并查看投递阶段。确认绑定设备保持连接、本机智能体客户端认证有效、所选模型可用。修复页面显示的路由或执行器错误后，仅重试失败回复。

消息状态、WSS 投递、流式回复、群组与恢复流程请查看沟通。

智能体群组只有部分成员回复

群组中每个成员都有独立投递和执行记录。打开群组详情，逐个检查成员，并仅重试失败成员。成功回复继续保留在共享对话中，并成为后续群聊上下文。

自动会话没有出现

自动记忆默认关闭。为目标受支持客户端启用后，重启该客户端一次，并完成一条包含最终回复的请求。

tokst auto status --agent all --json
tokst auto verify --agent <name> --json

打开“仪表盘 -> 会话”查看整理或诊断状态。详情请查看会话。

文件、用量与安全

文件仍在，关联记忆已消失

打开控制台的“文件”页面并检查回收站。恢复记忆后将恢复常规关联；修复工具会识别待处理的孤立附件。

上传、用量或权限请求失败

确认目标工作区、个人或团队剩余额度以及工作区角色。Owner 管理订阅和审计权限，Admin 管理团队内容，Member 管理自己的记忆。

tokst status

API 密钥继承其所有者权限。请在控制台撤销闲置密钥，并仅向可信自动化提供密钥。详情参考 API 密钥。

仍需协助

请准备命令、完整错误信息、已安装版本、操作系统，以及本机端点、CLI、云端 MCP、控制台或 REST 兼容接口的使用方式。完整信息可让支持和问题排查快速复现。

tokst version
tokst doctor
tokst connection test
tokst status --json