@cutie-crypto/connector

Bridge between your local OpenClaw / Hermes agent and the Cutie platform.

Cutie 平台 是 KOL AI 分身的通道层。本 Connector 解决"KOL 的 AI 不能暴露公网 API，但 Cutie 平台需要调用它"的问题：connector 在 KOL 本机常驻，主动出站连接 Cutie Server，下发任务后转给本地 AI gateway 处理。

Install

npm install -g @cutie-crypto/connector

connector-core 是依赖项，npm 会自动拉取，无需手动安装。

Quick start

# 1. 在 Cutie App 拿到 pair_token
# 2. 一键 setup（自动检测 OpenClaw / Hermes）
cutie-connector setup --pair-token ptk_xxx

# 3. 启动
cutie-connector start

Supported platforms

| 平台 | 配置文件 | gateway 默认端口 | 默认模型 | gateway secret 来源 | |------|---------|----------------|---------|---------------------| | OpenClaw | ~/.openclaw/openclaw.json | 18789 | openclaw:cutie | gateway.auth.token | | Hermes (Nous Research) | ~/.hermes/config.yaml + ~/.hermes/.env | 8642 | hermes-agent | ~/.hermes/.env API_SERVER_KEY |

OpenClaw 的 agent_model 决定路由到哪个 agent（openclaw:cutie / openclaw:main）。 Hermes 没有"多 agent 路由"概念——profile 自身就是 agent，model 字段填 profile 名。

Commands

| Command | Description | |---------|-------------| | setup --pair-token ptk_xxx | 一键配置（注册 + 写 workspace + 启 gateway + 装 service） | | setup --pair-token ptk_xxx --platform hermes\|openclaw | 显式指定平台 | | start | 启动连接器（首次需要 --pair-token） | | start --platform hermes | 显式指定平台（默认自动检测） | | status | 显示当前连接器状态（platform / gateway / agent_model） | | sync | 手动触发人格同步（OpenClaw 主 agent → cutie agent workspace） | | reset | 删除配置，重新配对 |

环境变量替代 --platform：CUTIE_AGENT_PLATFORM=hermes cutie-connector start

Configuration

• 配置文件：~/.cutie-connector/config.json（mode 0600，自动迁移旧字段 openclaw_url / openclaw_secret 到 gateway_url / gateway_secret）
• 日志：stdout / stderr 由 supervisor（systemd / launchd）收集

Auto-upgrade

connector 收到 server 下发的 upgrade_required=true 时自动跑 npm install -g @cutie-crypto/connector@<target>，systemd Restart=always 接管重启。无 root 时回退到本地自安装路径 ~/.cutie-connector/pkg/。

Architecture

connector 是 @cutie-crypto/connector-core 的 adapter 实现。core 不假设平台命名 / 进程管理 / 网络协议，本包提供：

• OpenClawPlatform / HermesPlatform — PlatformAdapter 实现
• callAgentGateway — 本地 AI gateway HTTP 调用（OpenAI Responses API 兼容）
• CLI 入口（cutie-connector bin）

License

MIT