clawconnect-agent 0.1.6 → 0.1.8

package/README.md

@@ -27,8 +27,86 @@ clawconnect pair --code-only
 Options:
 - `-n, --name <name>` — Display name for this host
 - `-s, --server <url>` — Relay server URL
+- `-p, --profile <name>` — Local profile name. Use separate profiles when pairing more than one gateway type on the same host
+- `--gateway-type <type>` — Gateway type: `openclaw` or `hermes`
 - `--code-only` — Print only the access code and skip QR code output
 
+### Pair OpenClaw and Hermes Agent on the Same Host
+
+Use separate ClawConnect profiles so OpenClaw and Hermes Agent do not share the same local config, log file, or background service.
+
+Pair OpenClaw:
+
+```bash
+clawconnect pair-openclaw
+```
+
+Pair Hermes Agent:
+
+```bash
+clawconnect pair-hermes
+```
+
+When using the local development relay at `http://127.0.0.1:8080`, add `--local`:
+
+```bash
+clawconnect pair-openclaw --local
+clawconnect pair-hermes --local
+```
+
+The shortcut commands expand to the profile-aware form below.
+
+OpenClaw:
+
+```bash
+clawconnect pair \
+  --profile openclaw \
+  --server http://127.0.0.1:8080 \
+  --gateway-type openclaw \
+  --name "Mac OpenClaw"
+```
+
+Hermes Agent:
+
+```bash
+clawconnect pair \
+  --profile hermes \
+  --server http://127.0.0.1:8080 \
+  --gateway-type hermes \
+  --name "Mac Hermes Agent"
+```
+
+After each command, scan the QR code in the mobile app or enter the printed access code. The pairing payload includes `gatewayType`, and the relay rejects mismatched pairing attempts so an OpenClaw mobile gateway cannot bind to a Hermes Agent host, or the reverse.
+
+Check both instances:
+
+```bash
+clawconnect status-all
+```
+
+Restart or stop a single instance:
+
+```bash
+clawconnect restart-openclaw
+clawconnect restart-hermes
+clawconnect stop-openclaw
+clawconnect stop-hermes
+```
+
+Profile config files:
+
+```text
+~/.clawconnect/profiles/openclaw/config.json
+~/.clawconnect/profiles/hermes/config.json
+```
+
+macOS launchd service labels:
+
+```text
+com.openclaw.clawconnect.agent.openclaw
+com.openclaw.clawconnect.agent.hermes
+```
+
 ### Environment Configuration
 
 For an installed agent, the CLI creates `~/.clawconnect/.env` with all configurable values documented as comments the first time `clawconnect` runs. You can edit that file to keep defaults in one place:
@@ -45,9 +123,10 @@ Supported values:
 - `CLAWCONNECT_GATEWAY_URL` — optional local Gateway websocket URL override
 - `CLAWCONNECT_ENV_FILE` — optional explicit env file path. When unset, the agent reads `~/.clawconnect/.env`, then `.env.local`, then `.env`
 - `OPENCLAW_GATEWAY_TOKEN` / `OPENCLAW_GATEWAY_PASSWORD` — Gateway auth fallback
-- `OPENCLAW_TTS_ENABLED`, `OPENCLAW_TTS_VOICE`, `OPENCLAW_TTS_RATE`, `OPENCLAW_TTS_ENGINE` — voice reply defaults
+- `CLAWCONNECT_ASR_COMMAND` — host-side speech-to-text command for ClawLink `chat.voice.send` messages. The agent saves the audio to a temporary file and runs this command; it must print the transcript to stdout. Placeholders: `{file}`, `{language}`, `{mimeType}`
+- `OPENCLAW_ASR_COMMAND` — legacy speech-to-text command fallback. `CLAWCONNECT_ASR_COMMAND` takes precedence when both are set.
 
-Shell environment variables take priority over env files. Existing pairing credentials in `~/.clawconnect/config.json` still take priority for `clawconnect run`, `status`, and `send-file`; run `clawconnect pair --server <url>` or `clawconnect reset` when you intentionally switch relay servers.
+Shell environment variables take priority over env files. Existing pairing credentials in `~/.clawconnect/config.json` or `~/.clawconnect/profiles/<profile>/config.json` still take priority for `clawconnect run`, `status`, and `send-file`; run `clawconnect pair --profile <name> --server <url>` or `clawconnect reset --profile <name>` when you intentionally switch relay servers.
 
 ### Run
 
