跳转到主要内容
NanoClaw 是一款轻量级的容器化个人 AI 代理,属于 OpenClaw 的简化版。它能连接 WhatsApp、Telegram、Slack、Discord 以及电子邮件,还具备记忆与定时任务功能。该代理基于 Anthropic 的 Claude Agent SDK 运行,因此需通过 兼容 Anthropic 协议 的接口与 Tokios 相连:只需将 ANTHROPIC_BASE_URL 设为 https://api.tokios.com,NanoClaw 代理即可在您本地硬件上运行所需模型。
NanoClaw 调用的是 Anthropic 的 API 接口,因此基础 URL 只需填写主机地址 https://api.tokios.com,无需填写 /v1——这一规则与 Claude Code 的设置方式一致。这与那些需要配置 /v1 参数的 OpenAI 风格客户端截然不同。

前置条件

连接器已配对

在您希望 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 的智能助手系统。

故障排查

NanoClaw 发送的令牌内容缺失、格式有误或已被撤销。请确认 ANTHROPIC_AUTH_TOKEN 内确实包含完整的 sk-tok-… 令牌且不含多余空白字符,随后前往 Keys 页面查看该令牌的当前状态。
所选模型与已注册的部署配置不匹配,或者基础 URL 中混入了不该出现的 /v1 字符。请核实该模型名称是否确为您在 Models 页面设定的公开部署名称,同时确保 ANTHROPIC_BASE_URL 内容仅为纯粹的 https://api.tokios.com 值且不含任何 /v1 字符。
对应部署所使用的连接器处于离线状态或已达到并发上限。请查看 Connectors 页面:该连接器状态应显示为 Online,且运行该连接器的服务器也必须处于正常运行且可访问状态。

后续操作

使用 Claude Code

对于 Claude Code CLI 而言,所使用的兼容 Anthropic 的基础 URL 与 API 密钥格式均保持一致。

API 密钥

为团队成员与各类代理创建、设定权限范围并定期轮换 sk-tok-… 类型的令牌。