跳转到主要内容
OpenClaw 是一款可自托管且开源的个人人工智能代理,可通过 WhatsApp、Telegram、Discord 及其他即时通讯平台进行访问,并支持 MCP 工具。该代理会从 providers 配置中选取模型;只需添加一个指向 https://api.tokios.com/v1 且使用您的 sk-tok-… 令牌的自定义兼容 OpenAI 的服务提供商,OpenClaw 代理即可在您本地的硬件上运行指定模型。

前置条件

连接器已完成配对

将 tokios-connector 安装并配对至 OpenClaw 需要访问的模型所在位置。

模型已注册

为该模型注册一个部署名称(公开名称)。

API 密钥已创建

生成一个 sk-tok-… 令牌,也可将其权限限定于该特定部署范围。

支持的后端服务

确认您本地的后端服务(Ollama、llama.cpp、vLLM 或 LM Studio)正在正常运行。

将 Tokios 添加为模型提供商。

1

打开 OpenClaw 的配置文件。

编辑 OpenClaw 的配置内容,其中模型提供商的相关信息位于 models.providers 处。具体的文件路径取决于您的安装方式,请查阅 OpenClaw 的安装说明。
2

添加 Tokios 作为模型提供商。

新增一个提供商条目,将 api 的值设为 openai-completions,把 baseUrl 指向 Tokios,随后在 models 下填入您所部署的模型信息。
其中的 id(位于 models 下)是您的公共部署名称,即您在 Models 选项卡中注册的名称,而非后端的本地模型 ID。
3

将该模型设为智能体的默认模型。

利用 <provider>/<model-id> 的形式,把智能体的默认模型指向您刚刚添加的提供商。
4

输入相应的 API 密钥。

在环境变量中将 TOKIOS_API_KEY 的值设为您的 sk-tok-… 令牌,而无需直接写入配置文件;随后重启 OpenClaw 以使配置生效。
将 gemma-tunnel 替换为您注册的部署名称,并把 TOKIOS_API_KEY 设为您自己的 sk-tok-… 令牌。切记切勿将真实的令牌内容直接写入配置文件。此外,OpenClaw 亦支持调用 Anthropic 的服务;若您有此需求,只需将 api: "anthropic-messages" 设为 baseUrl: "https://api.tokios.com" 即可(无需设置 /v1)。

你的私人助手,即你的模型

OpenClaw 是你在手机上用来发送指令的智能体;Tokios 则为你正在运行的任意模型提供稳定且经过身份验证的接入端点。该模型旁的连接器会向 Tokios 发起请求,而 OpenClaw 则借助你的 API 密钥调用 https://api.tokios.com/v1,如此一来你的私人助手便能运行在你自行部署的模型之上,且无需开放入站端口或配置 VPN。

故障排查

OpenClaw 发送的 API 密钥内容缺失、格式有误或已被撤销。请确认 TOKIOS_API_KEY 中存储的 sk-tok-… 密钥内容完整且不含多余空白字符,同时前往 Keys 标签页查看该密钥的当前状态。
所填写的上游模型 ID 与已注册的部署信息不匹配,或者 baseUrl 缺少必要的 /v1 信息。请核实 models 中的 ID 是否与 Models 标签页里显示的公开名称一致,同时确认 baseUrl 的值确为 https://api.tokios.com/v1。
对应部署所使用的连接器处于离线状态,或已达到并发处理上限。请查看 Connectors 标签页:该连接器状态应显示为 Online,且运行该连接器的设备也需保持在线且可正常访问。

后续操作

兼容的客户端

关于其他兼容 OpenAI 与 Anthropic 协议的客户端,可参考其基础 URL 与 API 密钥的配置说明。

API 密钥

为团队成员与代理创建、设定权限并轮换 sk-tok-… 类型的 API 密钥。