OpenClaw \u7684 Gateway \u7f51\u5173 \u7f51\u5173\u53ef\u4ee5\u63d0\u4f9b\u517c\u5bb9 OpenResponses \u7684 \u6b64\u7aef\u70b9\u9ed8\u8ba4\u7981\u7528<\/strong>\u3002\u8bf7\u5148\u5728\u914d\u7f6e\u4e2d\u542f\u7528\u3002<\/p>\n \u5e95\u5c42\u5b9e\u73b0\u4e2d\uff0c\u8bf7\u6c42\u4f5c\u4e3a\u6b63\u5e38\u7684 Gateway \u7f51\u5173 \u7f51\u5173\u667a\u80fd\u4f53\u8fd0\u884c\u6267\u884c\uff08\u4e0e \u4f7f\u7528 Gateway \u7f51\u5173 \u7f51\u5173\u8ba4\u8bc1\u914d\u7f6e\u3002\u53d1\u9001 bearer \u4ee4\u724c\uff1a<\/p>\n \u8bf4\u660e\uff1a<\/p>\n \u65e0\u9700\u81ea\u5b9a\u4e49\u5934\uff1a\u5728 OpenResponses \u6216\u901a\u8fc7\u5934\u6307\u5b9a\u7279\u5b9a\u7684 OpenClaw \u667a\u80fd\u4f53\uff1a<\/p>\n \u9ad8\u7ea7\uff1a<\/p>\n \u5c06 “`json5 theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} \u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u7aef\u70b9\u6bcf\u4e2a\u8bf7\u6c42\u90fd\u662f\u65e0\u72b6\u6001\u7684<\/strong>\uff08\u6bcf\u6b21\u8c03\u7528\u751f\u6210\u65b0\u7684\u4f1a\u8bdd\u952e\uff09\u3002<\/p>\n \u5982\u679c\u8bf7\u6c42\u5305\u542b OpenResponses \u8bf7\u6c42\u9075\u5faa OpenResponses API\uff0c\u4f7f\u7528\u57fa\u4e8e item \u7684\u8f93\u5165\u3002\u5f53\u524d\u652f\u6301\uff1a<\/p>\n \u63a5\u53d7\u4f46\u5f53\u524d\u5ffd\u7565<\/strong>\uff1a<\/p>\n \u89d2\u8272\uff1a \u5c06\u5de5\u5177\u7ed3\u679c\u53d1\u9001\u56de\u6a21\u578b\uff1a<\/p>\n “`json theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} \u5141\u8bb8\u7684 MIME \u7c7b\u578b\uff08\u5f53\u524d\uff09\uff1a \u652f\u6301 base64 \u6216 URL \u6765\u6e90\uff1a<\/p>\n “`json theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} \u7701\u7565\u65f6\u7684\u9ed8\u8ba4\u503c\uff1a<\/p>\n \u8bbe\u7f6e \u5f53\u524d\u53d1\u51fa\u7684\u4e8b\u4ef6\u7c7b\u578b\uff1a<\/p>\n \u5f53\u5e95\u5c42\u63d0\u4f9b\u5546\u62a5\u544a\u4ee4\u724c\u8ba1\u6570\u65f6\uff0c \u9519\u8bef\u4f7f\u7528\u5982\u4e0b JSON \u5bf9\u8c61\uff1a<\/p>\n “`json theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} \u6d41\u5f0f\uff1a<\/p>\n OpenResponses API OpenResponses API\uff08HTTP\uff09 OpenClaw \u7684 Ga […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-134","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/134","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=134"}],"version-history":[{"count":2,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/134\/revisions"}],"predecessor-version":[{"id":817,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/134\/revisions\/817"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=134"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=134"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=134"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}POST \/v1\/responses<\/code> \u7aef\u70b9\u3002<\/p>\n\n
POST \/v1\/responses<\/code><\/li>\nhttp:\/\/<gateway-host>:<port>\/v1\/responses<\/code><\/li>\n<\/ul>\nopenclaw agent<\/code> \u76f8\u540c\u7684\u4ee3\u7801\u8def\u5f84\uff09\uff0c\u56e0\u6b64\u8def\u7531\/\u6743\u9650\/\u914d\u7f6e\u4e0e\u4f60\u7684 Gateway \u7f51\u5173 \u7f51\u5173\u4e00\u81f4\u3002<\/p>\n\u8ba4\u8bc1<\/h2>\n
\n
Authorization: Bearer <token><\/code><\/li>\n<\/ul>\n\n
gateway.auth.mode=\"token\"<\/code> \u65f6\uff0c\u4f7f\u7528 gateway.auth.token<\/code>\uff08\u6216 OPENCLAW_GATEWAY_TOKEN<\/code>\uff09\u3002<\/li>\ngateway.auth.mode=\"password\"<\/code> \u65f6\uff0c\u4f7f\u7528 gateway.auth.password<\/code>\uff08\u6216 OPENCLAW_GATEWAY_PASSWORD<\/code>\uff09\u3002<\/li>\n<\/ul>\n\u9009\u62e9\u667a\u80fd\u4f53<\/h2>\n
model<\/code> \u5b57\u6bb5\u4e2d\u7f16\u7801\u667a\u80fd\u4f53 id\uff1a<\/p>\n\n
model: \"openclaw:<agentId>\"<\/code>\uff08\u793a\u4f8b\uff1a\"openclaw:main\"<\/code>\u3001\"openclaw:beta\"<\/code>\uff09<\/li>\nmodel: \"agent:<agentId>\"<\/code>\uff08\u522b\u540d\uff09<\/li>\n<\/ul>\n\n
x-openclaw-agent-id: <agentId><\/code>\uff08\u9ed8\u8ba4\uff1amain<\/code>\uff09<\/li>\n<\/ul>\n\n
x-openclaw-session-key: <sessionKey><\/code> \u5b8c\u5168\u63a7\u5236\u4f1a\u8bdd\u8def\u7531\u3002<\/li>\n<\/ul>\n\u542f\u7528\u7aef\u70b9<\/h2>\n
gateway.http.endpoints.responses.enabled<\/code> \u8bbe\u7f6e\u4e3a true<\/code>\uff1a<\/p>\n
\n{
\n \u7f51\u5173: {
\n http: {
\n endpoints: {
\n responses: { enabled: true },
\n },
\n },
\n },
\n}<\/p>\n\n## \u7981\u7528\u7aef\u70b9\n\n\u5c06 `gateway.http.endpoints.responses.enabled` \u8bbe\u7f6e\u4e3a `false`\uff1a\n\n```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}\n{\n gateway: {\n http: {\n endpoints: {\n responses: { enabled: false },\n },\n },\n },\n}\n<\/code><\/pre>\n\u4f1a\u8bdd\u884c\u4e3a<\/h2>\n
user<\/code> \u5b57\u7b26\u4e32\uff0cGateway \u7f51\u5173 \u7f51\u5173\u4f1a\u4ece\u4e2d\u6d3e\u751f\u7a33\u5b9a\u7684\u4f1a\u8bdd\u952e\uff0c\u8fd9\u6837\u91cd\u590d\u8c03\u7528\u53ef\u4ee5\u5171\u4eab\u667a\u80fd\u4f53\u4f1a\u8bdd\u3002<\/p>\n\u8bf7\u6c42\u7ed3\u6784\uff08\u652f\u6301\u7684\uff09<\/h2>\n
\n
input<\/code>\uff1a\u5b57\u7b26\u4e32\u6216 item \u5bf9\u8c61\u6570\u7ec4\u3002<\/li>\ninstructions<\/code>\uff1a\u5408\u5e76\u5230\u7cfb\u7edf\u63d0\u793a\u4e2d\u3002<\/li>\ntools<\/code>\uff1a\u5ba2\u6237\u7aef\u5de5\u5177\u5b9a\u4e49\uff08\u51fd\u6570\u5de5\u5177\uff09\u3002<\/li>\ntool_choice<\/code>\uff1a\u8fc7\u6ee4\u6216\u8981\u6c42\u5ba2\u6237\u7aef\u5de5\u5177\u3002<\/li>\nstream<\/code>\uff1a\u542f\u7528 SSE \u6d41\u5f0f\u4f20\u8f93\u3002<\/li>\nmax_output_tokens<\/code>\uff1a\u5c3d\u529b\u800c\u4e3a\u7684\u8f93\u51fa\u9650\u5236\uff08\u53d6\u51b3\u4e8e\u63d0\u4f9b\u5546\uff09\u3002<\/li>\nuser<\/code>\uff1a\u7a33\u5b9a\u7684\u4f1a\u8bdd\u8def\u7531\u3002<\/li>\n<\/ul>\n\n
max_tool_calls<\/code><\/li>\nreasoning<\/code><\/li>\nmetadata<\/code><\/li>\nstore<\/code><\/li>\nprevious_response_id<\/code><\/li>\ntruncation<\/code><\/li>\n<\/ul>\nItem\uff08\u8f93\u5165\uff09<\/h2>\n
message<\/code><\/h3>\nsystem<\/code>\u3001developer<\/code>\u3001user<\/code>\u3001assistant<\/code>\u3002<\/p>\n\n
system<\/code> \u548c developer<\/code> \u8ffd\u52a0\u5230\u7cfb\u7edf\u63d0\u793a\u3002<\/li>\nuser<\/code> \u6216 function_call_output<\/code> item \u6210\u4e3a”\u5f53\u524d\u6d88\u606f”\u3002<\/li>\nfunction_call_output<\/code>\uff08\u57fa\u4e8e\u56de\u5408\u7684\u5de5\u5177\uff09<\/h3>\n
\n{
\n “type”: “function_call_output”,
\n “call_id”: “call_123”,
\n “output”: “{“temperature”: “72F”}”
\n}<\/p>\n\n### `reasoning` \u548c `item_reference`\n\n\u4e3a\u4e86 schema \u517c\u5bb9\u6027\u800c\u63a5\u53d7\uff0c\u4f46\u5728\u6784\u5efa\u63d0\u793a\u65f6\u5ffd\u7565\u3002\n\n## \u5de5\u5177\uff08\u5ba2\u6237\u7aef\u51fd\u6570\u5de5\u5177\uff09\n\n\u4f7f\u7528 `tools: [{ type: "function", function: { name, description?, parameters? } }]` \u63d0\u4f9b\u5de5\u5177\u3002\n\n\u5982\u679c\u667a\u80fd\u4f53\u51b3\u5b9a\u8c03\u7528\u5de5\u5177\uff0c\u54cd\u5e94\u8fd4\u56de\u4e00\u4e2a `function_call` \u8f93\u51fa item\u3002\u7136\u540e\u4f60\u53d1\u9001\u5e26\u6709 `function_call_output` \u7684\u540e\u7eed\u8bf7\u6c42\u4ee5\u7ee7\u7eed\u56de\u5408\u3002\n\n## \u56fe\u50cf\uff08`input_image`\uff09\n\n\u652f\u6301 base64 \u6216 URL \u6765\u6e90\uff1a\n\n```json theme={"theme":{"light":"min-light","dark":"min-dark"}}\n{\n "type": "input_image",\n "source": { "type": "url", "url": "https:\/\/example.com\/image.png" }\n}\n<\/code><\/pre>\nimage\/jpeg<\/code>\u3001image\/png<\/code>\u3001image\/gif<\/code>\u3001image\/webp<\/code>\u3002
\n\u6700\u5927\u5927\u5c0f\uff08\u5f53\u524d\uff09\uff1a10MB\u3002<\/p>\n\u6587\u4ef6\uff08
input_file<\/code>\uff09<\/h2>\n
\n{
\n “type”: “input_file”,
\n “source”: {
\n “type”: “base64”,
\n “media_type”: “text\/plain”,
\n “data”: “SGVsbG8gV29ybGQh”,
\n “filename”: “hello.txt”
\n }
\n}<\/p>\n\n\u5141\u8bb8\u7684 MIME \u7c7b\u578b\uff08\u5f53\u524d\uff09\uff1a`text\/plain`\u3001`text\/markdown`\u3001`text\/html`\u3001`text\/csv`\u3001`application\/json`\u3001`application\/pdf`\u3002\n\n\u6700\u5927\u5927\u5c0f\uff08\u5f53\u524d\uff09\uff1a5MB\u3002\n\n\u5f53\u524d\u884c\u4e3a\uff1a\n\n* \u6587\u4ef6\u5185\u5bb9\u88ab\u89e3\u7801\u5e76\u6dfb\u52a0\u5230**\u7cfb\u7edf\u63d0\u793a**\uff0c\u800c\u4e0d\u662f\u7528\u6237\u6d88\u606f\uff0c\u6240\u4ee5\u5b83\u4fdd\u6301\u4e34\u65f6\u6027\uff08\u4e0d\u6301\u4e45\u5316\u5728\u4f1a\u8bdd\u5386\u53f2\u4e2d\uff09\u3002\n* PDF \u88ab\u89e3\u6790\u63d0\u53d6\u6587\u672c\u3002\u5982\u679c\u53d1\u73b0\u7684\u6587\u672c\u5f88\u5c11\uff0c\u524d\u51e0\u9875\u4f1a\u88ab\u6805\u683c\u5316\u4e3a\u56fe\u50cf\u5e76\u4f20\u9012\u7ed9\u6a21\u578b\u3002\n\nPDF \u89e3\u6790\u4f7f\u7528 Node \u53cb\u597d\u7684 `pdfjs-dist` legacy \u6784\u5efa\uff08\u65e0 worker\uff09\u3002\u73b0\u4ee3 PDF.js \u6784\u5efa\u671f\u671b\u6d4f\u89c8\u5668 worker\/DOM \u5168\u5c40\u53d8\u91cf\uff0c\u56e0\u6b64\u4e0d\u5728 Gateway \u7f51\u5173\u4e2d\u4f7f\u7528\u3002\n\nURL \u83b7\u53d6\u9ed8\u8ba4\u503c\uff1a\n\n* `files.allowUrl`\uff1a`true`\n* `images.allowUrl`\uff1a`true`\n* \u8bf7\u6c42\u53d7\u5230\u4fdd\u62a4\uff08DNS \u89e3\u6790\u3001\u79c1\u6709 IP \u963b\u6b62\u3001\u91cd\u5b9a\u5411\u9650\u5236\u3001\u8d85\u65f6\uff09\u3002\n\n## \u6587\u4ef6 + \u56fe\u50cf\u9650\u5236\uff08\u914d\u7f6e\uff09\n\n\u9ed8\u8ba4\u503c\u53ef\u5728 `gateway.http.endpoints.responses` \u4e0b\u8c03\u6574\uff1a\n\n```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}\n{\n gateway: {\n http: {\n endpoints: {\n responses: {\n enabled: true,\n maxBodyBytes: 20000000,\n files: {\n allowUrl: true,\n allowedMimes: [\n "text\/plain",\n "text\/markdown",\n "text\/html",\n "text\/csv",\n "application\/json",\n "application\/pdf",\n ],\n maxBytes: 5242880,\n maxChars: 200000,\n maxRedirects: 3,\n timeoutMs: 10000,\n pdf: {\n maxPages: 4,\n maxPixels: 4000000,\n minTextChars: 200,\n },\n },\n images: {\n allowUrl: true,\n allowedMimes: ["image\/jpeg", "image\/png", "image\/gif", "image\/webp"],\n maxBytes: 10485760,\n maxRedirects: 3,\n timeoutMs: 10000,\n },\n },\n },\n },\n },\n}\n<\/code><\/pre>\n\n
maxBodyBytes<\/code>\uff1a20MB<\/li>\nfiles.maxBytes<\/code>\uff1a5MB<\/li>\nfiles.maxChars<\/code>\uff1a200k<\/li>\nfiles.maxRedirects<\/code>\uff1a3<\/li>\nfiles.timeoutMs<\/code>\uff1a10s<\/li>\nfiles.pdf.maxPages<\/code>\uff1a4<\/li>\nfiles.pdf.maxPixels<\/code>\uff1a4,000,000<\/li>\nfiles.pdf.minTextChars<\/code>\uff1a200<\/li>\nimages.maxBytes<\/code>\uff1a10MB<\/li>\nimages.maxRedirects<\/code>\uff1a3<\/li>\nimages.timeoutMs<\/code>\uff1a10s<\/li>\n<\/ul>\n\u6d41\u5f0f\u4f20\u8f93\uff08SSE\uff09<\/h2>\n
stream: true<\/code> \u63a5\u6536 Server-Sent Events\uff08SSE\uff09\uff1a<\/p>\n\n
Content-Type: text\/event-stream<\/code><\/li>\nevent: <type><\/code> \u548c data: <json><\/code><\/li>\ndata: [DONE]<\/code> \u7ed3\u675f<\/li>\n<\/ul>\n\n
response.created<\/code><\/li>\nresponse.in_progress<\/code><\/li>\nresponse.output_item.added<\/code><\/li>\nresponse.content_part.added<\/code><\/li>\nresponse.output_text.delta<\/code><\/li>\nresponse.output_text.done<\/code><\/li>\nresponse.content_part.done<\/code><\/li>\nresponse.output_item.done<\/code><\/li>\nresponse.completed<\/code><\/li>\nresponse.failed<\/code>\uff08\u51fa\u9519\u65f6\uff09<\/li>\n<\/ul>\n\u7528\u91cf<\/h2>\n
usage<\/code> \u4f1a\u88ab\u586b\u5145\u3002<\/p>\n\u9519\u8bef<\/h2>\n
\n{ “error”: { “message”: “…”, “type”: “invalid_request_error” } }<\/p>\n\n\u5e38\u89c1\u60c5\u51b5\uff1a\n\n* `401` \u7f3a\u5c11\/\u65e0\u6548\u8ba4\u8bc1\n* `400` \u65e0\u6548\u8bf7\u6c42\u4f53\n* `405` \u9519\u8bef\u7684\u65b9\u6cd5\n\n## \u793a\u4f8b\n\n\u975e\u6d41\u5f0f\uff1a\n\n```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}\ncurl -sS http:\/\/127.0.0.1:18789\/v1\/responses \n -H 'Authorization: Bearer YOUR_TOKEN' \n -H 'Content-Type: application\/json' \n -H 'x-openclaw-agent-id: main' \n -d '{\n "model": "openclaw",\n "input": "hi"\n }'\n<\/code><\/pre>\nbash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
\ncurl -N http:\/\/127.0.0.1:18789\/v1\/responses
\n -H 'Authorization: Bearer YOUR_TOKEN'
\n -H 'Content-Type: application\/json'
\n -H 'x-openclaw-agent-id: main'
\n -d '{
\n \"model\": \"openclaw\",
\n \"stream\": true,
\n \"input\": \"hi\"
\n }'<\/code><\/p>\n","protected":false},"excerpt":{"rendered":"