@@ -57,13 +136,13 @@ Start the host agent:
 clawconnect run
 ```
 
-Optional: enable assistant voice replies only when you want audio output by setting:
+Optional: let ClawLink send raw voice messages and have the host transcribe them before forwarding text to OpenClaw or Hermes Agent:
 
 ```bash
-OPENCLAW_TTS_ENABLED=1 clawconnect run
+CLAWCONNECT_ASR_COMMAND='/usr/local/bin/transcribe-audio {file} {language}' clawconnect run
 ```
 
-When this flag is not set, assistant replies stay text-only.
+If neither `CLAWCONNECT_ASR_COMMAND` nor legacy `OPENCLAW_ASR_COMMAND` is configured, voice messages fail with `voice_asr_not_configured`.
 
 ### Check Status
 
@@ -167,8 +246,6 @@ Notes:
 - `send-file` uploads through the relay and posts a file message to mobile.
 - Image MIME types render as preview cards in the iPhone chat UI.
 - `chat.send` attachments are local staging references, not the cross-device file transfer path.
-- Voice replies are disabled by default; set `OPENCLAW_TTS_ENABLED=1` to have the agent synthesize assistant replies as audio files.
-- The agent now prefers `edge-tts-universal` for synthesis and falls back to the computer's built-in TTS on failure.
 
 ## Project Structure
 
@@ -188,34 +265,58 @@ clawconnect-agent/
       status.ts
       install.ts
       set-token.ts
-      local-handlers.ts
-      local-runtime.ts
-      provider-handlers.ts
-      provider-config.ts
-      provider-registry.ts
-      backup-manager.ts
-      send-file-utils.ts
       *.test.ts
+    core/
+      command-types.ts
+      relay/
+        file-upload.ts
+        file-upload-utils.ts
+        relay-server-connection.ts
+        reconnect.ts
+        office-payload.ts
+        mobile-chat-run-bridge.ts
+        voice-input.ts
+        attachment-staging.ts
+        chat-payload.ts
+        slash-command-types.ts
     config/
       config.ts
       env.ts
+    hermes/
+      hermes-relay-manager.ts
+      hermes-runtime.ts
+      hermes-session-store.ts
+      hermes-voice-input.ts
+      runtime/
+        hermes-runtime-*.ts
     i18n/
       index.ts
+    openclaw/
+      relay-manager.ts
+      gateway-client.ts
+      session-store.ts
+      runtime/
+        local-runtime.ts
+      handlers/
+        local-handlers.ts
+        provider-handlers.ts
+      config/
+        provider-config.ts
+        provider-registry.ts
+      backups/
+        backup-manager.ts
+      relay/
+        session-context.ts
+        chat-history.ts
+        chat-send-attachments.ts
+        openclaw-voice-input.ts
+        slash-command-catalog.ts
+        slash-command-catalog.generated.ts
     platform/
       service-manager.ts
       service-manager-common.ts
       service-manager-linux.ts
       *.test.ts
-    relay/
-      gateway-client.ts
-      relay-manager.ts
-      session-context.ts
-      chat-payload.ts
-      chat-history.ts
-      attachment-staging.ts
-      chat-send-attachments.ts
-      reconnect.ts
-      *.test.ts
 ```
 
 Tests are colocated with the source as `*.test.ts`. They run with `npm test`, and the build/publish flow excludes them from the package tarball.
@@ -225,18 +326,23 @@ Tests are colocated with the source as `*.test.ts`. They run with `npm test`, an
 - `src/index.ts` is the CLI entrypoint. It wires every command together and handles top-level errors.
 - `src/commands/pair.ts` registers a host, saves relay config, and installs the background service after pairing.
 - `src/commands/run.ts` starts the relay loop in the foreground for service-managed or debug runs.
-- `src/commands/send-file.ts` uploads local files or images into the paired chat session.
+- `src/commands/send-file.ts` is the CLI wrapper for uploading local files or images into the paired chat session.
 - `src/commands/install.ts` manages service install, restart, stop, uninstall, and reset flows.
 - `src/commands/set-token.ts` stores a local Gateway token when token auth is required.
