---
name: claw-agent-get-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。
---

# Appia 即时通讯（IM）· Claw 群列表与发消息

Appia 为 IM（即时通讯）工具中的群聊/会话场景。脚本 `{baseDir}/scripts/appia_claw.py` 通过 Claw HTTP API 拉取机器人所在群并发消息。`{baseDir}` 与本 `SKILL.md` 同级（安装根下一般有 `scripts/`）。

## 用法

```bash
# 子命令前可加：--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

# 2. 同上，输出接口原始 JSON（便于复制 rid）
uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json groups --json

# 3. 双因子校验：凭证或环境里已配置 TARGET_RID、TARGET_GROUP_NAME
uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json verify-target

# 4. 向指定 rid 发纯文本（--rid 可换成本地凭证里的 target_rid）
uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send --text "正文" --rid "<rid>"

# 5. 长文本从 UTF-8 文件发送
uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send --file /tmp/body.txt --rid "<rid>"

# 6. 发 Markdown AST：一段纯文本自动包成 md
uv run {baseDir}/scripts/appia_claw.py --cred-file /path/to.cred.json send-md --text "正文" --rid "<rid>"

# 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>"
```

不用凭证文件时，可在环境中设置 `CLAW_JWT`、`APP_AGENT_ID`、`CLAW_USER_ID`（及场景需要的 `TARGET_RID` 等），命令相同，省略 `--cred-file …` 即可。

## 注意事项

- 最小凭证字段（JSON 或环境变量）：JWT、机器人 `agentId`、创建者 `userId`；勿将填好真实值的文件提交 Git。
- 未设置 `APPIA_BASE_URL` 时，脚本默认 `https://sophgo.appia.cn`。
- HTTP / curl / 错误码：技能根目录 **`../reference-http.md`**（相对本文件）。
