微信命令

在微信中向 AI 助手发送以下命令，可以控制 iLink Hub 的路由行为。

TIP

这些命令由 Hub 拦截处理，不会传递给 AI 后端。

命令列表

/list — 查看所有客户端

显示所有已注册的后端及其在线状态：

/list

回复示例：

已注册客户端：
  ● mac-home（Mac 本机）—— 在线，最后活跃：2 秒前
  ● server-prod（生产服务器）—— 在线，最后活跃：8 秒前
  ○ openclaw-01（OpenClaw 实例 1）—— 离线，最后活跃：5 分钟前
  
当前活跃：mac-home

/use <name> — 切换活跃后端

将后续所有消息路由到指定客户端：

/use server-prod

Bridge 也是普通客户端

ilink-hub-bridge 注册时同样有一个 --name，例如 local-bridge。只有执行 /use local-bridge 后，微信里的普通消息才会交给该进程上的本地 CLI。

回复示例：

✓ 已切换到：server-prod（生产服务器）

如果指定的客户端不存在或离线，Hub 会提示并保持当前路由不变。

@<name> <消息> — 临时 @ 一个后端（新建会话）

无需先 /use 切换后端，直接 @ 一个后端并发送消息，即可临时在该后端上新建一个会话处理这条消息。这是一种快捷方式，性质与「引用回复」类似：

• 不改变你当前 /use 的后端，也不改变任何后端的活跃会话。
• 每次 @ 都会创建一个全新的会话（名称形如 at-20260614-203012123）。
• 这里的 <name> 与 /use <name> 使用的名称完全一致（可用 /list 查看）。
• 后端名取第一个空格之前的部分，其余内容为消息正文。

@server-prod 帮我看下生产日志最近的报错

如何继续这个临时会话

因为 @ 不会切换当前后端/会话，要在这个临时会话上继续对话，引用该后端的回复再发送即可——Hub 会把后续消息精确路由回这个临时会话。

如果 @ 后面的名称不是已注册的后端，整条消息会被当作普通文本，按当前路由正常发送（不会剥离 @ 前缀）。

/session … — 管理同一后端下的多会话

在当前后端下管理多个并行会话：

/session list              # 列出当前对话的所有 session
/session new <名称> [UUID]  # 新建 session（可选初始 UUID）
/session use <名称>         # 切换活跃 session
/session delete <名称>      # 删除 session

引用回复 — 临时回到某条消息的来源

引用某条机器人消息后再发送内容，会优先路由到发出该条消息的后端及其会话（或重新执行对应的 Hub 指令），无需依赖当前 /use。@<name> 与引用回复都属于此类「临时操作」。

/broadcast <消息> — 向所有在线后端广播

将消息同时发送给所有在线的客户端：

/broadcast 今天有紧急任务，请所有 AI 助手注意

回复示例：

✓ 已广播到 2 个在线客户端：
  - mac-home（Mac 本机）
  - server-prod（生产服务器）

/status — 查看 Hub 状态

显示 Hub 的整体运行状态：

/status

回复示例：

iLink Hub v0.1.4 状态：
  上游连接：已连接
  在线客户端：2 / 3
  消息队列：mac-home(0), server-prod(2), openclaw-01(-)
  运行时间：3 天 2 小时 15 分钟

命令不响应怎么办？

1. 确认 Hub 服务正在运行（/health 端点返回 200）
2. 检查 Hub 日志是否有错误
3. 确认当前账号有已注册的客户端（/list 应该返回列表）

自定义回复

当所有客户端都离线时，Hub 会向微信用户发送友好的提示信息，告知当前无可用 AI 后端。这个回复内容可在未来版本中自定义配置。