ANTHROPIC_BASE_URL 设为 https://api.tokios.com,NanoClaw 代理即可在您本地硬件上运行所需模型。
前置条件
连接器已配对
在您希望 NanoClaw 访问的模型所在位置安装并配对
tokios-connector。上游模型已注册
为该模型设定一个公开名称作为部署标识。
API 密钥已生成
生成一个
sk-tok-… 类型的令牌,也可限定其仅适用于特定部署环境。支持的后端服务
请确认您本地的后端服务(Ollama、llama.cpp、vLLM 或 LM Studio)正在正常运行。
将 NanoClaw 的后端指向 Tokios。
1
打开 NanoClaw 的 .env 配置文件。
编辑 NanoClaw 安装目录下的
.env 文件。2
设置 Anthropic 的基础 URL 以及相应的 API 密钥。
将 Claude Agent SDK 的后端指向 Tokios:将您的
.env
sk-tok-… 令牌填入 ANTHROPIC_AUTH_TOKEN 处,该令牌即 SDK 发送的请求凭证。基础 URL 中无需添加 /v1。3
选用您已部署的模型作为运行模型。
将代理的模型设置为公共部署名称,即您在 Models 选项卡中注册的名称——例如
gemma-tunnel。NanoClaw 默认使用 Claude 模型名称;当它指向 Tokios 时,所请求的模型必须是您的部署名称。每个代理组的具体模型设置因 NanoClaw 版本而异——请检查您的版本。4
重启 NanoClaw。
重启 NanoClaw 或其容器,使其重新加载
.env 配置。此时该代理便能通过 Tokios 运行您指定的模型了。NanoClaw 还能借助可选连接器来调用与 OpenAI 兼容的本地后端服务,比如用于连接 OpenAI/OpenRouter 的
/add-opencode 或 /add-ollama-provider。在此类场景下,请使用 OpenAI 基础配置项 https://api.tokios.com/v1。切记切勿将真实的 sk-tok-… 令牌直接写入版本控制系统。基于私有模型的私有代理
NanoClaw 会将 Claude 代理程序运行在您本地机器上的独立容器中;而 Tokios 则能为您所运行的任何模型提供稳定且经过身份验证的访问端点。该模型旁的连接器会向 Tokios 发起请求,NanoClaw 则通过https://api.tokios.com 地址配合您的令牌实现通信——如此便形成了一个完全自托管、无需开放入站端口或 VPN 的智能助手系统。
故障排查
401 错误
401 错误
NanoClaw 发送的令牌内容缺失、格式有误或已被撤销。请确认
ANTHROPIC_AUTH_TOKEN 内确实包含完整的 sk-tok-… 令牌且不含多余空白字符,随后前往 Keys 页面查看该令牌的当前状态。404 错误
404 错误
所选模型与已注册的部署配置不匹配,或者基础 URL 中混入了不该出现的
/v1 字符。请核实该模型名称是否确为您在 Models 页面设定的公开部署名称,同时确保 ANTHROPIC_BASE_URL 内容仅为纯粹的 https://api.tokios.com 值且不含任何 /v1 字符。503 错误
503 错误
对应部署所使用的连接器处于离线状态或已达到并发上限。请查看 Connectors 页面:该连接器状态应显示为 Online,且运行该连接器的服务器也必须处于正常运行且可访问状态。
后续操作
使用 Claude Code
对于 Claude Code CLI 而言,所使用的兼容 Anthropic 的基础 URL 与 API 密钥格式均保持一致。
API 密钥
为团队成员与各类代理创建、设定权限范围并定期轮换
sk-tok-… 类型的令牌。