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。
故障排查
401 错误
401 错误
OpenClaw 发送的 API 密钥内容缺失、格式有误或已被撤销。请确认
TOKIOS_API_KEY 中存储的 sk-tok-… 密钥内容完整且不含多余空白字符,同时前往 Keys 标签页查看该密钥的当前状态。404 错误
404 错误
所填写的上游模型 ID 与已注册的部署信息不匹配,或者
baseUrl 缺少必要的 /v1 信息。请核实 models 中的 ID 是否与 Models 标签页里显示的公开名称一致,同时确认 baseUrl 的值确为 https://api.tokios.com/v1。503 错误
503 错误
对应部署所使用的连接器处于离线状态,或已达到并发处理上限。请查看 Connectors 标签页:该连接器状态应显示为 Online,且运行该连接器的设备也需保持在线且可正常访问。
后续操作
兼容的客户端
关于其他兼容 OpenAI 与 Anthropic 协议的客户端,可参考其基础 URL 与 API 密钥的配置说明。
API 密钥
为团队成员与代理创建、设定权限并轮换
sk-tok-… 类型的 API 密钥。