-- `src/commands/local-handlers.ts` handles legacy command prefixes and local maintenance actions such as backup, restore, logs, doctor, and gateway restart.
-- `src/commands/local-runtime.ts` resolves the `openclaw` binary and triggers gateway lifecycle actions.
-- `src/commands/provider-handlers.ts` routes provider-specific commands and reuses the same gateway restart path.
+- `src/core/relay/file-upload.ts` contains the programmatic relay file upload client used by both CLI and Hermes artifact delivery.
+- `src/core/relay/relay-server-connection.ts` contains shared relay URL, JSON frame, abort, and retry-close helpers.
+- `src/core/relay/office-payload.ts`, `mobile-chat-run-bridge.ts`, `voice-input.ts`, `attachment-staging.ts`, and `chat-payload.ts` are gateway-neutral relay utilities.
+- `src/openclaw/handlers/local-handlers.ts` handles legacy command prefixes and local maintenance actions such as backup, restore, logs, doctor, and gateway restart.
+- `src/openclaw/runtime/local-runtime.ts` resolves the `openclaw` binary and triggers gateway lifecycle actions.
+- `src/openclaw/handlers/provider-handlers.ts` routes provider-specific commands and reuses the same gateway restart path.
+- `src/openclaw/relay-manager.ts` bridges the relay server and the local OpenClaw Gateway, dispatches commands, and handles chat/history fallbacks.
+- `src/openclaw/gateway-client.ts` manages the websocket connection to OpenClaw Gateway and device authentication.
+- `src/openclaw/relay/session-context.ts` reads session defaults and context usage snapshots.
+- `src/openclaw/relay/chat-history.ts` and `chat-send-attachments.ts` handle OpenClaw-specific history fallback and attachment staging for `chat.send`.
+- `src/hermes/hermes-relay-manager.ts` bridges Hermes runtime commands to the relay server.
+- `src/hermes/runtime/` contains Hermes CLI/Python execution modules for chat, cron, skills, models, sessions, usage, and lifecycle operations.
 - `src/config/env.ts` loads `.env` files and exposes agent defaults such as relay and Gateway URLs.
 - `src/platform/service-manager.ts` exposes a cross-platform service facade for macOS, Linux, and Windows.
-- `src/relay/relay-manager.ts` bridges the relay server and the local Gateway, dispatches commands, and handles chat/history fallbacks.
-- `src/relay/gateway-client.ts` manages the websocket connection to OpenClaw Gateway and device authentication.
-- `src/relay/session-context.ts` reads session defaults and context usage snapshots.
-- `src/relay/chat-payload.ts`, `src/relay/chat-history.ts`, `src/relay/attachment-staging.ts`, and `src/relay/chat-send-attachments.ts` handle chat normalization, fallback, and attachment staging.
 - `src/config/config.ts` reads and writes local pairing config under `~/.clawconnect`.
 - `src/i18n/index.ts` contains the localized CLI strings.
 
@@ -244,15 +350,17 @@ Tests are colocated with the source as `*.test.ts`. They run with `npm test`, an
 
 - `pairCommand()` registers a host, generates the pairing payload, and persists relay config.
 - `runCommand()` starts the foreground relay client loop used by the background service.
-- `sendFileCommand()` stages a local file and uploads it into the paired chat session.
+- `sendFileCommand()` handles CLI config/session defaults and delegates uploads to `uploadFileToRelay()`.
+- `uploadFileToRelay()` uploads a file to the relay using explicit relay URL, secret, gateway ID, and session key.
 - `installCommand()`, `restartCommand()`, `stopCommand()`, `uninstallCommand()`, and `resetCommand()` manage the service lifecycle.
 - `statusCommand()` prints pairing config, gateway state, and service health.
 - `setTokenCommand()` stores the local OpenClaw Gateway token.
-- `handleLocalCommand()` and `handleProviderCommand()` process local control-plane commands before forwarding to the gateway.
+- `handleLocalCommand()` and `handleProviderCommand()` process OpenClaw local control-plane commands before forwarding to the gateway.
 - `OpenClawGatewayClient` manages the gateway websocket, reconnects, and request/response frames.
 - `canonicalizeRelayParams()`, `extractGatewaySessionDefaults()`, and `buildContextUsageFingerprint()` normalize relay protocol payloads.
 - `normalizeChatEventPayload()`, `extractChatText()`, `extractHistoryOutcome()`, and `withMessageText()` keep chat payloads stable across relay and gateway responses.
 - `buildAttachmentStagingPath()` and `resolveAttachmentFileName()` manage file staging for attachments.
