（4064期）agent-easy-http – OpenClaw Agent HTTP 代理网关

OpenClaw Agent HTTP 代理网关 基于 OpenClaw 原生 /hooks/agent 的高性能 HTTP 代理，毫秒级将 Agent 能力暴露为 REST API，支持可选 HTTPS、API Key 鉴权与 Session 隔离。 使用说明 核心用法 agent-easy-http 是一款将 OpenClaw Agent 能力通过 HTTP(S) 协议暴露为 REST API 的轻量级代理网关。用户通过简单的命令行交互即可完成初始化与部署，核心工作流包括：运行 python3 scripts/server.py init 进行交互式配置（自动生成 API Key、可选启用 HTTPS、配置 hooks），随后使用 python3 scripts/server.py start 启动服务。服务默认监听 0.0.0.0:7720，提供 /agent/run 通用入口和 /skills/{name}/run 指定 Skill 入口两类核心端点，调用方通过 X-API-Key 头部鉴权，发送自然语言指令或结构化参数即可触发 Agent 执行。v3.0 架构基于 OpenClaw 原生 /hooks/agent 端点，实现毫秒级响应与每请求自动 hook:<uuid> Session 隔离，彻底告别早期版本的冷启动延迟问题。 显著优点 极致性能：v3.0 重构后采用 OpenClaw 原生 hooks 机制，触发延迟从 90 秒冷启动降至毫秒级，支持高并发场景下的实时响应。 Session 隔离强化：每请求自动生成独立 Session Key，彻底避免多请求串扰，保障执行环境的干净与可预测性。 灵活的安全配置：提供 HTTP 零摩擦启动与 HTTPS 按需切换能力，支持自签 SAN 证书；多层防护包括强制 API Key 鉴权、denyskills 黑名单、Prompt 注入加固、allowedagent_ids 路由白名单等。 运维友好：内置自愈 watchdog 守护进程、环境变量全覆盖配置、workspace 内数据持久化（PVC 安全）、热重载支持，适配容器化与云原生部署。 生态互补：与 skill-to-http-flash 形成明确分工——前者支持开放式自然语言调用，后者专注结构化 Skill 直调，满足不同集成需求。 潜在缺点与局限性 安全责任重大：本质上是将具备文件、Shell、消息发送等本机能力的 Agent 暴露为网络服务，默认 HTTP 明文传输存在中间人风险，跨主机场景必须启用 HTTPS 且妥善保护 API Key，否则等同于开放远程控制面。 配置侵入性：init 过程会修改全局 ~/.openclaw/openclaw.json 配置并持久化，watchdog 可能自动修复回退的手动修改，对平台稳定性敏感的环境需充分评估。 结果获取异步性：Agent 执行异步进行，需通过 /result/{run_id} 轮询获取结果（建议 4 秒后首次查询），非即时返回最终输出，对强同步场景需额外封装。 自签证书信任成本：HTTPS 模式采用自签 SAN 证书，调用方需额外配置证书信任（--cacert 或导入系统库），增加客户端集成复杂度。 OpenClaw 版本依赖：依赖 OpenClaw 原生 /hooks/agent 端点及特定配置项（allowRequestSessionKey、allowedSessionKeyPrefixes），需确保底层平台版本兼容。 适合的目标群体 企业内部服务集成开发者：需要将 OpenClaw Agent 能力接入现有微服务架构、消息队列或自动化工作流的团队。 DevOps/SRE 工程师：负责在 Kubernetes、Docker 等容器环境中部署 Agent 服务并保障高可用性的运维人员。 低代码/自动化平台构建者：希望通过标准 HTTP 接口将 Agent 能力封装为可复用组件的产品或平台开发者。 多 Agent 路由管理场景：需要通过 allowedagentids 等机制实现精细权限控制与流量分发的复杂部署环境。 常规使用风险 网络安全风险：默认 HTTP 模式在 0.0.0.0 监听时暴露明文传输通道，API Key、Prompt 及执行结果易被嗅探；生产环境务必启用 HTTPS 并限制网络暴露范围。 凭证泄露风险：API Key 为 bearer 凭证，一旦进入 shell history、日志或截图即可能导致未授权调用，建议配合密钥管理系统使用。 配置漂移风险：watchdog 自动修复机制可能与手动运维冲突，多配置源环境（如 OPENCLAWCONFIGSYNC_PATHS 指向外部配置中心）可能出现覆盖与回退拉锯。 Agent 能力滥用风险：/agent/run 入口允许调用方通过自然语言触发任意 Skill，若 deny_skills 黑名单配置不当，可能导致消息外发、文件篡改等副作用操作。 信息枚举风险：GET /agents 接口在 API Key 泄露情况下可暴露内部所有 Agent ID，建议生产环境限制 allowedagentids 为固定白名单而非通配。 原始说明 Deploy an HTTP(S) proxy that exposes OpenClaw agent capability as a REST API over your network IP (e.g. http://<your-server-ip>:7720). Use when asked to "start agent-easy-http", "expose openclaw agent as HTTP", "deploy openclaw agent HTTP service", "create internal HTTP API for agent", or "start the agent gateway". HTTP by default (zero-friction); optional HTTPS with self-signed SAN certificates for production / cross-host scenarios. Includes mandatory API Key auth, deny-list filter, prompt-injection hardening, and direct integration with OpenClaw native /hooks/agent (millisecond dispatch + automatic hook:<uuid> session isolation per request). Thin proxy layer; use skill-to-http-flash for per-skill API endpoints.