ClawHub

External Receiver

Data & APIs

通用外部数据接收 Skill。 在服务器上启动 HTTP 服务，接收外部文件上传和消息， 自动将内容推送到 OpenClaw 用户会话。 支持：文件上传、文本消息、Webhook JSON、curl / wget 客户端。

Install

openclaw skills install external-receiver

External Receiver

从外部接收文件 / 消息 → 推送到 OpenClaw 会话

功能

  • 🌐 启动 HTTP 服务器（监听端口）
  • 📁 接收文件上传（multipart/form-data）
  • 💬 接收文本/JSON 消息
  • → 自动转发到 OpenClaw 当前会话

快速使用

clawhub install external-receiver
cd skills/external-receiver
bash scripts/start.sh                    # 启动接收服务

端点

方法路径说明
GET/服务状态页
GET/health健康检查
POST/upload上传文件
POST/message发送文本消息
POST/webhook接收 JSON Webhook
GET/download/<filename>下载已接收文件

API 详情

上传文件

curl -X POST http://你的服务器:8080/upload \
  -F "file=@/path/to/file.txt"

响应：

{
  "ok": true,
  "filename": "file.txt",
  "size": 12345,
  "path": "/home/user/.openclaw/workspace/received/file.txt"
}

发送文本消息

curl -X POST http://你的服务器:8080/message \
  -d "text=Hello from outside!"

或 JSON：

curl -X POST http://你的服务器:8080/webhook \
  -H "Content-Type: application/json" \
  -d '{"text": "Webhook message", "from": "external-system"}'

OpenClaw 收到推送后自动显示

📥 收到外部消息:
Hello from outside!

📎 收到文件:
file.txt (12KB)
路径: /home/user/.openclaw/workspace/received/file.txt

配置

# 环境变量
export RECEIVER_PORT=8080                    # 监听端口（默认 8080）
export RECEIVER_HOST=0.0.0.0               # 监听地址（默认 0.0.0.0）
export RECEIVER_DIR=/home/user/received     # 文件存储目录
export RECEIVER_SECRET=your_secret_key      # 访问密钥（可选）

安全建议

  • ✅ 生产环境务必设置 RECEIVER_SECRET 并在请求时附带
  • ✅ 使用防火墙限制只开放 8080 端口给信任的 IP
  • ✅ 定期清理 received/ 目录中的文件

Python 调用示例

import requests

# 发送消息
requests.post("http://服务器:8080/message", data={"text": "警报：价格突破"})

# 上传文件
with open("report.pdf", "rb") as f:
    requests.post("http://服务器:8080/upload", files={"file": f})

# Webhook 方式
requests.post("http://服务器:8080/webhook", json={
    "event": "trade",
    "symbol": "BTC/USDT",
    "side": "buy",
    "amount": 0.01
})
More in Data & APIs