+- `buildRelayUrl()`, `sendRelayJson()`, `parseRelayFrame()`, and `shouldRetryRelayClose()` share narrow relay transport behavior across OpenClaw and Hermes.
 - `getServiceStatus()`, `installService()`, `restartService()`, `stopService()`, and `uninstallService()` implement platform-specific service control.
 
 ## How It Works

package/README.zh-CN.md

@@ -34,8 +34,86 @@ clawconnect pair --code-only
 
 - `-n, --name <name>`：指定这台主机在移动端显示的名称
 - `-s, --server <url>`：指定中继服务器地址
+- `-p, --profile <name>`：指定本机配置 profile；同一台主机同时配对 OpenClaw 和 Hermes Agent 时必须分开
+- `--gateway-type <type>`：指定网关类型，可选 `openclaw` 或 `hermes`
 - `--code-only`：只输出访问码，不打印二维码
 
+### 2. 同时配对 OpenClaw 和 Hermes Agent
+
+同一台电脑上同时运行 OpenClaw 和 Hermes Agent 时，必须使用不同的 `--profile`。这样两条链路会使用不同的本地配置、日志和后台服务，避免 OpenClaw 与 Hermes Agent 串到一起。
+
+配对 OpenClaw：
+
+```bash
+clawconnect pair-openclaw
+```
+
+配对 Hermes Agent：
+
+```bash
+clawconnect pair-hermes
+```
+
+如果使用本地开发 Relay `http://127.0.0.1:8080`，加一个 `--local` 即可：
+
+```bash
+clawconnect pair-openclaw --local
+clawconnect pair-hermes --local
+```
+
+上面的快捷命令等价于下面的完整写法。
+
+OpenClaw：
+
+```bash
+clawconnect pair \
+  --profile openclaw \
+  --server http://127.0.0.1:8080 \
+  --gateway-type openclaw \
+  --name "Mac OpenClaw"
+```
+
+Hermes Agent：
+
+```bash
+clawconnect pair \
+  --profile hermes \
+  --server http://127.0.0.1:8080 \
+  --gateway-type hermes \
+  --name "Mac Hermes Agent"
+```
+
+每条命令执行后，使用移动端扫码，或在移动端输入终端打印的配对码。配对 payload 会带上 `gatewayType`，Relay 会校验手机端请求的类型和主机注册的类型是否一致；类型不一致会拒绝绑定，避免 OpenClaw 手机网关绑定到 Hermes Agent 主机，或反过来绑定错误。
+
+查看两个实例：
+
+```bash
+clawconnect status-all
+```
+
+单独重启或停止某一个实例：
+
+```bash
+clawconnect restart-openclaw
+clawconnect restart-hermes
+clawconnect stop-openclaw
+clawconnect stop-hermes
+```
+
+本机配置文件位置：
+
+```text
+~/.clawconnect/profiles/openclaw/config.json
+~/.clawconnect/profiles/hermes/config.json
+```
+
+macOS 后台服务名：
+
+```text
+com.openclaw.clawconnect.agent.openclaw
+com.openclaw.clawconnect.agent.hermes
+```
+
 ### 环境配置
 
 本地安装后的 agent 会在第一次运行 `clawconnect` 时自动创建 `~/.clawconnect/.env`，里面会用注释列出所有可配置项。你可以直接编辑这个文件集中维护默认配置：
@@ -52,11 +130,12 @@ $EDITOR ~/.clawconnect/.env
 - `CLAWCONNECT_GATEWAY_URL`：可选，本机 OpenClaw Gateway WebSocket 地址覆盖值
 - `CLAWCONNECT_ENV_FILE`：可选，显式指定 env 文件路径；未设置时会依次读取 `~/.clawconnect/.env`、`.env.local`、`.env`
 - `OPENCLAW_GATEWAY_TOKEN` / `OPENCLAW_GATEWAY_PASSWORD`：Gateway 鉴权兜底值
-- `OPENCLAW_TTS_ENABLED`、`OPENCLAW_TTS_VOICE`、`OPENCLAW_TTS_RATE`、`OPENCLAW_TTS_ENGINE`：语音回复默认值
+- `CLAWCONNECT_ASR_COMMAND`：宿主机语音转文字命令。ClawLink 发送 `chat.voice.send` 后，agent 会把音频保存到临时文件，并执行这个命令；命令必须把识别文本输出到 stdout。可用占位符：`{file}`、`{language}`、`{mimeType}`
+- `OPENCLAW_ASR_COMMAND`：旧版语音转文字命令兜底值；同时设置时优先使用 `CLAWCONNECT_ASR_COMMAND`
 
