API 详情

上传文件

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

响应：
json
{
ok: true,
filename: file.txt,
size: 12345,
path: /home/user/.openclaw/workspace/received/file.txt
}

发送文本消息

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

或 JSON：
bash
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

配置

bash

环境变量

安全建议

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

Python 调用示例

python
import requests

发送消息

上传文件

Webhook 方式