OpenClaw 2.0默认不支持原生REST API暴露，所有交互须经Multi-user Gateway；启用受控REST API仅可通过官方rest-gateway插件或签名调用/call端点，且需严格遵循Skill DSL定义、路径绑定与OpenAPI 3.1规范生成三步流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认OpenClaw 2.0是否支持原生REST API暴露
OpenClaw 2.0默认不对外暴露完整REST接口，所有Agent交互走的是内置的Multi-user Gateway统一通道，这是权限与会话隔离的强制前提。
直接启用HTTP服务端口会导致【Session Permission Modes失效，文件系统访问边界被绕过】，可能引发工作区越权读写。
启用受控REST API的两种合规路径
方法一：通过官方插件启用API代理网关
在OpenClaw CLI中执行 ocl plugin install rest-gateway@2.0.3 → 等待插件加载完成 → 运行 ocl gateway start --mode=rest。该命令仅启用符合Permission Modes策略的API路由，自动过滤掉 /fs/write、/browser/exec 等高危端点。
方法二：使用内置的/call endpoint配合签名调用
无需额外插件，直接向 http://localhost:8080/call 发起POST请求，body必须包含 {"skill": "send_email", "params": {...}, "signature": "sha256(...)"}。签名密钥由团队Secret Store动态下发，每次会话不同。
设计清晰API结构的三步实操
第一步：用OpenClaw Skill DSL定义输入契约
在skills/email_v2.yaml中声明参数约束：params: to: {type: email, required: true} subject: {max_length: 128} body: {type: markdown, max_size_kb: 512}。这一步决定API文档自动生成质量，漏写required会导致400错误无明确提示。
第二步：为每个Skill绑定独立HTTP方法与路径
在gateway.config.yml中配置：/v1/email → POST → skill: email_v2，/v1/status/{session_id} → GET → skill: session_status。路径必须以版本号开头，避免未来升级时路由冲突。
第三步：启用OpenClaw 2.0的自动OpenAPI 3.1生成
运行 ocl api spec --format=openapi31 --output=api-spec.yaml，该命令读取所有已注册Skill的DSL定义和gateway.config.yml，输出带鉴权说明、错误码枚举、示例请求的完整规范文件。这一步不可跳过，否则前端无法准确对接。