-Shell 里已经设置的环境变量优先级高于 env 文件。`clawconnect run`、`status`、`send-file` 会继续使用 `~/.clawconnect/config.json` 里已配对保存的 relay；如果要切换中继服务器，请执行 `clawconnect pair --server <url>` 或 `clawconnect reset`。
+Shell 里已经设置的环境变量优先级高于 env 文件。`clawconnect run`、`status`、`send-file` 会继续使用 `~/.clawconnect/config.json` 或 `~/.clawconnect/profiles/<profile>/config.json` 里已配对保存的 relay；如果要切换中继服务器，请执行 `clawconnect pair --profile <name> --server <url>` 或 `clawconnect reset --profile <name>`。
 
-### 2. 前台运行
+### 3. 前台运行
 
 以当前终端前台方式启动代理：
 
@@ -66,15 +145,15 @@ clawconnect run
 
 适合调试中继连接、本地 Gateway 鉴权和日志输出。
 
-如果需要语音播报助手回复，可以显式开启：
+如果需要让手机端直接发送语音、由宿主机识别后再转发给 OpenClaw 或 Hermes Agent，请配置本机 ASR 命令：
 
 ```bash
-OPENCLAW_TTS_ENABLED=1 clawconnect run
+CLAWCONNECT_ASR_COMMAND='/usr/local/bin/transcribe-audio {file} {language}' clawconnect run
 ```
 
-未设置这个开关时，助手回复保持纯文字。
+未配置 `CLAWCONNECT_ASR_COMMAND`，且也没有旧版 `OPENCLAW_ASR_COMMAND` 兜底时，宿主机收到语音消息会返回 `voice_asr_not_configured`。
 
-### 3. 查看状态
+### 4. 查看状态
 
 查看当前配对信息、网关地址和后台服务状态：
 
@@ -82,7 +161,7 @@ OPENCLAW_TTS_ENABLED=1 clawconnect run
 clawconnect status
 ```
 
-### 4. 安装后台服务
+### 5. 安装后台服务
 
 将代理安装成后台常驻服务：
 
@@ -109,7 +188,7 @@ clawconnect install
 bash ~/.clawconnect/clawconnect-start.sh
 ```
 
-### 5. 停止服务
+### 6. 停止服务
 
 停止后台代理服务：
 
@@ -117,7 +196,7 @@ bash ~/.clawconnect/clawconnect-start.sh
 clawconnect stop
 ```
 
-### 6. 重启服务
+### 7. 重启服务
 
 重启后台代理服务：
 
@@ -125,7 +204,7 @@ clawconnect stop
 clawconnect restart
 ```
 
-### 7. 设置 Gateway Token
+### 8. 设置 Gateway Token
 
 当本机 Gateway 使用 token 鉴权时，可以手动保存 token：
 
@@ -133,7 +212,7 @@ clawconnect restart
 clawconnect set-token
 ```
 
-### 8. 卸载服务
+### 9. 卸载服务
 
 移除后台服务定义，但保留本地配置：
 
@@ -141,7 +220,7 @@ clawconnect set-token
 clawconnect uninstall
 ```
 
-### 9. 重置配对
+### 10. 重置配对
 
 停止服务并清除本地配对配置：
 
