\u6458\u8981：\u672c\u6587\u9762\u5411\u5185\u7f51 Ubuntu \u670d\u52a1\u5668，\u5b8c\u6574\u8bb2\u89e3 OpenClaw \u7684\u91cd\u88c5\u90e8\u7f72\u3001\u672c\u5730\u6a21\u578b\u63a5\u5165\u4e0e WebUI \u5185\u7f51\u76f4\u8fde\u5168\u6d41\u7a0b\u3002\u5185\u5bb9\u5305\u62ec：\u5907\u4efd\u65e7\u914d\u7f6e\u3001\u505c\u6b62\u670d\u52a1\u5e76\u91cd\u88c5\u3001\u624b\u5199 models.providers \u914d\u7f6e\u63a5\u5165\u672c\u5730\u6a21\u578b\u4ee3\u7406（freellmapi\/auto）\u3001\u4ee5 systemd \u7528\u6237\u670d\u52a1\u542f\u52a8 Gateway，\u4ee5\u53ca\u901a\u8fc7 Gateway \u539f\u751f TLS \u81ea\u7b7e\u8bc1\u4e66\u5b9e\u73b0\u5c40\u57df\u7f51\u5185\u5176\u4ed6\u7535\u8111\u76f4\u63a5\u8bbf\u95ee Control UI\u3002\u6587\u7ae0\u91cd\u70b9\u5256\u6790\u4e86\u4e24\u4e2a\u6700\u5bb9\u6613\u8e29\u7684\u5751\u2014\u2014\u81ea\u5b9a\u4e49 Provider \u7684 input\/cost \u5b57\u6bb5\u683c\u5f0f\u6821\u9a8c\u5931\u8d25，\u4ee5\u53ca\u65b0\u8bbe\u5907\u8bbf\u95ee Control UI \u65f6\u7684\u914d\u5bf9\u5ba1\u6279\u6d41\u7a0b，\u5e76\u7ed9\u51fa\u5e38\u89c1\u95ee\u9898\u6392\u67e5\u5bf9\u7167\u8868，\u5e2e\u52a9\u8bfb\u8005\u5c11\u8d70\u5f2f\u8def\u3001\u4e00\u6b65\u5230\u4f4d\u5b8c\u6210\u90e8\u7f72\u3002<\/p>\n
\u76ee\u6807<\/p>\n
\u67b6\u6784\u56fe<\/p>\n
flowchart TD
\n A[\u6d4f\u89c8\u5668: https:\/\/192.168.1.107:18789] — HTTPS TLS \u81ea\u7b7e\u8bc1\u4e66 –> B[OpenClaw Gateway \u7aef\u53e3 18789 TLS \u7ec8\u6b62]
\n B — http:\/\/127.0.0.1:31415\/v1 OpenAI \u517c\u5bb9 –> C[\u672c\u5730\u6a21\u578b\u4ee3\u7406 freellmapi]
\n C — \u4e0a\u6e38\u6a21\u578b\u670d\u52a1 –> D[\u6a21\u578b\u63a8\u7406]<\/p>\n
\u5173\u952e\u7ed3\u8bba（\u5148\u770b，\u5c11\u8d70\u5f2f\u8def）<\/p>\n
# \u67e5\u770b\u7cfb\u7edf\u7248\u672c
\ncat \/etc\/os-release
\nuname -a
\n\u786e\u8ba4 Node \/ npm（\u672c\u6587\u4f7f\u7528 nvm \u5b89\u88c5\u7684 Node v24.19.0）
\nnode -v
\nnpm -v
\n\u67e5\u770b openclaw \u662f\u5426\u5df2\u5168\u5c40\u5b89\u88c5\u53ca\u7248\u672c
\nwhich openclaw
\nopenclaw –version<\/p>\n
# \u786e\u8ba4\u672c\u5730\u6a21\u578b\u4ee3\u7406\u76d1\u542c
\nss -tlnp | grep 31415
\n\u67e5\u770b\u53ef\u7528\u6a21\u578b（\u786e\u8ba4\u6709 auto \/ claude-sonnet-4-5 \u7b49）
\ncurl -s http:\/\/127.0.0.1:31415\/v1\/models -H "Authorization: Bearer <your-api-key>" | head -c 2000<\/p>\n
\u91cd\u88c5\u524d\u52a1\u5fc5\u5907\u4efd ~\/.openclaw \u76ee\u5f55，\u907f\u514d\u4e22\u5931\u539f\u6709 gateway token\u3001\u8bbe\u5907\u3001workspace \u7b49：<\/p>\n
cp -r ~\/.openclaw ~\/.openclaw.bak.$(date +%Y%m%d)
\ndu -sh ~\/.openclaw.bak.$(date +%Y%m%d)<\/p>\n
\u5907\u4efd\u540e\u7528 cat ~\/.openclaw\/openclaw.json \u8bb0\u5f55\u539f\u6709\u5173\u952e\u914d\u7f6e（gateway token\u3001\u7aef\u53e3\u7b49），\u4f5c\u4e3a\u91cd\u88c5\u540e\u5bf9\u6bd4\u57fa\u7ebf\u3002<\/p>\n
OpenClaw \u5b89\u88c5\u4e3a systemd \u7528\u6237\u670d\u52a1\u65f6，\u670d\u52a1\u540d\u4e3a openclaw-gateway.service：<\/p>\n
export XDG_RUNTIME_DIR=\/run\/user\/$(id -u)
\nsystemctl –user list-unit-files | grep -i openclaw
\nsystemctl –user status openclaw-gateway | head -8
\n\u786e\u8ba4\u662f\u5426\u5f00\u673a\u81ea\u542f（Linger）
\nloginctl show-user $USER | grep Linger<\/p>\n
export XDG_RUNTIME_DIR=\/run\/user\/$(id -u)
\nsystemctl –user stop openclaw-gateway
\nsystemctl –user is-active openclaw-gateway # \u5e94\u8f93\u51fa inactive
\n\u6e05\u7406\u53ef\u80fd\u6b8b\u7559\u7684\u524d\u53f0\u8fdb\u7a0b
\npkill -f "openclaw" 2>\/dev\/null
\n\u5378\u8f7d\u65e7\u5168\u5c40\u5305（\u9700\u52a0\u8f7d nvm \u73af\u5883）
\nsource ~\/.nvm\/nvm.sh
\nnpm uninstall -g openclaw<\/p>\n
source ~\/.nvm\/nvm.sh
\nnpm install -g openclaw@latest
\nopenclaw –version # \u786e\u8ba4\u7248\u672c<\/p>\n
\u82e5 npm \u63d0\u793a allow-scripts \u672a\u6267\u884c install \u811a\u672c，\u53ef\u6267\u884c\u4e00\u6b21 npm install -g –allow-scripts=openclaw,@google\/genai,protobufjs,tree-sitter-bash\u3002<\/p>\n
openclaw onboard \u4ea4\u4e92\u5f0f\u5411\u5bfc\u5728 SSH \u4f1a\u8bdd\u4e2d\u5bb9\u6613\u5361\u4f4f\u3002\u63a8\u8350\u76f4\u63a5\u624b\u5199 models.providers \u914d\u7f6e，\u4e00\u6b65\u5230\u4f4d\u3002<\/p>\n
\u5728 ~\/.openclaw\/openclaw.json \u4e2d\u52a0\u5165：<\/p>\n
{
\n "models": {
\n "providers": {
\n "freellmapi": {
\n "baseUrl": "http:\/\/127.0.0.1:31415\/v1",
\n "apiKey": "<your-api-key>",
\n "api": "openai-completions",
\n "models": [
\n {
\n "id": "auto",
\n "name": "Auto (router picks the best available model)",
\n "reasoning": false,
\n "contextWindow": 1048576,
\n "contextTokens": 1048576,
\n "maxTokens": 32768
\n }
\n ]
\n }
\n }
\n },
\n "agents": {
\n "defaults": {
\n "model": {
\n "primary": "freellmapi\/auto"
\n }
\n }
\n }
\n}<\/p>\n
\u5b57\u6bb5\u8bf4\u660e<\/p>\n
| baseUrl<\/td>\n | \u672c\u5730\u6a21\u578b\u4ee3\u7406\u7684 OpenAI \u517c\u5bb9\u5730\u5740，\u672b\u5c3e\u8981\u5e26 \/v1<\/td>\n<\/tr>\n | |||||||||||||||||||||||||||||||||
| apiKey<\/td>\n | \u672c\u5730\u4ee3\u7406\u7684 API key<\/td>\n<\/tr>\n | |||||||||||||||||||||||||||||||||
| api<\/td>\n | \u56fa\u5b9a openai-completions；\u4ec5\u5f53\u540e\u7aef\u652f\u6301 \/v1\/responses \u65f6\u624d\u7528 openai-responses<\/td>\n<\/tr>\n | |||||||||||||||||||||||||||||||||
| models[].id<\/td>\n | \u5728\u4ee3\u7406\u91cc\u771f\u5b9e\u5b58\u5728\u7684\u6a21\u578b ID（\u5982 auto）<\/td>\n<\/tr>\n | |||||||||||||||||||||||||||||||||
| contextWindow\/contextTokens\/maxTokens<\/td>\n | \u4e0a\u4e0b\u6587\u4e0e\u8f93\u51fa\u4e0a\u9650，\u6309\u4ee3\u7406\u5b9e\u9645\u80fd\u529b\u586b\u5199<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n5.3 \u6821\u9a8c\u4e0e\u8e29\u5751<\/h4>\n\u7528\u5b98\u65b9 CLI \u6821\u9a8c\u914d\u7f6e：<\/p>\n source ~\/.nvm\/nvm.sh \u5751 1：input \/ cost \u5b57\u6bb5\u683c\u5f0f \u5751 2：\u4e0d\u80fd\u7528 config set \u5206\u6b65\u62fc Provider 6. \u914d\u7f6e\u5e76\u542f\u52a8 Gateway（systemd \u7528\u6237\u670d\u52a1）<\/h3>\n |
| SSH \u96a7\u9053（ssh -L 18789:127.0.0.1:18789）<\/td>\n | \u96f6\u6539\u52a8<\/td>\n | \u96a7\u9053\u8fdb\u7a0b\u6613\u65ad\u3001\u9700\u4fdd\u6d3b\u3001\u975e\u201c\u76f4\u63a5\u8bbf\u95ee\u201d<\/td>\n<\/tr>\n | ||||||||||||||||||||||||
| Gateway \u539f\u751f TLS（\u672c\u6587\u65b9\u6848）<\/td>\n | \u5185\u7f51 IP \u76f4\u8fde\u3001\u65e0\u989d\u5916\u7ec4\u4ef6<\/td>\n | \u9700\u81ea\u7b7e\u8bc1\u4e66（\u6d4f\u89c8\u5668\u4fe1\u4efb\u4e00\u6b21\u5373\u53ef）<\/td>\n<\/tr>\n | ||||||||||||||||||||||||
| Tailscale Serve<\/td>\n | \u516c\u7f51\u53ef\u8bbf\u95ee\u3001\u8bc1\u4e66\u81ea\u52a8<\/td>\n | \u9700\u88c5 Tailscale \u5e76\u767b\u5f55<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n \u63a8\u8350 Gateway \u539f\u751f TLS，\u6700\u8d34\u5408\u201c\u5185\u7f51 IP \u76f4\u63a5\u8bbf\u95ee\u201d\u8bc9\u6c42\u3002<\/p>\n 7.3 \u751f\u6210\u81ea\u7b7e\u540d\u8bc1\u4e66（\u542b IP SAN）<\/h4>\n\u8bc1\u4e66\u5fc5\u987b\u5305\u542b\u670d\u52a1\u5668\u7684\u5185\u7f51 IP \u7684 SAN，\u5426\u5219\u6d4f\u89c8\u5668\u4f1a\u62a5\u201c\u8bc1\u4e66\u540d\u79f0\u4e0d\u5339\u914d\u201d\u3002<\/p>\n mkdir -p ~\/.openclaw\/certs && cd ~\/.openclaw\/certs 7.4 \u914d\u7f6e Gateway TLS<\/h4>\nsource ~\/.nvm\/nvm.sh \u8bf4\u660e：gateway.tls \u652f\u6301 enabled \/ certPath \/ keyPath \/ caPath \/ autoGenerate\u3002\u751f\u4ea7\u5efa\u8bae\u7528\u6b63\u5f0f\u8bc1\u4e66；\u5185\u7f51\u81ea\u7b7e\u5373\u53ef\u3002 7.5 \u91cd\u542f\u5e76\u9a8c\u8bc1<\/h4>\nexport XDG_RUNTIME_DIR=\/run\/user\/$(id -u) 7.6 \u672c\u673a（Windows）\u5bfc\u5165\u8bc1\u4e66，\u6d88\u9664\u6d4f\u89c8\u5668\u8b66\u544a<\/h4>\n\u628a server.crt \u62f7\u5230\u672c\u673a\u540e：<\/p>\n # \u5bfc\u5165\u5230\u5f53\u524d\u7528\u6237\u53d7\u4fe1\u4efb\u6839（\u65e0\u9700\u7ba1\u7406\u5458） \u4e4b\u540e\u6d4f\u89c8\u5668\u8bbf\u95ee https:\/\/192.168.1.107:18789 \u4e0d\u518d\u6709\u8bc1\u4e66\u8b66\u544a\u3002<\/p>\n 8. \u8bbe\u5907\u914d\u5bf9\u5ba1\u6279（\u6700\u5bb9\u6613\u8e29\u7684\u5751）<\/h3>\n |
| control ui requires device identity<\/td>\n | \u7528\u660e\u6587 HTTP \u8bbf\u95ee\u975e localhost<\/td>\n | \u6539\u8d70 HTTPS（\u672c\u6587\u7b2c 7 \u8282）<\/td>\n<\/tr>\n |
| pairing required: device is not approved yet<\/td>\n | \u65b0\u8bbe\u5907\u672a\u6279\u51c6<\/td>\n | openclaw devices list + approve（\u7b2c 8 \u8282）<\/td>\n<\/tr>\n |
| models.0.input: Invalid input<\/td>\n | input\/cost \u5b57\u6bb5\u683c\u5f0f\u9519\u8bef<\/td>\n | \u5220\u9664\u8fd9\u4e24\u4e2a\u5b57\u6bb5\u540e\u91cd\u65b0 config validate<\/td>\n<\/tr>\n |
| custom model providers must declare models<\/td>\n | \u7528 config set \u5206\u6b65\u5199 Provider<\/td>\n | \u4e00\u6b21\u6027\u5b8c\u6574\u5199\u5165 JSON<\/td>\n<\/tr>\n |
| No pending device request matches<\/td>\n | \u914d\u5bf9\u8bf7\u6c42\u5df2\u8fc7\u671f<\/td>\n | \u6d4f\u89c8\u5668\u5237\u65b0\u9875\u9762\u91cd\u65b0\u751f\u6210，\u518d\u5c3d\u5feb\u6279\u51c6<\/td>\n<\/tr>\n |
| HTTP 000 \/ \u8fde\u4e0d\u4e0a<\/td>\n | gateway \u672a\u542f\u52a8\u6216\u7ed1\u5b9a\u9519\u8bef<\/td>\n | systemctl –user status + journalctl –user -u openclaw-gateway \u770b\u65e5\u5fd7<\/td>\n<\/tr>\n |
| \u6d4f\u89c8\u5668\u8bc1\u4e66\u8b66\u544a<\/td>\n | \u672a\u4fe1\u4efb\u81ea\u7b7e\u8bc1\u4e66<\/td>\n | \u5c06 server.crt \u5bfc\u5165\u672c\u673a\u53d7\u4fe1\u4efb\u6839（\u7b2c 7.6 \u8282）<\/td>\n<\/tr>\n |
| SSH \u96a7\u9053\u65b9\u6848\u6613\u65ad<\/td>\n | \u96a7\u9053\u8fdb\u7a0b\u88ab\u6e05\u7406<\/td>\n | \u6539\u7528\u672c\u6587 HTTPS \u76f4\u8fde\u65b9\u6848<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\u9644：\u6700\u7ec8 openclaw.json \u5173\u952e\u7247\u6bb5（\u4f9b\u5bf9\u7167）<\/h3>\n{ （\u5185\u5bb9\u7531AI\u751f\u6210，\u4ec5\u4f9b\u53c2\u8003）<\/p>\n","protected":false},"excerpt":{"rendered":" \u6458\u8981：\u672c\u6587\u9762\u5411\u5185\u7f51 Ubuntu \u670d\u52a1\u5668，\u5b8c\u6574\u8bb2\u89e3 OpenClaw \u7684\u91cd\u88c5\u90e8\u7f72\u3001\u672c\u5730\u6a21\u578b\u63a5\u5165\u4e0e WebUI \u5185\u7f51\u76f4\u8fde\u5168\u6d41\u7a0b\u3002\u5185\u5bb9\u5305\u62ec：\u5907\u4efd\u65e7\u914d\u7f6e\u3001\u505c\u6b62\u670d\u52a1\u5e76\u91cd\u88c5\u3001\u624b\u5199 models.providers \u914d\u7f6e\u63a5\u5165\u672c\u5730\u6a21\u578b\u4ee3\u7406（freellmapi\/auto）\u3001\u4ee5 systemd \u7528\u6237\u670d\u52a1\u542f\u52a8 Gateway，\u4ee5\u53ca\u901a\u8fc7 Gateway \u539f\u751f TLS \u81ea\u7b7e\u8bc1\u4e66\u5b9e\u73b0\u5c40\u57df\u7f51\u5185\u5176\u4ed6\u7535\u8111\u76f4\u63a5\u8bbf\u95ee Cont<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[43,44],"topic":[],"class_list":["post-115111","post","type-post","status-publish","format-standard","hentry","category-server","tag-43","tag-44"],"yoast_head":"\n |