OpenClaw API网关需配置Kong或Nginx路由至本地8081端口，Kong配置含request-transformer与key-auth插件，Nginx支持静态代理及基于X-Claw-Source的动态后端路由，验证需检查健康接口、头标识识别与日志响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要为OpenClaw智能体快速生成适配其通信协议的API网关配置代码，让Kong或Nginx能正确路由来自WhatsApp、Slack等通道的请求到本地Agent服务，同时避免因路径匹配冲突导致请求被拦截或转发失败。
确认OpenClaw服务端口与通信模式
打开OpenClaw安装目录下的config.yaml，检查agent.listen_port字段值，默认为【8081】；若使用HTTPS回调（如WhatsApp Webhook），还需确认gateway.tls_enabled: true及对应证书路径。这一步不可跳过——端口错配会导致Kong转发后连接拒绝，且无明确错误日志提示。
运行curl -X GET http://localhost:8081/health验证服务已就绪；返回{"status":"ok"}即表示Agent处于可接入状态。
用OpenClaw CLI自动生成Kong配置代码
进入OpenClaw主程序所在目录，执行：openclaw gateway generate --platform kong --upstream http://127.0.0.1:8081 --route-prefix /api/claw。
该命令将输出完整Kong Service、Route、Plugin三段式JSON配置，含预设的request-transformer插件用于注入X-Claw-Source头标识来源通道（如whatsapp或slack），并自动启用key-auth插件绑定Consumer白名单。
复制输出内容，粘贴至kong.conf或通过kong admin api批量导入：curl -i -X POST http://localhost:8001/services --data "name=claw-agent" --data "url=http://127.0.0.1:8081"。
手动编写Nginx路由规则（兼容无DB模式）
方法一：基础反向代理（适用于单节点部署）
在/etc/nginx/conf.d/claw.conf中写入：
location /api/claw/ { proxy_pass http://127.0.0.1:8081/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; }
方法二：带通道识别的动态路由（推荐）
添加map块识别来源头：
map $http_x_claw_source $backend { default http://127.0.0.1:8081; whatsapp http://127.0.0.1:8081; slack http://127.0.0.1:8082; }
location /api/claw/ { proxy_pass $backend; }
注意：【必须在http块内定义map，不能放在server块里】，否则Nginx启动时报错“unknown directive 'map'”。
重载配置：sudo nginx -t && sudo nginx -s reload。
验证路由是否生效
第一步：用Postman向http://your-domain.com/api/claw/health发送GET请求，观察响应状态码和body。
第二步：模拟WhatsApp回调，添加Header：X-Claw-Source: whatsapp，请求/api/claw/webhook，检查OpenClaw日志中是否打印Received from whatsapp。
第三步：触发一次Slack消息，抓包确认目标地址是否命中http://127.0.0.1:8082（若启用了多后端路由）。