@@ -149,7 +228,7 @@ clawconnect uninstall
 clawconnect reset
 ```
 
-### 10. 升级到最新版本
+### 11. 升级到最新版本
 
 升级全局 npm 安装的包；如果已安装后台服务，会在升级成功后自动重启服务：
 
@@ -163,7 +242,7 @@ clawconnect update
 - 如果你当前运行的是本地源码目录，而不是全局 npm 安装，这个命令只会升级全局包
 - 如果你的 npm 全局目录需要更高权限，请按终端提示手动执行对应命令
 
-### 11. 发送文件/图片
+### 12. 发送文件/图片
 
 把本地图片或其他文件发到已配对的聊天会话：
 
@@ -182,8 +261,6 @@ clawconnect send-file ~/Pictures/demo.jpg
 - `send-file` 会先把文件上传到 relay，再把文件消息发到手机端。
 - 图片类型会在 iPhone 聊天里显示预览图，其他类型则显示文件卡片。
 - `chat.send` 的 `attachments` 目前只是本地落盘引用，不是跨设备文件传输入口。
-- 默认不启用语音回复；只有设置 `OPENCLAW_TTS_ENABLED=1` 时，agent 才会把助手回复合成为音频文件。
-- 语音合成优先使用 `edge-tts-universal`，如果生成失败则回退到电脑自带的 TTS。
 
 ## 代码结构
 
@@ -203,34 +280,58 @@ clawconnect-agent/
       status.ts               查看配对与服务状态
       install.ts              install / restart / stop / uninstall / reset
       set-token.ts            手动保存 Gateway Token
-      local-handlers.ts       兼容旧命令前缀和本地维护命令
-      local-runtime.ts        解析 OpenClaw 可执行文件并触发网关生命周期
-      provider-handlers.ts    provider 命令分发和网关重启
-      provider-config.ts      provider 配置读写
-      provider-registry.ts    provider 注册信息
-      backup-manager.ts       本地配置备份管理
-      send-file-utils.ts      relay 地址和文件传输辅助
       *.test.ts               紧邻源码的单元测试
+    core/
+      command-types.ts        共享本地命令结果和上下文类型
+      relay/
+        file-upload.ts              纯 relay 文件上传服务
+        file-upload-utils.ts        relay 地址和文件传输辅助
+        relay-server-connection.ts  relay URL、JSON 帧、abort 和 close retry 辅助
+        reconnect.ts                重连策略
+        office-payload.ts           office/status payload 构造
+        mobile-chat-run-bridge.ts   移动端 chat run payload 转换
+        voice-input.ts              共享语音输入 / ASR 参数处理
+        attachment-staging.ts       附件 MIME 和暂存路径辅助
+        chat-payload.ts             聊天 payload 归一化
+        slash-command-types.ts      slash command 共享类型
     config/
       config.ts               配对配置读写
       env.ts                  env 文件加载和 agent 默认配置
+    hermes/
+      hermes-relay-manager.ts Hermes relay 桥接
+      hermes-runtime.ts       Hermes runtime 聚合入口
+      hermes-session-store.ts Hermes 会话别名存储
+      hermes-voice-input.ts   Hermes 语音输入适配
+      runtime/
+        hermes-runtime-*.ts   Hermes CLI/Python、chat、cron、skills、models、usage 等执行模块
     i18n/
       index.ts                CLI 文案
+    openclaw/
+      relay-manager.ts        OpenClaw 中继服务器桥接与命令分发
+      gateway-client.ts       连接并认证本地 OpenClaw Gateway
+      session-store.ts        OpenClaw 最新会话推断
+      runtime/
+        local-runtime.ts      解析 OpenClaw 可执行文件并触发网关生命周期
+      handlers/
+        local-handlers.ts     兼容旧命令前缀和本地维护命令
+        provider-handlers.ts  provider 命令分发和网关重启
+      config/
+        provider-config.ts    provider 配置读写
+        provider-registry.ts  provider 注册信息
+      backups/
+        backup-manager.ts     本地配置备份管理
+      relay/
+        session-context.ts    会话默认值和上下文使用量快照
+        chat-history.ts       历史消息回退
+        chat-send-attachments.ts 发送带附件消息的参数准备
+        openclaw-voice-input.ts  OpenClaw 语音命令适配
+        slash-command-catalog.ts OpenClaw slash command 目录
+        slash-command-catalog.generated.ts 生成的 OpenClaw slash command 目录
     platform/
       service-manager.ts              跨平台服务入口
       service-manager-common.ts       通用平台辅助常量
       service-manager-linux.ts        Linux systemd/nohup 逻辑
       *.test.ts                       平台层单元测试
-    relay/
-      gateway-client.ts       连接并认证本地 OpenClaw Gateway
-      relay-manager.ts        中继服务器桥接与命令分发
-      session-context.ts      会话默认值和上下文使用量快照
-      chat-payload.ts         聊天 payload 归一化
-      chat-history.ts         历史消息回退
-      attachment-staging.ts   附件本地落盘
-      chat-send-attachments.ts 发送带附件消息的参数准备
-      reconnect.ts            重连策略
-      *.test.ts               relay 层单元测试
 ```
 
 测试文件和源码采用邻近放置的方式，统一以 `*.test.ts` 命名。它们会被 `npm test` 执行，但不会进入发布包。
