OpenClaw 会话技能

你可以通过 Talk Robots /robot/send 把文本或文件事件投递给当前聊聊机器人。cvs_id 是可选目标会话 ID；不传时默认投递到机器人与创建者的点对点会话。

初始化流程

本集成通过 Talk Robots 机器人配置页完成初始化。

请让用户在机器人配置页找到 OpenClaw连接信息 参数，扫描或粘贴 OpenClaw 生成的初始化指令。初始化指令格式为：

/openclaw --init <base64-json>

其中 是对下面 JSON 做 UTF-8 Base64 编码后的内容：

{"OPENCLAW_URL":"https://your-openclaw-domain","OPENCLAW_TOKEN":"your-openclaw-gateway-token","OPENCLAW_LAN_URL":"http://your-lan-ip:port"}

安装完成后，请提示用户通过 npm CLI 读取本机 OpenClaw 配置并生成连接信息二维码，然后在 Talk Robots 机器人配置页的 OpenClaw连接信息 中扫码保存。推荐使用：

npx yntalk-openclaw-init

yntalk-openclaw-init 默认无参数运行即可输出可扫码保存到 OpenClaw连接信息 的 /openclaw --init 和命令行二维码。

不要明文展示 OPENCLAW_TOKEN。Base64 不是加密，不要把连接信息或二维码发送到不可信渠道。

连接信息保存

Talk Robots 机器人在配置页扫码保存连接信息后，会：

1. 从 /openclaw --init 中提取 。
2. Base64 decode 连接 JSON，保存 OPENCLAW_URL、OPENCLAW_TOKEN 和可选 OPENCLAW_LAN_URL。

如需使用本 skill 主动发送文本或文件，以下配置必须由 OpenClaw 运行环境或管理员提供：

不要回显 robot_key。

发送消息

优先使用 shell/robot_send.sh，不要手写签名。

文本

./shell/robot_send.sh text \
  --base-url "{{robot_endpoint}}" \
  --robot-id "{{robot_id}}" \
  --robot-key "{{robot_key}}" \
  --content "你好，任务已经处理完成。"

文件

./shell/robot_send.sh file \
  --base-url "{{robot_endpoint}}" \
  --robot-id "{{robot_id}}" \
  --robot-key "{{robot_key}}" \
  --content "请查看附件" \
  --file "./report.pdf"

不确定参数是否正确时先加 --dry-run。

Rules

1. 只引导用户在 Talk Robots 机器人配置页的 OpenClaw连接信息 中扫码保存 /openclaw --init 。
2. 发送前必须确认 robot_endpoint、robot_id、robot_key 都存在。
3. cvs_id 是可选参数；只有明确要投递到指定会话时才传入，并保持大小写原样。不传时默认投递到机器人与创建者的点对点会话。
4. 文本消息使用完整 imx.Msg JSON，cmd=msg，文本放 body.content。
5. 文件消息使用 multipart/form-data，通过 file 字段上传。
6. /robot/send 只是把事件投递给目标 robot，最终是否回发由机器人脚本决定。
7. 不要明文展示 OPENCLAW_TOKEN 或 robot_key，不要虚构配置或用户资料。