sophhub 0.4.10 → 0.4.11

package/agents/intern-admin/.config.json

@@ -5,6 +5,14 @@
   "bot_api_enabled": false,
   "workspace": "/home/node/.openclaw/workspace-intern",
   "agent_dependencies": [],
+  "post_install": [
+    {
+      "name": "init-workspace",
+      "script": "scripts/init_workspace.sh",
+      "args": [],
+      "delete_on_success": true
+    }
+  ],
   "tools": {
     "deny": [
       "message",

package/agents/intern-admin/scripts/init_workspace.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# intern-admin workspace：创建 knowledge/ 树与 memory/；INDEX.md、FAQ.md 由 Agent 按需创建。
+# 须先于 intern-qa 完成，以便其 setup_links.sh 将 knowledge/ 链到本工作区上级同名目录。
+#
+# 用法：安装器 post_install 调用；或：
+#   WORKSPACE=/path/to/workspace-intern ./scripts/init_workspace.sh
+#   OPENCLAW_WORKSPACE=... ./scripts/init_workspace.sh
+#   ./scripts/init_workspace.sh /path/to/workspace-intern
+
+set -euo pipefail
+
+WS="${WORKSPACE:-${OPENCLAW_WORKSPACE:-${1:-}}}"
+if [[ -z "$WS" ]]; then
+  echo "init_workspace: set WORKSPACE or OPENCLAW_WORKSPACE, or pass workspace root as first arg." >&2
+  exit 1
+fi
+
+WS="$(cd "$WS" && pwd)"
+
+# 一次 mkdir -p 建齐 BOOTSTRAP 约定路径（父目录会自动创建，不必逐条拆开写）
+mkdir -p \
+  "$WS/knowledge/images/"{media,emf_raw} \
+  "$WS/knowledge/attachments" \
+  "$WS/knowledge/archive" \
+  "$WS/memory"
+
+echo "init_workspace: knowledge/ + memory/ ready under ${WS}"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sophhub",
-  "version": "0.4.10",
+  "version": "0.4.11",
   "description": "SophHub CLI - Manage and download AI Agent skills",
   "type": "module",
   "bin": {

package/skills/claw-agent-get-send/skill.json

@@ -1,10 +1,21 @@
 {
   "name": "claw-agent-get-send",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "types": ["store"],
   "displayName": "Claw Agent Get/Send",
-  "description": "Appia claw.agent.groups.get / claw.agent.message.send：脚本封装 + HTTP/curl 参考（JWT、msg/md 负载、错误码）",
+  "description": "Appia（IM 即时通讯）侧 claw.agent.groups.get / claw.agent.message.send：查询机器人在哪些群聊、向群发纯文本或 Markdown；脚本封装 + HTTP/curl 参考（JWT、msg/md、错误码）",
   "changelog": [
+    {
+      "version": "1.0.1",
+      "date": "2026-05-09",
+      "changes": [
+        "appia_claw.py：--cred-file / -c，JSON 凭证优先于环境变量；groups.get / message.send 必填 userId；默认 Base URL",
+        "reference-http.md 迁至技能根目录；仓库 .gitignore 忽略 **/.secrets/",
+        "SKILL.md：bot-secret 式分步用法；description 标明 IM 群聊场景与触发词",
+        "docs/claw-agent-get-send.md：凭证说明、常用示例、与 skill 一致的 IM 表述",
+        "skill.json store description 与 IM 语境对齐"
+      ]
+    },
     {
       "version": "1.0.0",
       "date": "2026-04-28",
@@ -17,5 +28,5 @@
     }
   ],
   "createdAt": "2026-04-28",
-  "updatedAt": "2026-04-28"
+  "updatedAt": "2026-05-09"
 }

package/skills/claw-agent-get-send/src/SKILL.md

@@ -1,72 +1,43 @@
 ---
 name: claw-agent-get-send
-description: >-
-  Call Appia Claw HTTP APIs (agent.groups.get, agent.message.send) using env vars or curl.
-  Use when querying bot group memberships, verifying rid+group name, sending plaintext or Markdown AST to Appia rooms,
-  or when the user needs JWT auth rules, curl examples, or md payload shape for agent.message.send.
+description: On Appia (an IM / team chat platform), list which group chats the bot agent is in (rid + name), or send plaintext or Markdown to a group via Appia Claw. Use when the user asks for group list / 群列表 / Appia 群聊 / rid, or to message a group / 向群发消息 / IM 通知；claw、agent.groups.get、agent.message.send。
 ---
 
-# Claw Agent（groups.get / message.send）
+# Appia 即时通讯（IM）· Claw 群列表与发消息
 
-使用 **环境变量** 鉴权，**不向仓库提交** JWT、`APP_AGENT_ID` 等明文。
-
-## 环境变量
-
-| 变量 | 必填 | 说明 |
-|------|------|------|
-| `APPIA_BASE_URL` | 是 | 根地址，例如 `https://sophgo.appia.cn` |
-| `CLAW_JWT` | 是 | `Authorization: Bearer` 的值 |
-| `APP_AGENT_ID` | 是 | SophClaw 机器人 Agent ID（与 `AGENT_ID` 二选一） |
-| `TARGET_RID` | send / verify | 目标群 `rid` |
-| `TARGET_GROUP_NAME` | verify | 群展示名，`verify-target` 双因子校验用 |
-| `TARGET_GROUP_MATCH` | 否 | `exact`（默认）或 `contains` |
-
-| 可选 | 说明 |
-|------|------|
-| `APPIA_MSG_CHUNK_SIZE` | 单条 `msg` 最大字符数，超出则拆分多次发送（默认 3500） |
+Appia 为 IM（即时通讯）工具中的群聊/会话场景。脚本 `{baseDir}/scripts/appia_claw.py` 通过 Claw HTTP API 拉取机器人所在群并发消息。`{baseDir}` 与本 `SKILL.md` 同级（安装根下一般有 `scripts/`）。
 
 ## 用法
 
-`{baseDir}` 为与本 `SKILL.md` 同级的安装根（通常含 `scripts/`）。
-
-### 查询群列表
-
 ```bash
-uv run {baseDir}/scripts/appia_claw.py groups --json
-```
+# 子命令前可加：--cred-file /path/to.cred.json（或 -c）、--timeout 秒；凭证与路径示例见 docs/claw-agent-get-send.md
 
-### 校验目标群
+# 1. 列出当前 agent 已加入的群（rid、群名）
+uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json groups
 
-```bash
-uv run {baseDir}/scripts/appia_claw.py verify-target
-```
-
-### 发送纯文本（支持分段）
+# 2. 同上，输出接口原始 JSON（便于复制 rid）
+uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json groups --json
 
-```bash
-uv run {baseDir}/scripts/appia_claw.py send --file /tmp/brief.txt
-uv run {baseDir}/scripts/appia_claw.py send --text "hello" --rid <rid>
-```
+# 3. 双因子校验：凭证或环境里已配置 TARGET_RID、TARGET_GROUP_NAME
+uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json verify-target
 
-### 发送 Markdown AST
+# 4. 向指定 rid 发纯文本（--rid 可换成本地凭证里的 target_rid）
+uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send --text "正文" --rid "<rid>"
 
-```bash
-# 从 JSON 字符串
-uv run {baseDir}/scripts/appia_claw.py send-md --md-json '[{"type":"PARAGRAPH","value":[{"type":"PLAIN_TEXT","value":"**粗体** 文本"}]}]'
+# 5. 长文本从 UTF-8 文件发送
+uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send --file /tmp/body.txt --rid "<rid>"
 
-# 从 JSON 文件
-uv run {baseDir}/scripts/appia_claw.py send-md --md-file /tmp/md.json
+# 6. 发 Markdown AST：一段纯文本自动包成 md
+uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send-md --text "正文" --rid "<rid>"
 
-# 纯文本自动转 md 结构
-uv run {baseDir}/scripts/appia_claw.py send-md --text "简单文本"
+# 7. 从 JSON 文件读 md 数组
+uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send-md --md-file /tmp/md.json --rid "<rid>"
 ```
 
-## 说明
-
-- `send` 命令使用 **`msg` 纯文本**；极长正文按 `APPIA_MSG_CHUNK_SIZE` **分多条**发送。
-- `send-md` 命令使用 **`md` Markdown AST** 结构，支持 Rocket.Chat 富文本格式。
-- 请避免与业务侧「同 Sender 并发冲突」同时使用（串行调用本脚本即可）。
+不用凭证文件时，可在环境中设置 `CLAW_JWT`、`APP_AGENT_ID`、`CLAW_USER_ID`（及场景需要的 `TARGET_RID` 等），命令相同，省略 `--cred-file …` 即可。
 
-## HTTP / curl 参考
+## 注意事项
 
-仓库根目录的 `claw.agent.groups.get.curl.md` 与 `claw.agent.message.send.curl.md` 已并入本 skill 的 [reference-http.md](reference-http.md)（鉴权说明、完整 curl、`md` 示例、常见错误码）。需要手写请求或排查 401 / 参数错误时优先读该文件。
+- 最小凭证字段（JSON 或环境变量）：JWT、机器人 `agentId`、创建者 `userId`；勿将填好真实值的文件提交 Git。
+- 未设置 `APPIA_BASE_URL` 时，脚本默认 `https://sophgo.appia.cn`。
+- HTTP / curl / 错误码：技能根目录 **`../reference-http.md`**（相对本文件）。

package/skills/claw-agent-get-send/src/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
 name = "claw-agent-get-send"
-version = "1.0.0"
+version = "1.0.1"
 description = "Appia Claw groups.get / message.send helper"
 requires-python = ">=3.10"

package/skills/claw-agent-get-send/src/scripts/appia_claw.py

@@ -11,6 +11,56 @@ from typing import Any
 from urllib import error, parse, request
 
 DEFAULT_CHUNK_SIZE = 3500
+# 未配置 APPIA_BASE_URL / APPIA_HOST（凭证与环境均无）时使用。
+DEFAULT_APPIA_BASE_URL = "https://sophgo.appia.cn"
+
+# 凭证文件解析后的规范字段（键）→ 值；未使用凭证文件时为 None。
+_CRED: dict[str, str] | None = None
+
+# (规范 env 名, JSON / 文件中允许的别名)。文件中同一逻辑字段任一别名非空即可写入规范键。
+_CRED_CANON_ALIASES: tuple[tuple[str, tuple[str, ...]], ...] = (
+    ("APPIA_BASE_URL", ("APPIA_BASE_URL", "appia_base_url", "base_url", "APPIA_HOST", "appia_host")),
+    ("CLAW_JWT", ("CLAW_JWT", "claw_jwt", "jwt", "APPIA_CLAW_JWT", "appia_claw_jwt")),
+    ("APP_AGENT_ID", ("APP_AGENT_ID", "app_agent_id", "agent_id", "AGENT_ID")),
+    ("CLAW_USER_ID", ("CLAW_USER_ID", "claw_user_id", "user_id", "USER_ID", "creator_user_id", "APPIA_USER_ID", "appia_user_id")),
+    ("TARGET_RID", ("TARGET_RID", "target_rid")),
+    ("TARGET_GROUP_NAME", ("TARGET_GROUP_NAME", "target_group_name")),
+    ("TARGET_GROUP_MATCH", ("TARGET_GROUP_MATCH", "target_group_match")),
+    ("APPIA_MSG_CHUNK_SIZE", ("APPIA_MSG_CHUNK_SIZE", "appia_msg_chunk_size")),
+)
+
+
+def _scalar_from_raw(raw: dict[str, Any], aliases: tuple[str, ...]) -> str:
+    for key in aliases:
+        if key not in raw:
+            continue
+        val = raw[key]
+        if val is None:
+            continue
+        s = str(val).strip()
+        if s:
+            return s
+    return ""
+
+
+def load_cred_file(path: str) -> dict[str, str]:
+    exp = os.path.expanduser(path)
+    try:
+        with open(exp, encoding="utf-8") as f:
+            raw_any: Any = json.load(f)
+    except OSError as exc:
+        sys.exit(f"无法读取凭证文件 {exp}: {exc}")
+    except json.JSONDecodeError as exc:
+        sys.exit(f"凭证文件 JSON 无效 {exp}: {exc}")
+    if not isinstance(raw_any, dict):
+        sys.exit("凭证文件顶层必须是 JSON 对象")
+    raw = raw_any
+    out: dict[str, str] = {}
+    for canon, aliases in _CRED_CANON_ALIASES:
+        v = _scalar_from_raw(raw, aliases)
+        if v:
+            out[canon] = v
+    return out
 
 
 def _env(name: str, *fallbacks: str) -> str:
@@ -21,31 +71,51 @@ def _env(name: str, *fallbacks: str) -> str:
     return ""
 
 
+def _cfg(canon: str, *env_fallbacks: str) -> str:
+    """凭证文件中非空字段优先，否则回退到环境变量（与原先 _env 链一致）。"""
+    if _CRED:
+        v = _CRED.get(canon, "").strip()
+        if v:
+            return v
+    return _env(canon, *env_fallbacks)
+
+
 def _base_url() -> str:
-    base = _env("APPIA_BASE_URL", "APPIA_HOST").rstrip("/")
+    base = _cfg("APPIA_BASE_URL", "APPIA_HOST").rstrip("/")
     if not base:
-        sys.exit("缺少环境变量 APPIA_BASE_URL")
+        base = DEFAULT_APPIA_BASE_URL.rstrip("/")
     return base
 
 
 def _jwt() -> str:
-    tok = _env("CLAW_JWT", "APPIA_CLAW_JWT")
+    tok = _cfg("CLAW_JWT", "APPIA_CLAW_JWT")
     if not tok:
-        sys.exit("缺少环境变量 CLAW_JWT")
+        sys.exit("缺少配置：凭证文件或环境变量 CLAW_JWT（或 APPIA_CLAW_JWT）")
     return tok
 
 
 def _agent_id() -> str:
-    aid = _env("APP_AGENT_ID", "AGENT_ID")
+    aid = _cfg("APP_AGENT_ID", "AGENT_ID")
     if not aid:
-        sys.exit("缺少环境变量 APP_AGENT_ID（或 AGENT_ID）")
+        sys.exit("缺少配置：凭证文件或环境变量 APP_AGENT_ID（或 AGENT_ID）")
     return aid
 
 
+def _user_id() -> str:
+    """创建者 userId：agent.groups.get（query）与 agent.message.send（body）必填。"""
+    uid = _cfg("CLAW_USER_ID", "USER_ID", "APPIA_USER_ID")
+    if not uid:
+        sys.exit(
+            "缺少配置：凭证文件或环境变量 CLAW_USER_ID（或 USER_ID、APPIA_USER_ID、creator_user_id）"
+        )
+    return uid
+
+
 def _groups_get(timeout: float) -> dict[str, Any]:
     base = _base_url()
-    uid = _agent_id()
-    q = parse.urlencode({"agentId": uid})
+    aid = _agent_id()
+    user_id = _user_id()
+    q = parse.urlencode({"agentId": aid, "userId": user_id})
     url = f"{base}/api/v1/claw/agent.groups.get?{q}"
     req = request.Request(
         url,
@@ -82,12 +152,15 @@ def cmd_groups(args: argparse.Namespace) -> int:
 
 
 def cmd_verify_target(args: argparse.Namespace) -> int:
-    rid = _env("TARGET_RID")
-    name = _env("TARGET_GROUP_NAME")
+    rid = _cfg("TARGET_RID")
+    name = _cfg("TARGET_GROUP_NAME")
     if not rid or not name:
-        print("⚠️ verify-target 需要环境变量 TARGET_RID 与 TARGET_GROUP_NAME", file=sys.stderr)
+        print(
+            "⚠️ verify-target 需要 TARGET_RID 与 TARGET_GROUP_NAME（凭证文件或环境变量）",
+            file=sys.stderr,
+        )
         return 1
-    mode = (_env("TARGET_GROUP_MATCH") or "exact").lower()
+    mode = (_cfg("TARGET_GROUP_MATCH") or "exact").lower()
     if mode not in ("exact", "contains"):
         mode = "exact"
     data = _groups_get(args.timeout)
@@ -146,15 +219,25 @@ def _send_request(body_obj: dict[str, Any], timeout: float) -> dict[str, Any]:
 
 def _send_plain(rid: str, msg: str, timeout: float) -> dict[str, Any]:
     """发送纯文本消息。"""
-    uid = _agent_id()
-    body_obj: dict[str, Any] = {"rid": rid, "agentId": uid, "msg": msg}
+    aid = _agent_id()
+    body_obj: dict[str, Any] = {
+        "rid": rid,
+        "agentId": aid,
+        "userId": _user_id(),
+        "msg": msg,
+    }
     return _send_request(body_obj, timeout)
 
 
 def _send_md(rid: str, md: list[dict[str, Any]], timeout: float) -> dict[str, Any]:
     """发送 Markdown AST 消息。"""
-    uid = _agent_id()
-    body_obj: dict[str, Any] = {"rid": rid, "agentId": uid, "md": md}
+    aid = _agent_id()
+    body_obj: dict[str, Any] = {
+        "rid": rid,
+        "agentId": aid,
+        "userId": _user_id(),
+        "md": md,
+    }
     return _send_request(body_obj, timeout)
 
 
@@ -168,7 +251,7 @@ def _chunk_text(text: str, size: int) -> list[str]:
 
 def cmd_send(args: argparse.Namespace) -> int:
     """发送纯文本消息（支持分段）。"""
-    rid = args.rid or _env("TARGET_RID")
+    rid = args.rid or _cfg("TARGET_RID")
     if not rid:
         print("⚠️ send 需要 TARGET_RID 或 --rid", file=sys.stderr)
         return 1
@@ -182,7 +265,7 @@ def cmd_send(args: argparse.Namespace) -> int:
     else:
         print("⚠️ 需要 --file 或 --text", file=sys.stderr)
         return 1
-    chunk_raw = _env("APPIA_MSG_CHUNK_SIZE")
+    chunk_raw = _cfg("APPIA_MSG_CHUNK_SIZE")
     chunk_size = int(chunk_raw) if chunk_raw else DEFAULT_CHUNK_SIZE
     parts = _chunk_text(text, chunk_size)
     for idx, part in enumerate(parts):
@@ -198,7 +281,7 @@ def cmd_send(args: argparse.Namespace) -> int:
 
 def cmd_send_md(args: argparse.Namespace) -> int:
     """发送 Markdown AST 消息。"""
-    rid = args.rid or _env("TARGET_RID")
+    rid = args.rid or _cfg("TARGET_RID")
     if not rid:
         print("⚠️ send-md 需要 TARGET_RID 或 --rid", file=sys.stderr)
         return 1
@@ -246,8 +329,15 @@ def cmd_send_md(args: argparse.Namespace) -> int:
 
 
 def main() -> int:
+    global _CRED
     p = argparse.ArgumentParser(description="Appia Claw (groups.get / message.send)")
     p.add_argument("--timeout", type=float, default=60.0)
+    p.add_argument(
+        "--cred-file",
+        "-c",
+        metavar="PATH",
+        help="JSON 凭证文件（含 Appia 地址、JWT、agentId 等）；文件中非空字段优先于环境变量",
+    )
     sub = p.add_subparsers(dest="cmd", required=True)
 
     gp = sub.add_parser("groups", help="GET agent.groups.get")
@@ -273,6 +363,8 @@ def main() -> int:
     smp.set_defaults(_run=cmd_send_md)
 
     args = p.parse_args()
+    if args.cred_file:
+        _CRED = load_cred_file(args.cred_file)
     runner = getattr(args, "_run", None)
     if runner is None:
         return 1

package/skills/claw-agent-get-send/src/reference-http.md

@@ -1,149 +0,0 @@
-# Claw HTTP API（curl 参考）
-
-与仓库根目录 `claw.agent.groups.get.curl.md`、`claw.agent.message.send.curl.md` 同源；集成在 skill 内便于离线查阅。
-
----
-
-## `GET /api/v1/claw/agent.groups.get`
-
-用于按 `agentId` 查询该机器人所在的所有群聊，返回 `rid` 和群名称。
-
-### 鉴权方式
-
-与 `mcpToDos` 一致：
-
-- `authRequired: false`
-- 通过请求头 `Authorization: Bearer <JWT>` 校验
-- 校验规则受以下设置控制：
-  - `Appia_Antagent_JWT_Enable`
-  - `APPIA_JWT_SECRET`
-
-### 请求示例
-
-```bash
-curl -sS -G 'https://YOUR_ROCKETCHAT_HOST/api/v1/claw/agent.groups.get' \
-  -H 'Authorization: Bearer YOUR_MCP_JWT_TOKEN' \
-  --data-urlencode 'agentId=AGENT_BOT_USER_ID'
-```
-
-### 参数
-
-- `agentId`（query，必填）：OpenClaw 侧 Agent ID（会映射到机器人用户）
-
-### 成功返回示例
-
-```json
-{
-  "success": true,
-  "data": {
-    "agentId": "AGENT_BOT_USER_ID",
-    "groups": [
-      {
-        "rid": "ROOM_ID_1",
-        "name": "群聊A"
-      },
-      {
-        "rid": "ROOM_ID_2",
-        "name": "群聊B"
-      }
-    ],
-    "total": 2
-  }
-}
-```
-
-### 常见失败
-
-- `{"success":false,"message":"401"}`：JWT 无效或过期
-- `{"success":false,"message":"agentId is required"}`：缺少 `agentId`
-- `{"success":false,"message":"agent not found by agentId"}`：找不到对应 agentId 的机器人
-
----
-
-## `POST /api/v1/claw/agent.message.send`
-
-用于根据 `rid + agentId` 向指定群聊发送消息。
-
-接口会校验：
-
-1. `rid` 对应房间存在
-2. `agentId` 对应用户存在、为 bot、且 active
-3. 该 `agentId` 确实在该 `rid` 的订阅列表里
-
-满足后，走后端正常发消息逻辑（`executeSendMessage`）。
-
-### 鉴权方式
-
-与 `mcpToDos` 一致：
-
-- `authRequired: false`
-- 通过请求头 `Authorization: Bearer <JWT>` 校验
-- 校验规则受以下设置控制：
-  - `Appia_Antagent_JWT_Enable`
-  - `APPIA_JWT_SECRET`
-
-### 请求示例
-
-#### 示例一：发送纯文本
-
-```bash
-curl -sS -X POST 'https://YOUR_ROCKETCHAT_HOST/api/v1/claw/agent.message.send' \
-  -H 'Content-Type: application/json' \
-  -H 'Authorization: Bearer YOUR_MCP_JWT_TOKEN' \
-  -d '{
-    "rid": "TARGET_ROOM_RID",
-    "agentId": "AGENT_BOT_USER_ID",
-    "msg": "这是一条由 Claw 机器人发送的消息"
-  }'
-```
-
-#### 示例二：发送 Markdown（`md`）
-
-```bash
-curl -sS -X POST 'https://YOUR_ROCKETCHAT_HOST/api/v1/claw/agent.message.send' \
-  -H 'Content-Type: application/json' \
-  -H 'Authorization: Bearer YOUR_MCP_JWT_TOKEN' \
-  -d '{
-    "rid": "TARGET_ROOM_RID",
-    "agentId": "OPENCLAW_AGENT_ID",
-    "md": [
-      {
-        "type": "PARAGRAPH",
-        "value": [
-          { "type": "PLAIN_TEXT", "value": "这是一条 *Markdown* 消息" }
-        ]
-      }
-    ]
-  }'
-```
-
-### 参数
-
-- `rid`（body，必填）：目标群聊房间 ID
-- `agentId`（body，必填）：OpenClaw 侧 Agent ID（会映射到机器人用户）
-- `msg`（body，可选）：消息文本
-- `md`（body，可选）：Markdown AST（Rocket.Chat `md` 结构）
-- 约束：`msg` 和 `md` 至少提供一个
-
-### 成功返回示例
-
-```json
-{
-  "success": true,
-  "data": {
-    "rid": "TARGET_ROOM_RID",
-    "agentId": "AGENT_BOT_USER_ID",
-    "status": "sent"
-  }
-}
-```
-
-### 常见失败
-
-- `{"success":false,"message":"401"}`：JWT 无效或过期
-- `{"success":false,"message":"rid and agentId are required, and either msg or md must be provided"}`：参数缺失
-- `{"success":false,"message":"room not found"}`：房间不存在
-- `{"success":false,"message":"agent not found by agentId"}`：找不到对应 agentId 的机器人
-- `{"success":false,"message":"agent must be a bot user"}`：agent 不是 bot
-- `{"success":false,"message":"agent is inactive"}`：机器人未激活
-- `{"success":false,"message":"agent is not in this room"}`：机器人不在该群里