@@ -240,18 +341,23 @@ clawconnect-agent/
 - `src/index.ts` 是 CLI 入口，负责命令注册和顶层错误处理。
 - `src/commands/pair.ts` 负责主机配对、保存 relay 配置，并在配对后安装后台服务。
 - `src/commands/run.ts` 负责前台启动 relay 循环，供服务管理或调试使用。
-- `src/commands/send-file.ts` 负责把本地文件或图片上传到已配对的聊天会话。
+- `src/commands/send-file.ts` 是发送本地文件或图片到已配对聊天会话的 CLI wrapper。
 - `src/commands/install.ts` 负责后台服务的安装、重启、停止、卸载和重置。
 - `src/commands/set-token.ts` 负责在需要 token 鉴权时保存本地 Gateway Token。
-- `src/commands/local-handlers.ts` 负责兼容旧命令前缀，以及备份、恢复、日志、doctor、gateway 重启等本地维护命令。
-- `src/commands/local-runtime.ts` 负责解析 `openclaw` 可执行文件并触发网关生命周期动作。
-- `src/commands/provider-handlers.ts` 负责 provider 专属命令分发，并复用同一套 gateway 重启逻辑。
+- `src/core/relay/file-upload.ts` 是纯程序化 relay 文件上传服务，供 CLI 和 Hermes artifact delivery 复用。
+- `src/core/relay/relay-server-connection.ts` 提供共享 relay URL、JSON 帧、abort close 和 close retry 判断。
+- `src/core/relay/office-payload.ts`、`mobile-chat-run-bridge.ts`、`voice-input.ts`、`attachment-staging.ts`、`chat-payload.ts` 是 gateway-neutral 的 relay 工具。
+- `src/openclaw/handlers/local-handlers.ts` 负责兼容旧命令前缀，以及备份、恢复、日志、doctor、gateway 重启等本地维护命令。
+- `src/openclaw/runtime/local-runtime.ts` 负责解析 `openclaw` 可执行文件并触发网关生命周期动作。
+- `src/openclaw/handlers/provider-handlers.ts` 负责 provider 专属命令分发，并复用同一套 gateway 重启逻辑。
+- `src/openclaw/relay-manager.ts` 负责中继服务器与本地 OpenClaw Gateway 的桥接、命令分发，以及 chat/history 回退处理。
+- `src/openclaw/gateway-client.ts` 负责连接 OpenClaw Gateway，并处理设备身份认证。
+- `src/openclaw/relay/session-context.ts` 负责读取会话默认值和上下文使用量快照。
+- `src/openclaw/relay/chat-history.ts`、`chat-send-attachments.ts` 负责 OpenClaw 专属历史回退和 `chat.send` 附件暂存。
+- `src/hermes/hermes-relay-manager.ts` 负责 Hermes runtime 与 relay server 的桥接。
+- `src/hermes/runtime/` 放置 Hermes CLI/Python、chat、cron、skills、models、sessions、usage 和 lifecycle 等执行模块。
 - `src/config/env.ts` 负责加载 `.env` 文件，并集中维护 relay、Gateway 等 agent 默认配置。
 - `src/platform/service-manager.ts` 负责 macOS、Linux 和 Windows 的跨平台服务管理入口。
-- `src/relay/relay-manager.ts` 负责中继服务器与本地 Gateway 的桥接、命令分发，以及 chat/history 回退处理。
-- `src/relay/gateway-client.ts` 负责连接 OpenClaw Gateway，并处理设备身份认证。
-- `src/relay/session-context.ts` 负责读取会话默认值和上下文使用量快照。
-- `src/relay/chat-payload.ts`、`src/relay/chat-history.ts`、`src/relay/attachment-staging.ts`、`src/relay/chat-send-attachments.ts` 负责聊天数据归一化、历史回退和附件暂存。
 - `src/config/config.ts` 负责读写 `~/.clawconnect` 下的本地配对配置。
 - `src/i18n/index.ts` 负责 CLI 文案。
 
@@ -259,15 +365,17 @@ clawconnect-agent/
 
 - `pairCommand()` 负责主机配对、生成配对 payload，并持久化 relay 配置。
 - `runCommand()` 负责启动前台 relay 客户端循环，供后台服务使用。
-- `sendFileCommand()` 负责暂存本地文件并上传到已配对的聊天会话。
+- `sendFileCommand()` 负责 CLI 配置、会话默认值和输出格式，并委托 `uploadFileToRelay()` 上传。
+- `uploadFileToRelay()` 使用显式 relay URL、secret、gateway ID 和 session key 上传文件。
 - `installCommand()`、`restartCommand()`、`stopCommand()`、`uninstallCommand()`、`resetCommand()` 负责服务生命周期管理。
 - `statusCommand()` 负责打印配对配置、Gateway 状态和服务健康信息。
 - `setTokenCommand()` 负责保存本地 OpenClaw Gateway Token。
-- `handleLocalCommand()` 和 `handleProviderCommand()` 负责在转发前处理本地控制平面命令。
+- `handleLocalCommand()` 和 `handleProviderCommand()` 负责在转发前处理 OpenClaw 本地控制平面命令。
 - `OpenClawGatewayClient` 负责管理 Gateway WebSocket、重连和请求/响应帧。
 - `canonicalizeRelayParams()`、`extractGatewaySessionDefaults()`、`buildContextUsageFingerprint()` 负责统一 relay 协议 payload。
 - `normalizeChatEventPayload()`、`extractChatText()`、`extractHistoryOutcome()`、`withMessageText()` 负责稳定聊天事件与历史回退结果。
 - `buildAttachmentStagingPath()` 和 `resolveAttachmentFileName()` 负责附件暂存路径和文件名处理。
+- `buildRelayUrl()`、`sendRelayJson()`、`parseRelayFrame()`、`shouldRetryRelayClose()` 负责 OpenClaw 和 Hermes 共享的窄 relay transport 行为。
 - `getServiceStatus()`、`installService()`、`restartService()`、`stopService()`、`uninstallService()` 负责跨平台服务控制。
 
 ## 工作原理

package/dist/commands/install.js

@@ -1,11 +1,11 @@
 import { existsSync, unlinkSync } from "fs";
 import { execFileSync } from "child_process";
-import { join } from "path";
-import { homedir } from "os";
 import { t } from "../i18n/index.js";
-import { getServicePlatform, getServiceStatus, installService, restartService, setRestrictiveFilePermissions, stopService, uninstallService, servicePaths, } from "../platform/service-manager.js";
+import { getServicePlatform, getServiceStatus, getServicePaths, installService, restartService, setRestrictiveFilePermissions, stopService, uninstallService, } from "../platform/service-manager.js";
+import { profileConfigPath, profileDisplayName } from "../config/profile.js";
 export function isInstalled() {
     const platform = getServicePlatform();
+    const servicePaths = getServicePaths();
     if (platform === "macos")
         return existsSync(servicePaths.macPlistPath);
     if (platform === "linux") {
@@ -32,9 +32,11 @@ export function installCommand() {
     const started = installService();
     if (started) {
         const service = getServiceStatus();
+        console.log(`Profile: ${profileDisplayName(servicePathsProfile())}`);
         console.log(t("install.serviceStarted", service.manager));
         return;
     }
+    const servicePaths = getServicePaths();
     console.log(t("install.installFailed", platformName(platform)));
     if (platform === "macos") {
         console.log(t("install.serviceFileWritten", servicePaths.macPlistPath));
@@ -92,7 +94,7 @@ export function stopCommand() {
 }
 export function resetCommand() {
     stopCommand();
-    const configPath = join(homedir(), ".clawconnect", "config.json");
+    const configPath = profileConfigPath();
     if (existsSync(configPath)) {
         try {
             if (process.platform === "win32") {
@@ -112,6 +114,10 @@ export function resetCommand() {
     }
     console.log(t("install.resetComplete"));
 }
+function servicePathsProfile() {
+    const profile = getServicePaths().profile;
+    return profile === "default" ? undefined : profile;
+}
 function platformName(platform) {
     switch (platform) {
         case "macos":

package/dist/commands/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"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"}

package/dist/commands/pair.d.ts

@@ -1,7 +1,13 @@
+import { type ClawConnectConfig } from "../config/config.js";
 interface PairOptions {
     server?: string;
     name?: string;
     codeOnly?: boolean;
+    gatewayType?: string;
+    profile?: string;
 }
 export declare function pairCommand(opts: PairOptions): Promise<void>;
+export declare function sameRelayServer(left: string, right: string): boolean;
+export declare function shouldReuseExistingPairing(config: ClawConnectConfig | null, gatewayType: "openclaw" | "hermes", requestedRelayServerUrl: string): boolean;
+export declare function normalizeRelayServerIdentity(relayServerUrl: string): string;
 export {};