[{"data":1,"prerenderedAt":3819},["ShallowReactive",2],{"docs:setup/installation":3,"content-manifest":1181},{"id":4,"title":5,"body":6,"category":1164,"date":1165,"description":1166,"extension":1167,"meta":1168,"navigation":605,"path":1169,"seo":1170,"source":1171,"sourceName":1172,"sourceType":1173,"stem":1174,"tags":1175,"updatedAt":1179,"__hash__":1180},"docs/docs/setup/installation.md","OpenClaw 安装与环境",{"type":7,"value":8,"toc":1132},"minimark",[9,13,17,21,25,171,174,247,250,253,270,277,280,294,298,301,312,315,348,351,362,365,392,401,404,408,411,449,452,468,471,477,492,508,518,527,553,564,568,571,625,628,639,643,646,704,710,717,733,748,751,754,780,783,803,806,809,812,825,828,845,848,851,854,857,860,863,866,869,872,884,887,890,893,910,913,931,934,945,948,959,963,966,990,993,996,1002,1009,1051,1058,1061,1065,1068,1071,1095,1098,1101,1128],[10,11,5],"h1",{"id":12},"openclaw-安装与环境",[14,15,16],"p",{},"这一页讲的是 OpenClaw 本身应该如何安装，而不是泛泛的环境准备。根据官方当前文档，最推荐的安装方式是使用官网提供的安装脚本，它会自动处理 Node 检测、OpenClaw CLI 安装，以及首次 onboarding。",[18,19,20],"h2",{"id":20},"系统要求",[22,23,24],"h3",{"id":24},"最低配置",[26,27,28,47],"table",{},[29,30,31],"thead",{},[32,33,34,38,41,44],"tr",{},[35,36,37],"th",{},"要求",[35,39,40],{},"macOS",[35,42,43],{},"Windows",[35,45,46],{},"Linux",[48,49,50,68,84,98,112,127,142,156],"tbody",{},[32,51,52,59,62,65],{},[53,54,55],"td",{},[56,57,58],"strong",{},"操作系统",[53,60,61],{},"macOS 12 (Monterey)",[53,63,64],{},"Windows 10 1809+",[53,66,67],{},"Ubuntu 20.04 / Debian 11",[32,69,70,75,78,81],{},[53,71,72],{},[56,73,74],{},"推荐系统",[53,76,77],{},"macOS 14 (Sonoma)",[53,79,80],{},"Windows 11 + WSL2",[53,82,83],{},"Ubuntu 22.04 / Debian 12",[32,85,86,91,94,96],{},[53,87,88],{},[56,89,90],{},"Node.js",[53,92,93],{},"22.16+",[53,95,93],{},[53,97,93],{},[32,99,100,105,108,110],{},[53,101,102],{},[56,103,104],{},"推荐 Node.js",[53,106,107],{},"24 LTS",[53,109,107],{},[53,111,107],{},[32,113,114,119,122,124],{},[53,115,116],{},[56,117,118],{},"内存",[53,120,121],{},"4 GB",[53,123,121],{},[53,125,126],{},"2 GB",[32,128,129,134,137,139],{},[53,130,131],{},[56,132,133],{},"推荐内存",[53,135,136],{},"8 GB+",[53,138,136],{},[53,140,141],{},"4 GB+",[32,143,144,149,152,154],{},[53,145,146],{},[56,147,148],{},"存储空间",[53,150,151],{},"5 GB",[53,153,151],{},[53,155,151],{},[32,157,158,163,166,168],{},[53,159,160],{},[56,161,162],{},"推荐存储",[53,164,165],{},"10 GB+",[53,167,165],{},[53,169,170],{},"20 GB+",[22,172,173],{"id":173},"硬件建议",[26,175,176,191],{},[29,177,178],{},[32,179,180,183,186,188],{},[35,181,182],{},"场景",[35,184,185],{},"CPU",[35,187,118],{},[35,189,190],{},"存储",[48,192,193,206,220,233],{},[32,194,195,198,201,203],{},[53,196,197],{},"基础使用",[53,199,200],{},"2 核",[53,202,121],{},[53,204,205],{},"10 GB",[32,207,208,211,214,217],{},[53,209,210],{},"日常使用",[53,212,213],{},"4 核",[53,215,216],{},"8 GB",[53,218,219],{},"20 GB",[32,221,222,225,228,230],{},[53,223,224],{},"长期运行",[53,226,227],{},"4 核+",[53,229,136],{},[53,231,232],{},"50 GB+",[32,234,235,238,241,244],{},[53,236,237],{},"本地模型",[53,239,240],{},"8 核+",[53,242,243],{},"16 GB+",[53,245,246],{},"100 GB+",[18,248,249],{"id":249},"官方推荐的系统要求",[14,251,252],{},"OpenClaw 当前的安装前提主要是：",[254,255,256,260,263],"ul",{},[257,258,259],"li",{},"Node.js 22.16+",[257,261,262],{},"macOS、Linux 或 Windows",[257,264,265,266],{},"如果你从源码构建，需要 ",[267,268,269],"code",{},"pnpm",[14,271,272,273,276],{},"官方在 2026 年 3 月的安装页里还特别强调了一点：如果你在 Windows 上运行 OpenClaw，强烈建议通过 ",[56,274,275],{},"WSL2"," 使用，而不是直接把 Windows 当作首选运行环境。",[14,278,279],{},"同时，官方安装页当前把 Node 版本要求写得更细了：",[254,281,282,287],{},[257,283,284],{},[56,285,286],{},"Node 24 推荐",[257,288,289],{},[56,290,291,292],{},"Node 22 LTS 仍兼容，但要求至少 ",[267,293,93],{},[18,295,297],{"id":296},"最推荐的安装方式官网安装脚本","最推荐的安装方式：官网安装脚本",[14,299,300],{},"官方当前把安装脚本明确列为推荐路径。它会做这些事情：",[254,302,303,306,309],{},[257,304,305],{},"检测并安装 Node.js",[257,307,308],{},"安装 OpenClaw CLI",[257,310,311],{},"在合适的情况下直接进入 onboarding",[14,313,314],{},"macOS / Linux / WSL2 的推荐命令是：",[316,317,322],"pre",{"className":318,"code":319,"language":320,"meta":321,"style":321},"language-bash shiki shiki-themes github-light github-dark","curl -fsSL https://openclaw.ai/install.sh | bash\n","bash","",[267,323,324],{"__ignoreMap":321},[325,326,329,333,337,341,345],"span",{"class":327,"line":328},"line",1,[325,330,332],{"class":331},"sScJk","curl",[325,334,336],{"class":335},"sj4cs"," -fsSL",[325,338,340],{"class":339},"sZZnC"," https://openclaw.ai/install.sh",[325,342,344],{"class":343},"szBVR"," |",[325,346,347],{"class":331}," bash\n",[14,349,350],{},"Windows PowerShell 的对应命令是：",[316,352,356],{"className":353,"code":354,"language":355,"meta":321,"style":321},"language-powershell shiki shiki-themes github-light github-dark","iwr -useb https://openclaw.ai/install.ps1 | iex\n","powershell",[267,357,358],{"__ignoreMap":321},[325,359,360],{"class":327,"line":328},[325,361,354],{},[14,363,364],{},"如果你只是想先装 CLI，不立刻跑 onboarding，官方现在也给了明确的跳过方式：",[316,366,368],{"className":318,"code":367,"language":320,"meta":321,"style":321},"curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard\n",[267,369,370],{"__ignoreMap":321},[325,371,372,374,376,378,380,383,386,389],{"class":327,"line":328},[325,373,332],{"class":331},[325,375,336],{"class":335},[325,377,340],{"class":339},[325,379,344],{"class":343},[325,381,382],{"class":331}," bash",[325,384,385],{"class":335}," -s",[325,387,388],{"class":335}," --",[325,390,391],{"class":335}," --no-onboard\n",[316,393,395],{"className":353,"code":394,"language":355,"meta":321,"style":321},"& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard\n",[267,396,397],{"__ignoreMap":321},[325,398,399],{"class":327,"line":328},[325,400,394],{},[14,402,403],{},"对绝大多数中文用户来说，这条路径比手工装 Node、再手工全局安装 CLI 更稳，因为它把依赖检查、安装和 onboarding 串在了一起。",[18,405,407],{"id":406},"另一条常见路径直接安装-cli","另一条常见路径：直接安装 CLI",[14,409,410],{},"如果你已经有稳定的 Node 环境，也可以直接安装：",[316,412,414],{"className":318,"code":413,"language":320,"meta":321,"style":321},"npm install -g openclaw@latest\n# 或\npnpm add -g openclaw@latest\n",[267,415,416,430,437],{"__ignoreMap":321},[325,417,418,421,424,427],{"class":327,"line":328},[325,419,420],{"class":331},"npm",[325,422,423],{"class":339}," install",[325,425,426],{"class":335}," -g",[325,428,429],{"class":339}," openclaw@latest\n",[325,431,433],{"class":327,"line":432},2,[325,434,436],{"class":435},"sJ8bj","# 或\n",[325,438,440,442,445,447],{"class":327,"line":439},3,[325,441,269],{"class":331},[325,443,444],{"class":339}," add",[325,446,426],{"class":335},[325,448,429],{"class":339},[14,450,451],{},"安装后建议立即执行：",[316,453,455],{"className":318,"code":454,"language":320,"meta":321,"style":321},"openclaw onboard --install-daemon\n",[267,456,457],{"__ignoreMap":321},[325,458,459,462,465],{"class":327,"line":328},[325,460,461],{"class":331},"openclaw",[325,463,464],{"class":339}," onboard",[325,466,467],{"class":335}," --install-daemon\n",[14,469,470],{},"这是当前官方 quick start 里最常见的命令组合。",[14,472,473,474,476],{},"如果你用 ",[267,475,269],{},"，安装页现在还特别强调了一个很容易被忽略的步骤：",[316,478,480],{"className":318,"code":479,"language":320,"meta":321,"style":321},"pnpm approve-builds -g\n",[267,481,482],{"__ignoreMap":321},[325,483,484,486,489],{"class":327,"line":328},[325,485,269],{"class":331},[325,487,488],{"class":339}," approve-builds",[325,490,491],{"class":335}," -g\n",[14,493,494,495,497,498,497,501,504,505,507],{},"因为首次全局安装时，",[267,496,461],{},"、",[267,499,500],{},"node-llama-cpp",[267,502,503],{},"sharp"," 这类带构建脚本的包可能会被 ",[267,506,269],{}," 拦住。",[18,509,511,513,514,517],{"id":510},"sharp-libvips-的最新安装坑",[267,512,503],{}," / ",[267,515,516],{},"libvips"," 的最新安装坑",[14,519,520,521,523,524,526],{},"官方安装页 2026 年 3 月版专门把这条列了出来。如果你在 macOS 上装过全局 ",[267,522,516],{},"，",[267,525,503],{}," 安装失败时，优先尝试：",[316,528,530],{"className":318,"code":529,"language":320,"meta":321,"style":321},"SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest\n",[267,531,532],{"__ignoreMap":321},[325,533,534,538,541,544,547,549,551],{"class":327,"line":328},[325,535,537],{"class":536},"sVt8B","SHARP_IGNORE_GLOBAL_LIBVIPS",[325,539,540],{"class":343},"=",[325,542,543],{"class":339},"1",[325,545,546],{"class":331}," npm",[325,548,423],{"class":339},[325,550,426],{"class":335},[325,552,429],{"class":339},[14,554,555,556,559,560,563],{},"如果提示 ",[267,557,558],{},"sharp: Please add node-gyp to your dependencies","，再补本机编译工具链，例如 Xcode CLT 和全局 ",[267,561,562],{},"node-gyp","。",[18,565,567],{"id":566},"docker-安装方式","Docker 安装方式",[14,569,570],{},"如果你更倾向于容器化部署，项目也提供了 Docker 支持：",[316,572,574],{"className":318,"code":573,"language":320,"meta":321,"style":321},"# 克隆仓库\ngit clone https://github.com/openclaw/openclaw.git\ncd openclaw\n\n# 使用 docker-compose 启动\ndocker-compose up -d\n",[267,575,576,581,592,600,607,613],{"__ignoreMap":321},[325,577,578],{"class":327,"line":328},[325,579,580],{"class":435},"# 克隆仓库\n",[325,582,583,586,589],{"class":327,"line":432},[325,584,585],{"class":331},"git",[325,587,588],{"class":339}," clone",[325,590,591],{"class":339}," https://github.com/openclaw/openclaw.git\n",[325,593,594,597],{"class":327,"line":439},[325,595,596],{"class":335},"cd",[325,598,599],{"class":339}," openclaw\n",[325,601,603],{"class":327,"line":602},4,[325,604,606],{"emptyLinePlaceholder":605},true,"\n",[325,608,610],{"class":327,"line":609},5,[325,611,612],{"class":435},"# 使用 docker-compose 启动\n",[325,614,616,619,622],{"class":327,"line":615},6,[325,617,618],{"class":331},"docker-compose",[325,620,621],{"class":339}," up",[325,623,624],{"class":335}," -d\n",[14,626,627],{},"这种方式适合：",[254,629,630,633,636],{},[257,631,632],{},"快速原型体验",[257,634,635],{},"隔离环境的开发测试",[257,637,638],{},"已有 Docker 基础设施的团队",[18,640,642],{"id":641},"从源码安装开发场景","从源码安装（开发场景）",[14,644,645],{},"如果你想贡献代码或进行深度定制：",[316,647,649],{"className":318,"code":648,"language":320,"meta":321,"style":321},"git clone https://github.com/openclaw/openclaw.git\ncd openclaw\n\npnpm install\npnpm ui:build\npnpm build\n\nopenclaw onboard --install-daemon\n",[267,650,651,659,665,669,676,683,690,695],{"__ignoreMap":321},[325,652,653,655,657],{"class":327,"line":328},[325,654,585],{"class":331},[325,656,588],{"class":339},[325,658,591],{"class":339},[325,660,661,663],{"class":327,"line":432},[325,662,596],{"class":335},[325,664,599],{"class":339},[325,666,667],{"class":327,"line":439},[325,668,606],{"emptyLinePlaceholder":605},[325,670,671,673],{"class":327,"line":602},[325,672,269],{"class":331},[325,674,675],{"class":339}," install\n",[325,677,678,680],{"class":327,"line":609},[325,679,269],{"class":331},[325,681,682],{"class":339}," ui:build\n",[325,684,685,687],{"class":327,"line":615},[325,686,269],{"class":331},[325,688,689],{"class":339}," build\n",[325,691,693],{"class":327,"line":692},7,[325,694,606],{"emptyLinePlaceholder":605},[325,696,698,700,702],{"class":327,"line":697},8,[325,699,461],{"class":331},[325,701,464],{"class":339},[325,703,467],{"class":335},[14,705,706,707,709],{},"注意：从源码构建需要 ",[267,708,269],{}," 作为包管理器。",[14,711,712,713,716],{},"如果你只是想提前尝试 GitHub ",[267,714,715],{},"main"," 分支的最新版本，官方现在还列出了包管理器直装方式：",[316,718,720],{"className":318,"code":719,"language":320,"meta":321,"style":321},"npm install -g github:openclaw/openclaw#main\n",[267,721,722],{"__ignoreMap":321},[325,723,724,726,728,730],{"class":327,"line":328},[325,725,420],{"class":331},[325,727,423],{"class":339},[325,729,426],{"class":335},[325,731,732],{"class":339}," github:openclaw/openclaw#main\n",[316,734,736],{"className":318,"code":735,"language":320,"meta":321,"style":321},"pnpm add -g github:openclaw/openclaw#main\n",[267,737,738],{"__ignoreMap":321},[325,739,740,742,744,746],{"class":327,"line":328},[325,741,269],{"class":331},[325,743,444],{"class":339},[325,745,426],{"class":335},[325,747,732],{"class":339},[18,749,750],{"id":750},"安装完成后怎么验证",[14,752,753],{},"官方给出的最小验证动作是：",[316,755,757],{"className":318,"code":756,"language":320,"meta":321,"style":321},"openclaw doctor\nopenclaw status\nopenclaw dashboard\n",[267,758,759,766,773],{"__ignoreMap":321},[325,760,761,763],{"class":327,"line":328},[325,762,461],{"class":331},[325,764,765],{"class":339}," doctor\n",[325,767,768,770],{"class":327,"line":432},[325,769,461],{"class":331},[325,771,772],{"class":339}," status\n",[325,774,775,777],{"class":327,"line":439},[325,776,461],{"class":331},[325,778,779],{"class":339}," dashboard\n",[14,781,782],{},"它们分别解决三个问题：",[254,784,785,791,797],{},[257,786,787,790],{},[267,788,789],{},"openclaw doctor","：检查配置和环境是否存在明显问题",[257,792,793,796],{},[267,794,795],{},"openclaw status","：确认 gateway 是否在运行",[257,798,799,802],{},[267,800,801],{},"openclaw dashboard","：打开 Control UI，完成第一次可见的使用验证",[14,804,805],{},"如果你只跑一条最小链路，建议优先把这三步跑通。",[18,807,808],{"id":808},"配置文件和路径在哪里",[14,810,811],{},"官方文档当前说明，默认配置位于：",[316,813,815],{"className":318,"code":814,"language":320,"meta":321,"style":321},"~/.openclaw/openclaw.json\n",[267,816,817],{"__ignoreMap":321},[325,818,819,822],{"class":327,"line":328},[325,820,821],{"class":343},"~",[325,823,824],{"class":536},"/.openclaw/openclaw.json\n",[14,826,827],{},"如果你需要调整默认路径，常见环境变量有：",[254,829,830,835,840],{},[257,831,832],{},[267,833,834],{},"OPENCLAW_HOME",[257,836,837],{},[267,838,839],{},"OPENCLAW_STATE_DIR",[257,841,842],{},[267,843,844],{},"OPENCLAW_CONFIG_PATH",[14,846,847],{},"这些变量适合放在更进阶的部署和迁移场景里，第一次安装通常不需要改。",[18,849,850],{"id":850},"平台差异与建议",[22,852,40],{"id":853},"macos",[14,855,856],{},"最适合做第一次体验和日常桌面使用。官方安装脚本会在需要时补 Homebrew、Node.js 和 Git。",[22,858,46],{"id":859},"linux",[14,861,862],{},"适合长期运行、远程访问和服务器部署。apt/dnf/yum 路径都在官方安装脚本考虑范围内。",[22,864,43],{"id":865},"windows",[14,867,868],{},"官方强烈建议通过 WSL2 使用。这样可以避开不少 PATH、Git 和本地工具兼容性问题。",[14,870,871],{},"如果你在 Windows 上直接安装，官方故障排除里点名提到两类常见问题：",[254,873,874,879],{},[257,875,876],{},[267,877,878],{},"npm error spawn git / ENOENT",[257,880,881],{},[267,882,883],{},"openclaw is not recognized",[14,885,886],{},"这两类问题本质上通常都是 Git 或 PATH 没配好。",[18,888,889],{"id":889},"生产环境怎么装",[14,891,892],{},"如果你要把 OpenClaw 放到长期运行的服务器上，安装页当前把生产部署方向分成了几类：",[254,894,895,898,901,904,907],{},[257,896,897],{},"Docker",[257,899,900],{},"Podman",[257,902,903],{},"Nix",[257,905,906],{},"Ansible",[257,908,909],{},"Bun（更偏 CLI-only）",[14,911,912],{},"官方给出的 Ansible 快速安装入口是：",[316,914,916],{"className":318,"code":915,"language":320,"meta":321,"style":321},"curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash\n",[267,917,918],{"__ignoreMap":321},[325,919,920,922,924,927,929],{"class":327,"line":328},[325,921,332],{"class":331},[325,923,336],{"class":335},[325,925,926],{"class":339}," https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh",[325,928,344],{"class":343},[325,930,347],{"class":331},[14,932,933],{},"这条路径更适合：",[254,935,936,939,942],{},[257,937,938],{},"Debian / Ubuntu 服务器",[257,940,941],{},"需要持续运行的 Gateway",[257,943,944],{},"希望默认就有 SSH + Tailscale 安全边界的场景",[14,946,947],{},"如果你是 VPS / 云主机场景，官方安装页还新增了一条很值得保留的判断：",[254,949,950,953,956],{},[257,951,952],{},"尽量避免第三方“一键式”市场镜像",[257,954,955],{},"优先使用干净基础 OS 镜像，例如 Ubuntu LTS",[257,957,958],{},"再用官方安装脚本或你自己确认过的自动化方案安装",[22,960,962],{"id":961},"tailscale-远程访问","Tailscale 远程访问",[14,964,965],{},"OpenClaw 原生支持 Tailscale 远程访问：",[254,967,968,974,980],{},[257,969,970,973],{},[56,971,972],{},"Tailscale Serve"," - 通过 HTTPS 安全暴露 dashboard，适合大多数远程场景",[257,975,976,979],{},[56,977,978],{},"Tailscale Funnel"," - 公网暴露模式，需要额外认证保护",[257,981,982,985,986,989],{},[56,983,984],{},"Tailscale 身份认证"," - 支持利用 Tailscale 身份头做认证 (",[267,987,988],{},"gateway.auth.allowTailscale",")",[14,991,992],{},"Tailscale 集成让你可以在保持 Gateway 本地运行的同时，通过加密通道从任何地方安全访问。",[18,994,995],{"id":995},"安装时最常见的几个坑",[22,997,999,1001],{"id":998},"openclaw-安装成功但命令找不到",[267,1000,461],{}," 安装成功但命令找不到",[14,1003,1004,1005,1008],{},"官方文档指出，这通常是全局 npm 安装目录没有进入 ",[267,1006,1007],{},"PATH","。应优先检查：",[316,1010,1012],{"className":318,"code":1011,"language":320,"meta":321,"style":321},"node -v\nnpm -v\nnpm prefix -g\necho \"$PATH\"\n",[267,1013,1014,1022,1028,1037],{"__ignoreMap":321},[325,1015,1016,1019],{"class":327,"line":328},[325,1017,1018],{"class":331},"node",[325,1020,1021],{"class":335}," -v\n",[325,1023,1024,1026],{"class":327,"line":432},[325,1025,420],{"class":331},[325,1027,1021],{"class":335},[325,1029,1030,1032,1035],{"class":327,"line":439},[325,1031,420],{"class":331},[325,1033,1034],{"class":339}," prefix",[325,1036,491],{"class":335},[325,1038,1039,1042,1045,1048],{"class":327,"line":602},[325,1040,1041],{"class":335},"echo",[325,1043,1044],{"class":339}," \"",[325,1046,1047],{"class":536},"$PATH",[325,1049,1050],{"class":339},"\"\n",[22,1052,1054,1055],{"id":1053},"linux-上全局-npm-安装报-eacces","Linux 上全局 npm 安装报 ",[267,1056,1057],{},"EACCES",[14,1059,1060],{},"这往往是 npm 的全局前缀指向 root 拥有目录。官方安装脚本会尝试切换前缀到用户目录。",[22,1062,1064],{"id":1063},"windows-缺-git","Windows 缺 Git",[14,1066,1067],{},"即使你走 npm 安装，某些依赖仍可能触发 git URL 相关安装逻辑，所以 Git 仍然是常见前置项。",[18,1069,1070],{"id":1070},"一条适合新用户的安装顺序",[1072,1073,1074,1077,1083,1087,1091],"ol",{},[257,1075,1076],{},"先用官网安装脚本完成安装",[257,1078,1079,1080],{},"跑 ",[267,1081,1082],{},"openclaw onboard --install-daemon",[257,1084,1079,1085],{},[267,1086,789],{},[257,1088,1079,1089],{},[267,1090,795],{},[257,1092,1079,1093],{},[267,1094,801],{},[14,1096,1097],{},"如果到这一步都正常，再进入渠道、认证和远程访问配置。",[18,1099,1100],{"id":1100},"下一步推荐",[254,1102,1103,1110,1116,1122],{},[257,1104,1105],{},[1106,1107,1109],"a",{"href":1108},"/docs/getting-started/getting-started","快速入门",[257,1111,1112],{},[1106,1113,1115],{"href":1114},"/docs/getting-started/onboarding-guide","Onboarding 引导流程说明",[257,1117,1118],{},[1106,1119,1121],{"href":1120},"/docs/manual/architecture","Gateway 架构概览",[257,1123,1124],{},[1106,1125,1127],{"href":1126},"/docs/operations/safety-basics","安全配置基础",[1129,1130,1131],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":321,"searchDepth":432,"depth":432,"links":1133},[1134,1138,1139,1140,1141,1143,1144,1145,1146,1147,1152,1155,1162,1163],{"id":20,"depth":432,"text":20,"children":1135},[1136,1137],{"id":24,"depth":439,"text":24},{"id":173,"depth":439,"text":173},{"id":249,"depth":432,"text":249},{"id":296,"depth":432,"text":297},{"id":406,"depth":432,"text":407},{"id":510,"depth":432,"text":1142},"sharp / libvips 的最新安装坑",{"id":566,"depth":432,"text":567},{"id":641,"depth":432,"text":642},{"id":750,"depth":432,"text":750},{"id":808,"depth":432,"text":808},{"id":850,"depth":432,"text":850,"children":1148},[1149,1150,1151],{"id":853,"depth":439,"text":40},{"id":859,"depth":439,"text":46},{"id":865,"depth":439,"text":43},{"id":889,"depth":432,"text":889,"children":1153},[1154],{"id":961,"depth":439,"text":962},{"id":995,"depth":432,"text":995,"children":1156},[1157,1159,1161],{"id":998,"depth":439,"text":1158},"openclaw 安装成功但命令找不到",{"id":1053,"depth":439,"text":1160},"Linux 上全局 npm 安装报 EACCES",{"id":1063,"depth":439,"text":1064},{"id":1070,"depth":432,"text":1070},{"id":1100,"depth":432,"text":1100},"安装",null,"按官方推荐方式安装 OpenClaw，并根据本地开发、WSL2 和生产部署场景选择合适的安装路径。","md",{},"/docs/setup/installation",{"title":5,"description":1166},"https://docs.openclaw.ai/zh-CN/install","OpenClaw Docs","official","docs/setup/installation",[1176,420,1177,1178],"installation","install-script","wsl2","2026-03-17","hfgmzpCGjPr9RS0VxcVoilpzI0N_5kYoPxOjoxgYHy0",{"generatedAt":1182,"collections":1183,"totals":3817},"2026-10-19T07:16:28.294Z",{"docs":1184,"news":2399,"bestPractices":3158},{"count":1185,"items":1186},171,[1187,1201,1212,1221,1230,1235,1240,1247,1252,1258,1267,1274,1283,1292,1301,1308,1315,1321,1328,1335,1346,1354,1360,1370,1380,1389,1397,1406,1414,1421,1426,1434,1443,1451,1460,1468,1473,1480,1487,1495,1502,1511,1517,1527,1533,1538,1546,1553,1558,1568,1577,1585,1593,1600,1608,1614,1619,1625,1634,1639,1644,1653,1660,1670,1676,1684,1691,1696,1703,1711,1718,1723,1729,1736,1742,1752,1757,1766,1775,1781,1786,1791,1799,1806,1812,1819,1827,1834,1841,1850,1858,1865,1872,1878,1885,1891,1900,1906,1913,1918,1927,1934,1942,1951,1958,1965,1975,1981,1987,1991,1999,2006,2013,2020,2026,2033,2038,2048,2059,2065,2070,2075,2081,2087,2094,2101,2108,2117,2124,2129,2135,2142,2151,2158,2165,2171,2177,2184,2190,2195,2200,2207,2213,2221,2227,2234,2240,2249,2255,2261,2267,2273,2279,2287,2294,2299,2307,2313,2319,2326,2333,2338,2345,2353,2359,2361,2367,2373,2379,2385,2394],{"title":1188,"description":1189,"path":1190,"category":1191,"updatedAt":1192,"sourceType":1193,"tags":1194},"OpenClaw 核心概念","用一页建立 OpenClaw 的核心心智图，分清 Gateway、Agent、Channels、Tools、Skills、Memory 和 Control UI 各自负责什么。","/docs/getting-started/core-concepts","入门","2026-03-16","internal",[1195,1196,1197,1198,1199,1200],"concepts","gateway","agent","channels","tools","memory",{"title":1202,"description":1203,"path":1204,"category":1191,"updatedAt":1205,"sourceType":1193,"tags":1206},"如果你是开发团队，应该先走哪条入口","面向开发团队和独立开发者，帮助判断应该先理解架构、配置、渠道还是扩展能力，避免刚跑通就把 OpenClaw 做成一团难维护的实验场。","/docs/getting-started/developer-team-entry","2026-03-23",[1207,1208,1209,1210,1211],"developers","teams","architecture","configuration","skills",{"title":1213,"description":1214,"path":1215,"category":1191,"updatedAt":1205,"sourceType":1193,"tags":1216},"如果你是企业运维，应该先走哪条入口","面向企业运维和长期维护者，帮助判断应该先看 Gateway、远程访问、安全还是升级治理，避免把 OpenClaw 当成一次性安装项目。","/docs/getting-started/enterprise-ops-entry",[1217,1218,1196,1219,1220],"enterprise","operations","security","upgrades",{"title":1222,"description":1223,"path":1224,"category":1191,"updatedAt":1225,"sourceType":1173,"tags":1226},"创建第一个 Agent","从零开始创建你的第一个 OpenClaw Agent，理解 Agent 的基本概念和配置方式。","/docs/getting-started/first-agent","2026-05-26",[1197,1227,1228,1229],"quickstart","tutorial","basics",{"title":1231,"description":1232,"path":1233,"category":1191,"updatedAt":1225,"sourceType":1173,"tags":1234},"接入第一个渠道","学习如何将 OpenClaw Agent 接入消息渠道，实现多平台统一管理。","/docs/getting-started/first-channel",[1198,1227,1228,1229],{"title":1236,"description":1237,"path":1238,"category":1191,"updatedAt":1225,"sourceType":1173,"tags":1239},"添加第一个技能","学习如何为 OpenClaw Agent 添加和配置技能，让助手具备更多能力。","/docs/getting-started/first-skill",[1211,1227,1228,1229],{"title":1241,"description":1242,"path":1243,"category":1191,"updatedAt":1225,"sourceType":1173,"tags":1244},"创建第一个工作流","学习如何使用 OpenClaw 的工作流功能，实现自动化任务处理。","/docs/getting-started/first-workflow",[1245,1246,1227,1228],"workflow","automation",{"title":1109,"description":1248,"path":1108,"category":1191,"updatedAt":1225,"sourceType":1173,"tags":1249},"按官方推荐链路，在本机完成 OpenClaw 的安装、初始化、状态检查和第一次进入 Control UI。",[1227,1176,1250,1251],"onboarding","dashboard",{"title":1115,"description":1253,"path":1114,"category":1191,"updatedAt":1254,"sourceType":1173,"tags":1255},"基于官方 Onboarding 思路，说明第一次配置 OpenClaw 时应该先做什么、后做什么，以及哪些事情不要过早展开。","2026-03-11",[1250,1256,1257,1196],"daemon","setup",{"title":1259,"description":1260,"path":1261,"category":1191,"updatedAt":1262,"sourceType":1173,"tags":1263},"Onboarding 的本地模式和远程模式怎么选","基于最新官方 Onboarding Wizard 文档，整理 openclaw onboard 在 local 与 remote 两种模式下分别会做什么、不会做什么，以及第一次使用更适合走哪条路。","/docs/getting-started/onboarding-local-vs-remote","2026-03-21",[1250,1264,1265,1196,1266],"remote","local","wizard",{"title":1268,"description":1269,"path":1270,"category":1191,"updatedAt":1205,"sourceType":1193,"tags":1271},"如果你是个人用户，应该先走哪条入口","面向个人重度使用者，帮助判断应该先从 Dashboard、WebChat、渠道、模型还是 Skills 开始，而不是一上来就把整套能力全部接齐。","/docs/getting-started/personal-user-entry",[1272,1273,1251,1198,1211],"personal","getting-started",{"title":1275,"description":1276,"path":1277,"category":1278,"updatedAt":1254,"sourceType":1173,"tags":1279},"如何开始系统理解 OpenClaw","给第一次接触 OpenClaw 的中文用户一条更清晰的阅读顺序，先建立整体认知，再进入安装、接入和运维细节。","/docs/getting-started/reading-path","使用指南",[1280,1281,1282,1250],"reading-path","overview","docs",{"title":1284,"description":1285,"path":1286,"category":1287,"updatedAt":1288,"sourceType":1173,"tags":1289},"OpenClaw 是什么","用中文快速理解 OpenClaw 的定位、使用方式和它与普通聊天产品的差别。","/docs/getting-started/what-is-openclaw","产品","2026-03-13",[1281,1290,1198,1291],"self-hosted","assistant",{"title":1293,"description":1294,"path":1295,"category":1191,"updatedAt":1205,"sourceType":1193,"tags":1296},"我什么时候再上 Skills、Plugins 和多 Agent","帮你判断现在是否已经适合进入 Skills、Plugins、Hooks 或多 Agent 扩展，而不是在基础链路未稳定时过早堆复杂度。","/docs/getting-started/when-to-add-skills-plugins-and-multi-agent",[1211,1297,1298,1299,1300],"plugins","multi-agent","hooks","decision",{"title":1302,"description":1303,"path":1304,"category":1191,"updatedAt":1305,"sourceType":1193,"tags":1306},"我什么时候该开始接入渠道","帮你判断现在是否已经适合进入 Telegram、WhatsApp、飞书等渠道接入，而不是在最小链路未稳定时过早增加复杂度。","/docs/getting-started/when-to-connect-channels","2026-03-24",[1198,1250,1300,1196,1307],"safety",{"title":1309,"description":1310,"path":1311,"category":1191,"updatedAt":1305,"sourceType":1193,"tags":1312},"模型、配置和安全这三页分别什么时候看","用最短方式判断什么时候该去看模型选择、关键配置和安全实践，避免把问题带到错误页面里越看越乱。","/docs/getting-started/when-to-read-models-config-security",[1313,1314,1219,1300,1273],"models","configurations",{"title":1316,"description":1317,"path":1318,"category":1191,"updatedAt":1305,"sourceType":1193,"tags":1319},"Dashboard、WebChat 和聊天渠道分别什么时候用","把 OpenClaw 最常见的三个使用入口拆开，帮助你判断什么时候该进 Dashboard，什么时候该用 WebChat，什么时候才值得接入 Telegram、飞书或 WhatsApp。","/docs/getting-started/when-to-use-dashboard-webchat-or-channels",[1251,1320,1198,1300,1273],"webchat",{"title":1322,"description":1323,"path":1324,"category":1191,"updatedAt":1305,"sourceType":1193,"tags":1325},"我应该先从哪个页面开始","面向第一次进入中文站的用户，按目标、角色和当前问题判断应该先看文档、学习路径、主题中心、视频还是案例。","/docs/getting-started/which-page-should-i-start-with",[1273,1300,1282,1326,1327],"paths","topics",{"title":1329,"description":1330,"path":1331,"category":1287,"updatedAt":1254,"sourceType":1173,"tags":1332},"OpenClaw 适合哪些用户","判断你是否真的需要 OpenClaw，以及它更适合哪类中文用户和团队。","/docs/getting-started/who-is-openclaw-for",[1333,1208,1334,1290],"users","scenarios",{"title":1336,"description":1337,"path":1338,"category":1339,"updatedAt":1340,"sourceType":1173,"tags":1341},"Agent 运行时与工作区结构","理解 OpenClaw 的 Agent 运行时如何工作，工作区里每个文件是干什么的，以及如何正确配置。","/docs/manual/agent-runtime","manual","2026-06-10",[1342,1343,1344,1345],"runtime","workspace","bootstrap","sessions",{"title":1347,"description":1348,"path":1349,"category":1350,"updatedAt":1254,"sourceType":1351,"tags":1352},"Agent 工作区结构说明","了解 OpenClaw 工作区里各类核心文件的作用，包括 AGENTS、SOUL、USER、MEMORY、日志、skills 和 sessions。","/docs/manual/agent-workspace","功能","third-party",[1343,1353,1200,1211],"soul",{"title":1121,"description":1355,"path":1120,"category":1356,"updatedAt":1254,"sourceType":1173,"tags":1357},"理解 OpenClaw 的 Gateway、Control-plane 客户端和 Nodes 如何协作，以及为什么它是一个单一长连接网关系统。","架构",[1196,1358,1209,1359],"nodes","control-plane",{"title":1361,"description":1362,"path":1363,"category":1350,"updatedAt":1364,"sourceType":1173,"tags":1365},"Background Tasks、/tasks 与 task flow 应该怎么用","基于最新官方 Background Tasks 与 openclaw tasks 文档，整理 OpenClaw 的后台任务记录、/tasks 面板、通知策略和长期维护方式。","/docs/manual/background-tasks-and-task-board","2026-04-30",[1366,1246,1367,1368,1369,1218],"tasks","cron","subagent","cli",{"title":1371,"description":1372,"path":1373,"category":1350,"updatedAt":1364,"sourceType":1173,"tags":1374},"Amazon Bedrock 的 AWS 凭据链与 Guardrails 应该怎么配","基于最新官方 Amazon Bedrock 文档，整理 OpenClaw 接入 Bedrock 时的凭据链、区域设置、自动发现和 Guardrails 配置重点。","/docs/manual/bedrock-guardrails-and-auth",[1375,1376,1377,1378,1379,1313],"bedrock","aws","providers","guardrails","auth",{"title":1381,"description":1382,"path":1383,"category":1350,"updatedAt":1384,"sourceType":1173,"tags":1385},"bindings 的优先级怎么影响 agent 选择","基于最新官方 Channel Routing 与 Configuration 文档，解释 peer、guild、team、account、channel 和 default agent 的命中顺序，以及为什么 binding 命中问题常常看起来像“模型选错了”。","/docs/manual/bindings-precedence-and-agent-selection","2026-03-22",[1386,1387,1388,1198,1210],"bindings","routing","agents",{"title":1390,"description":1391,"path":1392,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1393},"BlueBubbles 与 iMessage 接入","为什么官方更推荐 BlueBubbles，而不是 legacy imsg，以及远程 Mac 和 webhook 模式下该注意什么。","/docs/manual/bluebubbles-imessage",[1198,1394,1395,853,1396],"bluebubbles","imessage","webhook",{"title":1398,"description":1399,"path":1400,"category":1350,"updatedAt":1401,"sourceType":1173,"tags":1402},"Broadcast Groups 和普通 routing 的边界怎么区分","基于最新官方 Broadcast Groups 与 Channel Routing 文档，解释 Broadcast Groups 何时会生效、为什么它不是 bindings 的替代品，以及多代理同群运行时的 session、工具和响应顺序边界。","/docs/manual/broadcast-groups-and-routing-boundaries","2026-03-25",[1403,1387,1404,1388,1405],"broadcast","groups","session",{"title":1407,"description":1408,"path":1409,"category":1410,"updatedAt":1411,"sourceType":1173,"tags":1412},"Broadcast 和普通 bindings 谁先生效，什么时候该用哪一个","基于最新官方 Broadcast Groups、Channel Routing 与 Groups 文档，整理 broadcast、bindings、group policy 和 mention gating 的生效顺序，帮助团队区分“多 agent 协作”和“单 agent 路由”到底该落在哪层。","/docs/manual/broadcast-vs-binding-precedence","使用说明","2026-03-29",[1403,1386,1387,1404,1413,1339],"precedence",{"title":1415,"description":1416,"path":1417,"category":1350,"updatedAt":1254,"sourceType":1173,"tags":1418},"Camera Capture 与拍照/短视频能力","理解 OpenClaw 的 camera capture 如何通过 nodes 暴露给 agent，以及设备权限和用户设置为什么比命令本身更重要。","/docs/manual/camera-capture",[1419,1358,1420,853,1197],"camera","mobile",{"title":1422,"description":1423,"path":1424,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1425},"频道与 Session 路由怎么决定上下文边界","基于最新官方 Channel Routing 文档，整理 OpenClaw 的 session key 形状、DM/main 合并、线程隔离、binding 优先级，以及为什么 routing 不是模型自己决定的。","/docs/manual/channel-routing-and-session-keys",[1387,1405,1198,1386,1404],{"title":1427,"description":1428,"path":1429,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1430},"OpenClaw 渠道能力概览","了解 OpenClaw 当前支持的主要聊天渠道、接入方式，以及第一次应该如何选择和配置渠道。","/docs/manual/channels-overview",[1198,1431,1432,1433],"telegram","whatsapp","discord",{"title":1435,"description":1436,"path":1437,"category":1350,"updatedAt":1384,"sourceType":1173,"tags":1438},"ClawHub 的搜索、信号和信任边界","基于最新官方 ClawHub 文档，整理技能注册表里的搜索、标签、下载信号、举报与 moderation 机制，以及中文用户挑选技能时最该看什么。","/docs/manual/clawhub-discovery-and-trust-signals",[1439,1211,1440,1441,1442],"clawhub","registry","moderation","discovery",{"title":1444,"description":1445,"path":1446,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1447},"ClawHub 的版本、锁文件和 sync 怎么理解","基于最新官方 ClawHub 文档，整理 skill bundle 的版本化、.clawhub/lock.json 的作用、sync 的扫描规则，以及为什么 ClawHub 不只是“安装站”。","/docs/manual/clawhub-versioning-and-sync",[1439,1211,1448,1449,1450],"sync","lockfile","versioning",{"title":1452,"description":1453,"path":1454,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1455},"社区插件目录怎么用","基于最新官方插件文档，整理 Community plugins 页面里最重要的筛选思路，帮助你判断哪些第三方插件值得装、哪些只适合观察。","/docs/manual/community-plugins-directory",[1297,1456,1457,1458,1459],"community","ecosystem","extensions","directory",{"title":1461,"description":1462,"path":1463,"category":1410,"updatedAt":1411,"sourceType":1173,"tags":1464},"Control UI 的 Tools 面板为什么更像运行时目录，不是静态配置页","基于最新官方 WebChat 文档，解释 Control UI `/agents` 里的 Tools 面板如何通过 tools.catalog 拉取运行时目录、何时回退到静态列表，以及为什么真正的可用性最终仍由 allow/deny 和多层策略优先级决定。","/docs/manual/control-ui-tools-catalog-and-policy-precedence",[1465,1199,1466,1467,1339],"control-ui","catalog","policy",{"title":1469,"description":1470,"path":1471,"category":1191,"updatedAt":1254,"sourceType":1173,"tags":1472},"Control UI 是什么","理解 Control UI 在 OpenClaw 中承担的角色，以及首次安装、排错和长期运行时应该如何使用它。","/docs/manual/control-ui",[1251,1465,1196,1218],{"title":1474,"description":1475,"path":1476,"category":1287,"updatedAt":1254,"sourceType":1173,"tags":1477},"OpenClaw 核心能力总览","用一页理解 OpenClaw 当前最重要的能力结构，包括渠道、控制台、扩展和运行边界。","/docs/manual/core-capabilities",[1478,1198,1211,1479],"capabilities","voice",{"title":1481,"description":1482,"path":1483,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1484},"Dashboard 快速打开与认证行为","基于最新官方 Dashboard 文档，整理 openclaw dashboard 的快速打开路径、token 在浏览器里的保存行为，以及本地与远程打开时最容易混淆的认证边界。","/docs/manual/dashboard-fast-path-and-auth",[1251,1465,1379,1485,1486],"token","browser",{"title":1488,"description":1489,"path":1490,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1491},"Deepgram 音频转录怎么接","基于最新官方 Deepgram provider 文档，整理 OpenClaw 里语音转录的接入方式、配置重点，以及它和聊天模型 provider 的边界。","/docs/manual/deepgram-audio-transcription",[1492,1493,1494,1479,1377],"deepgram","transcription","audio",{"title":1496,"description":1497,"path":1498,"category":1350,"updatedAt":1254,"sourceType":1173,"tags":1499},"Discord 与 Slack 接入重点","团队协作场景里，Discord 和 Slack 分别适合什么、和 Telegram/WhatsApp 的差别在哪里，以及群组响应策略该怎么收敛。","/docs/manual/discord-and-slack",[1198,1433,1500,1343,1501],"slack","team",{"title":1503,"description":1504,"path":1505,"category":1350,"updatedAt":1506,"sourceType":1173,"tags":1507},"Exec 工具、apply_patch 与执行审批","基于官方 exec、apply_patch 和 exec approvals 文档，解释高权限工具如何工作，为什么审批是硬边界，以及哪些配置最值得先看。","/docs/manual/exec-tools-and-approvals","2026-03-12",[1508,1509,1510,1199,1219],"exec","apply-patch","approvals",{"title":1512,"description":1513,"path":1514,"category":1350,"updatedAt":1411,"sourceType":1173,"tags":1515},"从 Skills 到 Workflows：OpenClaw 扩展栈完整地图","把 Skills、Tools、插件、Hooks、ClawHub、OpenProse、Lobster 和审批流程收成一张扩展地图，帮助你判断什么时候该引入哪一层复杂度。","/docs/manual/extension-stack-full-map",[1211,1199,1297,1299,1516,1510],"workflows",{"title":1518,"description":1519,"path":1520,"category":1350,"updatedAt":1364,"sourceType":1173,"tags":1521},"Feishu 扫码接入、群控边界与 Drive 评论流","基于最新官方 Feishu 文档，整理 OpenClaw 2026.4.10 之后的飞书扫码接入、群聊控制、Drive 评论事件和 reply_comment 工作流。","/docs/manual/feishu-qr-login-and-drive-comments",[1522,1523,1198,1524,1525,1526],"feishu","lark","drive","comments","collaboration",{"title":1528,"description":1529,"path":1530,"category":1410,"updatedAt":1411,"sourceType":1173,"tags":1531},"Telegram forum topic、群 session 和 thread key 应该怎么一起看","基于最新官方 Groups 与 Channel Routing 文档，整理 Telegram forum topic 在 OpenClaw 里的 session key 形态、topic 级上下文隔离和群触发边界，帮助团队理解“同一群里的不同 topic”为什么已经不是同一条会话。","/docs/manual/forum-topics-and-group-session-keys",[1431,1532,1345,1387,1339],"forum-topics",{"title":1534,"description":1535,"path":1536,"category":1350,"updatedAt":1411,"sourceType":1173,"tags":1537},"从第一次跑通到长期运行：OpenClaw 的完整系统地图","把安装、Gateway、控制面、渠道、模型、记忆、自动化和长期维护放到一条完整主线上，帮助你从“先跑起来”过渡到“长期稳定使用”。","/docs/manual/from-first-run-to-long-running-system",[1209,1196,1198,1313,1200,1246],{"title":1539,"description":1540,"path":1541,"category":1350,"updatedAt":1401,"sourceType":1173,"tags":1542},"Headless nodes 和设备宿主边界怎么分","基于最新官方 Nodes、Architecture 与 Pairing 文档，解释 headless nodes、普通设备节点和 Gateway 之间的职责差异，帮助团队理解“能力跑在哪台机器上”这条边界。","/docs/manual/headless-node-hosts-and-device-boundaries",[1358,1543,1544,1545,1196],"headless","pairing","devices",{"title":1547,"description":1548,"path":1549,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1550},"Hooks 生命周期与事件类型","基于最新官方 Hooks 文档，解释 agent:bootstrap、session start/end、/new、/reset 等生命周期事件分别适合放什么逻辑，以及什么时候该用 hook pack 或插件托管 hooks。","/docs/manual/hook-lifecycle-events",[1299,1551,1552,1246,1297],"lifecycle","events",{"title":1554,"description":1555,"path":1556,"category":1350,"updatedAt":1254,"sourceType":1173,"tags":1557},"Hooks 能做什么","从中文用户角度理解 OpenClaw 里的 hooks，不把它只看成技术细节，而看成自动化扩展点。","/docs/manual/hooks-overview",[1299,1246,1516,1552],{"title":1559,"description":1560,"path":1561,"category":1350,"updatedAt":1384,"sourceType":1173,"tags":1562},"消息入口的去重、合并和排队是怎么工作的","基于最新官方 Messages 文档，解释 OpenClaw 的 inbound dedupe、inbound debounce、active-run queue 和 outbound chunking 各自解决什么问题，避免把“回复慢”都误判成模型问题。","/docs/manual/inbound-dedupe-and-debounce",[1563,1564,1565,1566,1567],"messages","queueing","dedupe","debounce","delivery",{"title":1569,"description":1570,"path":1571,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1572},"本地模型支持（Ollama）","使用 Ollama 在本地运行大语言模型，实现隐私优先、零成本的 AI 助手体验。","/docs/manual/local-models-ollama",[1573,1574,1575,1576,1290],"ollama","local-model","llm","privacy",{"title":1578,"description":1579,"path":1580,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1581},"节点位置能力怎么用","基于最新官方 Location Command 文档，整理 OpenClaw 的 location.get 能力、权限模式、精确位置开关，以及它和普通聊天入口的边界。","/docs/manual/location-command-nodes",[1582,1358,1420,1583,1584],"location","permissions","gps",{"title":1586,"description":1587,"path":1588,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1589},"记忆文件怎么分层加载","基于最新官方 Memory 文档，整理 OpenClaw 的 daily log、MEMORY.md、memory_search 和 memory_get 各自适合存什么，以及为什么群组上下文不该直接读长期记忆。","/docs/manual/memory-files-and-loading-boundaries",[1200,1590,1345,1591,1592],"markdown","memory_search","memory_get",{"title":1594,"description":1595,"path":1596,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1597},"memory plugin slot 和 Markdown source of truth 怎么配合","基于最新官方 Memory、CLI memory 与 Plugins 文档，解释为什么 OpenClaw 记忆的 source of truth 仍然是 Markdown 文件，以及 plugins.slots.memory 该怎么理解和切换。","/docs/manual/memory-plugin-slots-and-source-of-truth",[1200,1297,1598,1599,1590],"lancedb","memory-core",{"title":1601,"description":1602,"path":1603,"category":1350,"updatedAt":1506,"sourceType":1173,"tags":1604},"记忆搜索与索引机制","基于官方记忆概念和 memory CLI 文档，解释记忆文件、索引来源、provider 选择以及排障时该看什么。","/docs/manual/memory-search-and-indexing",[1200,1605,1606,1607,1598],"search","indexing","embeddings",{"title":1609,"description":1610,"path":1611,"category":1350,"updatedAt":1254,"sourceType":1351,"tags":1612},"OpenClaw 记忆系统怎么工作","理解 OpenClaw 的 SOUL、Tools、用户长期记忆和会话上下文如何协作，以及为什么它更像持续运行的系统而不是一次性聊天窗口。","/docs/manual/memory-system",[1200,1353,1405,1613],"logs",{"title":1615,"description":1616,"path":1617,"category":1350,"updatedAt":1254,"sourceType":1173,"tags":1618},"Memory、Tools、Skills 如何协同","记忆层负责保留什么，Tools 负责执行什么，Skills 负责组织什么，三者该怎么分工才不会让 OpenClaw 越用越乱。","/docs/manual/memory-tools-skills-playbook",[1200,1199,1211,1353,1245],{"title":1620,"description":1621,"path":1622,"category":1350,"updatedAt":1506,"sourceType":1173,"tags":1623},"消息投递、重试与响应行为","基于官方 retry、messages 和 FAQ 文档，解释消息发送失败时 OpenClaw 会重试什么，不会重试什么，以及为什么群聊和渠道行为会不同。","/docs/manual/message-retries-and-delivery",[1563,1624,1567,1431,1433],"retry",{"title":1626,"description":1627,"path":1628,"category":1410,"updatedAt":1411,"sourceType":1173,"tags":1629},"模型 allowlist、alias 和图片能力门控应该怎么理解","基于最新官方 Models CLI 文档，整理 agents.defaults.models、primary、fallbacks、imageModel 和 imageGenerationModel 的职责，帮助团队理解模型白名单和共享能力门控到底会影响什么。","/docs/manual/model-allowlists-and-capability-gating",[1313,1630,1631,1632,1633,1339],"allowlist","aliases","image","gating",{"title":1635,"description":1636,"path":1637,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1638},"OpenClaw 的 Models 应该怎么理解","理解 OpenClaw 里模型层的角色、选择思路和常见配置边界，避免把所有问题都误判成模型问题。","/docs/manual/models-overview",[1313,1575,1377,1387],{"title":1640,"description":1641,"path":1642,"category":1350,"updatedAt":1254,"sourceType":1173,"tags":1643},"Nodes 与设备能力","理解 OpenClaw 的 nodes 是什么、如何配对，以及相机、语音、屏幕、位置等设备能力在系统里的作用。","/docs/manual/nodes-and-device-actions",[1358,1420,1419,1479,1544],{"title":1645,"description":1646,"path":1647,"category":1339,"updatedAt":1340,"sourceType":1173,"tags":1648},"OAuth 认证与多账号管理","理解 OpenClaw 如何处理 OAuth 认证、Token 存储和多账号路由，以及常见问题排查。","/docs/manual/oauth-auth",[1649,1379,1650,1651,1652],"oauth","codex","claude","profiles",{"title":1654,"description":1655,"path":1656,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1657},"OpenProse 和 Lobster 的边界怎么分","基于最新官方 Lobster 文档，整理 OpenProse 与 Lobster 在多智能体准备、确定性执行和审批恢复上的分工，帮助中文团队判断什么时候该用 /prose，什么时候该转成工作流运行时。","/docs/manual/openprose-and-lobster-boundaries",[1658,1659,1298,1510,1245],"openprose","lobster",{"title":1661,"description":1662,"path":1663,"category":1339,"updatedAt":1664,"sourceType":1173,"tags":1665},"平台支持总览","OpenClaw 支持的操作系统和部署平台，包括 Gateway、桌面应用和移动节点。","/docs/manual/platforms-overview","2026-06-06",[1666,853,1667,1668,865,859,1669],"platforms","ios","android","install",{"title":1671,"description":1672,"path":1673,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1674},"插件托管 hooks 与扩展能力边界","基于最新官方 Plugins 与 Hooks 文档，整理插件托管 hooks 的工作方式、显示位置、启停边界，以及为什么它和独立 hook pack 不是同一种治理对象。","/docs/manual/plugin-managed-hooks",[1297,1299,1246,1458,1675],"governance",{"title":1677,"description":1678,"path":1679,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1680},"插件清单与配置校验","基于最新官方文档，解释 openclaw.plugin.json 的必填字段、校验规则，以及为什么插件清单会直接影响配置是否可通过。","/docs/manual/plugin-manifest",[1297,1681,1682,1683,1210],"manifest","schema","validation",{"title":1685,"description":1686,"path":1687,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1688},"插件包与频道目录元信息","根据最新官方插件文档，解释 package packs、插件 id 生成规则、openclaw.channel 元信息，以及为什么这些字段会影响安装与引导体验。","/docs/manual/plugin-package-packs",[1297,1689,1198,1690,1458],"package-packs","metadata",{"title":1692,"description":1693,"path":1694,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1695},"OpenClaw 插件系统怎么用","基于官方插件与 CLI 文档，解释插件和 Skills、Tools 的边界，说明安装、启用、更新与风险控制的基本方法。","/docs/manual/plugins-overview",[1297,1458,1211,1199,1369],{"title":1697,"description":1698,"path":1699,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1700},"模型提供商与故障转移","基于官方 providers 文档，整理 OpenClaw 常见 provider、默认模型写法、fallback 思路和长期运行时的配置重点。","/docs/manual/providers-and-fallback",[1377,1313,1701,1702,1573],"fallback","openrouter",{"title":1704,"description":1705,"path":1706,"category":1339,"updatedAt":1340,"sourceType":1173,"tags":1707},"Queue 系统与消息转向","理解 OpenClaw 的 Queue 系统、消息转向模式和并发控制机制。","/docs/manual/queue-system",[1708,1709,1710,1563],"queue","steering","concurrency",{"title":1712,"description":1713,"path":1714,"category":1350,"updatedAt":1364,"sourceType":1173,"tags":1715},"用 SearXNG 给 OpenClaw 配自托管 web_search","基于最新官方 SearXNG Search 文档，整理 OpenClaw 如何接入自托管 SearXNG 作为 web_search provider，以及生产环境里最该注意哪些边界。","/docs/manual/searxng-search-provider",[1716,1717,1199,1605,1290],"searxng","web-search",{"title":1719,"description":1720,"path":1721,"category":1350,"updatedAt":1254,"sourceType":1351,"tags":1722},"Session 与配对机制","理解 OpenClaw 如何通过配对、allowFrom、群组提及规则和 session 隔离来识别用户并保护上下文边界。","/docs/manual/session-and-pairing",[1405,1544,1198,1379],{"title":1724,"description":1725,"path":1726,"category":1410,"updatedAt":1411,"sourceType":1173,"tags":1727},"session memory search 什么时候值得开，什么时候先别开","基于最新官方 Memory 与 memory CLI 文档，整理 OpenClaw 的 session memory search、异步索引刷新、delta threshold 和 embedding cache 各自适合什么场景，帮助团队判断什么时候该扩到会话日志检索。","/docs/manual/session-memory-search-and-index-refresh",[1200,1345,1606,1728,1339],"cache",{"title":1730,"description":1731,"path":1732,"category":1350,"updatedAt":1254,"sourceType":1173,"tags":1733},"Signal 渠道接入重点","Signal 为什么更强调 dedicated number、signal-cli 和 pairing，长期运行时最容易踩哪些坑。","/docs/manual/signal-channel",[1198,1734,1735,1544,1576],"signal","signal-cli",{"title":1737,"description":1738,"path":1739,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1740},"Signal 群组与 daemon 模式怎么配","基于最新官方 Signal 文档，整理 Signal 在 OpenClaw 里的群组隔离、外部 daemon 模式、多账号和 config writes 边界。","/docs/manual/signal-groups-and-daemon-mode",[1734,1404,1256,1741,1198],"multi-account",{"title":1743,"description":1744,"path":1745,"category":1350,"updatedAt":1746,"sourceType":1173,"tags":1747},"Skills 配置与热重载","理解 OpenClaw 的 skills 配置项、allowBundled、extraDirs、watch、entries.enabled 和运行时环境注入边界。","/docs/manual/skills-configuration","2026-03-18",[1211,1748,1749,1750,1751],"config","allowBundled","watch","env",{"title":1753,"description":1754,"path":1755,"category":1350,"updatedAt":1179,"sourceType":1173,"tags":1756},"Skills 系统怎么工作","理解 OpenClaw Skills 的三层来源、加载流程、ClawHub 风险，以及为什么不应该一次安装过多技能。","/docs/manual/skills-system",[1211,1439,1199,1219],{"title":1758,"description":1759,"path":1760,"category":1339,"updatedAt":1340,"sourceType":1173,"tags":1761},"流式输出与分块机制","理解 OpenClaw 的两层流式输出机制：块流式（实时发送）和预览流式（实时预览），以及如何配置。","/docs/manual/streaming-and-chunking",[1762,1763,1764,1765,1198],"streaming","chunking","block","preview",{"title":1767,"description":1768,"path":1769,"category":1350,"updatedAt":1506,"sourceType":1173,"tags":1770},"系统提示词、上下文与压缩","基于官方 system prompt、context、compaction 与 session pruning 文档，解释 OpenClaw 一次运行到底会把什么发给模型，以及上下文为什么会变满。","/docs/manual/system-prompt-context-and-compaction",[1771,1772,1773,1774,1345],"system-prompt","context","compaction","pruning",{"title":1776,"description":1777,"path":1778,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1779},"Telegram 与 WhatsApp 接入重点","两个最常见的入门渠道该怎么选、各自依赖什么认证方式，以及群聊和私聊里最容易踩的坑。","/docs/manual/telegram-and-whatsapp",[1198,1431,1432,1544,1780],"bot",{"title":1782,"description":1783,"path":1784,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1785},"Telegram 和 Discord 作为审批入口时该怎么收边界","基于最新官方 Exec Approvals 文档，解释 Telegram 与 Discord 作为 exec approval 客户端时分别扮演什么角色、哪些配置值得先看，以及为什么它们适合作为受控审批入口而不是普通开放群聊。","/docs/manual/telegram-discord-approval-clients",[1431,1433,1510,1198,1508,1219],{"title":1787,"description":1788,"path":1789,"category":1350,"updatedAt":1254,"sourceType":1173,"tags":1790},"OpenClaw 的 Tools 与扩展能力概览","从中文用户角度理解 OpenClaw 的工具层、技能层和自动化扩展边界，知道它为什么不只是聊天助手。","/docs/manual/tools-overview",[1199,1211,1299,1246],{"title":1792,"description":1793,"path":1794,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1795},"vLLM 本地模型 Provider 怎么接","基于最新官方 vLLM provider 文档，整理 OpenClaw 如何接入 vLLM、本地自动发现和手动模型声明各自适合什么场景。","/docs/manual/vllm-local-model-provider",[1796,1797,1377,1290,1798],"vllm","local-models","inference",{"title":1800,"description":1801,"path":1802,"category":1350,"updatedAt":1254,"sourceType":1173,"tags":1803},"语音唤醒与 Talk Mode","理解 OpenClaw 的 voice wake 是怎么和 Gateway、nodes、客户端一起工作的，以及什么时候值得启用它。","/docs/manual/voice-wake-and-talk-mode",[1479,1804,1805,1358,1420],"wake-word","talk-mode",{"title":1807,"description":1808,"path":1809,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1810},"WebChat 与 message CLI","理解 OpenClaw 除聊天渠道外的两类直接交互入口：Gateway WebSocket 上的 WebChat 和统一的 openclaw message 命令。","/docs/manual/webchat-and-message-cli",[1320,1811,1369,1196,1198],"message",{"title":1813,"description":1814,"path":1815,"category":1350,"updatedAt":1816,"sourceType":1173,"tags":1817},"WebChat、API 和控制面入口的边界怎么分","基于最新官方 WebChat、Session 和 API 文档，解释 WebChat 为什么更像会话 UI、HTTP API 为什么更像结构化管理面，以及 Dashboard 为什么仍然属于高权限控制面。","/docs/manual/webchat-api-and-control-surface-boundaries","2026-03-26",[1320,1818,1251,1196,1516],"api",{"title":1820,"description":1821,"path":1822,"category":1350,"updatedAt":1262,"sourceType":1173,"tags":1823},"WebChat 的会话与只读边界","基于最新官方 WebChat 文档，整理 WebChat 如何共享 Gateway 会话、chat.inject 和 abort partial 是什么，以及 Gateway 不可达时为什么会进入只读模式。","/docs/manual/webchat-session-and-readonly-mode",[1320,1345,1824,1825,1826],"websocket","readonly","chat",{"title":1828,"description":1829,"path":1830,"category":1350,"updatedAt":1305,"sourceType":1173,"tags":1831},"用 Webhooks 接外部系统","基于最新官方 Webhooks 文档，整理 OpenClaw 如何通过 /hooks 接收外部事件，重点解释 wake、agent、映射、投递和安全边界。","/docs/manual/webhooks-external-triggers",[1832,1299,1246,1833,1219],"webhooks","integrations",{"title":1835,"description":1836,"path":1837,"category":1838,"updatedAt":1384,"sourceType":1173,"tags":1839},"Exec approvals 转发到聊天渠道该怎么设计","基于最新官方 approvals 文档，解释 OpenClaw 如何把 exec approval 请求转发到聊天渠道、/approve 命令怎么工作，以及为什么它适合远程值班但不适合无限扩散批准权。","/docs/operations/chat-approval-forwarding","运维",[1510,1508,1826,1840,1218],"forwarding",{"title":1842,"description":1843,"path":1844,"category":1838,"updatedAt":1262,"sourceType":1173,"tags":1845},"配置热重载与 include 合并怎么用","基于最新官方 Configuration 文档，整理 OpenClaw 的 config hot reload、reload mode、include 深度合并和哪些改动需要重启。","/docs/operations/config-hot-reload-and-includes",[1210,1846,1847,1848,1849],"hot-reload","includes","merge","restart",{"title":1851,"description":1852,"path":1853,"category":1838,"updatedAt":1262,"sourceType":1173,"tags":1854},"远程打开 Control UI 的正确方式","基于最新官方 Control UI、Dashboard 和 Tailscale 文档，整理远程访问 Control UI 时最稳的路径、常见 1008 报错原因，以及 allowedOrigins 等关键边界。","/docs/operations/control-ui-remote-access",[1465,1251,1855,1856,1857],"remote-access","tailscale","allowedOrigins",{"title":1859,"description":1860,"path":1861,"category":1838,"updatedAt":1384,"sourceType":1173,"tags":1862},"Cron 的 retention 和 run log pruning 怎么工作","基于最新官方 Cron Jobs 与配置文档，解释 isolated cron run 的 sessionRetention、runLog 裁剪、transcript archive 和高频调度下的磁盘足迹，避免把 cron 当成无限保留的后台队列。","/docs/operations/cron-retention-and-run-log-pruning",[1367,1863,1774,1864,1218],"retention","runlog",{"title":1866,"description":1867,"path":1868,"category":1838,"updatedAt":1262,"sourceType":1173,"tags":1869},"定时任务与心跳怎么选","根据最新官方自动化文档，解释 Heartbeat、Cron main、Cron isolated 三种机制分别适合什么场景，以及它们在精度、上下文和成本上的差异。","/docs/operations/cron-vs-heartbeat",[1246,1367,1870,1871,1218],"heartbeat","scheduling",{"title":1873,"description":1874,"path":1875,"category":1838,"updatedAt":1384,"sourceType":1173,"tags":1876},"Dashboard 管理面怎么更稳地开放","基于最新官方 Dashboard、remote access 和 pairing 文档，整理管理员面该如何开放、保存 token、限制入口和处理 unauthorized/1008，避免把 Control UI 变成公开风险面。","/docs/operations/dashboard-admin-surface-hardening",[1251,1465,1264,1219,1877],"admin",{"title":1879,"description":1880,"path":1881,"category":1838,"updatedAt":1816,"sourceType":1173,"tags":1882},"Dashboard 遇到 unauthorized、1008 和 AUTH_TOKEN_MISMATCH 时怎么恢复","基于最新官方 Dashboard 文档，整理 OpenClaw 在 Dashboard 认证失败时更稳的恢复顺序，尤其是 AUTH_TOKEN_MISMATCH、trusted retry、SecretRef token 和远程实例混淆这几类问题。","/docs/operations/dashboard-auth-mismatch-recovery",[1251,1379,1883,1884,1218],"unauthorized","1008",{"title":1886,"description":1887,"path":1888,"category":1838,"updatedAt":1401,"sourceType":1173,"tags":1889},"设备 pairing、fresh token 和 revoke 应该怎么做日常运维","基于最新官方 Pairing 与 Devices CLI 文档，解释 openclaw devices list、approve、rotate、revoke 和 fresh token 的真实边界，以及为什么设备授权不该被当成一次性静态批准。","/docs/operations/device-pairing-token-lifecycle",[1545,1544,1485,1890,1218],"revoke",{"title":1892,"description":1893,"path":1894,"category":1838,"updatedAt":1401,"sourceType":1173,"tags":1895},"doctor 的备份、unknown keys 清理和 --fix 该怎么理解","基于最新官方 Doctor 文档，解释 openclaw doctor 在修复 stale config、unknown keys 和 legacy 状态时的备份与收口方式，帮助团队区分安全修复和强制覆盖。","/docs/operations/doctor-fix-backups-and-unknown-keys",[1896,1897,1898,1748,1899],"doctor","repair","backups","unknown-keys",{"title":1901,"description":1902,"path":1903,"category":1838,"updatedAt":1254,"sourceType":1173,"tags":1904},"Gateway 运维与日常检查","围绕状态检查、访问方式、日志与升级窗口，建立 OpenClaw Gateway 的日常运维习惯。","/docs/operations/gateway-operations",[1196,1218,1905,1613],"status",{"title":1907,"description":1908,"path":1909,"category":1838,"updatedAt":1262,"sourceType":1173,"tags":1910},"Gmail Pub/Sub 接入 OpenClaw","根据最新官方自动化文档，整理 Gmail watch、Google Pub/Sub、Webhook 映射和 Tailscale Funnel 的接入顺序，帮助你把 Gmail 事件稳定送进 OpenClaw。","/docs/operations/gmail-pubsub",[1911,1912,1832,1246,1856],"gmail","pubsub",{"title":1914,"description":1915,"path":1916,"category":1838,"updatedAt":1205,"sourceType":1173,"tags":1917},"长期运行时，如何管理会话、记忆与压缩","把 session、memory、compaction 和重置策略放到同一条治理链里，帮助长期运行的 OpenClaw 环境建立更稳定的上下文边界。","/docs/operations/long-session-governance",[1345,1200,1773,1675,1218],{"title":1919,"description":1920,"path":1921,"category":1838,"updatedAt":1305,"sourceType":1173,"tags":1922},"模型选型与成本控制","从主力模型、fallback、国内 provider 和低价值任务分流四个角度理解 OpenClaw 的模型配置策略与成本控制方法。","/docs/operations/model-strategy-and-cost",[1313,1923,1377,1701,1924,1925,1926],"cost","qwen","qianfan","kimi",{"title":1928,"description":1929,"path":1930,"category":1838,"updatedAt":1262,"sourceType":1173,"tags":1931},"用 models status 做模型健康检查","基于最新官方 Models CLI 与 Auth Monitoring 文档，整理 openclaw models status 在日常运维里的正确用法、退出码含义和适合接入监控的检查方式。","/docs/operations/models-status-and-health-checks",[1313,1932,1379,1649,1933],"health-check","monitoring",{"title":1935,"description":1936,"path":1937,"category":1838,"updatedAt":1254,"sourceType":1173,"tags":1938},"多 Gateway 与隔离运行","当一台机器上需要运行多个 OpenClaw 实例时，如何用 profile、独立端口和独立状态目录避免冲突。","/docs/operations/multiple-gateways",[1196,1939,1940,1941,1218],"profile","multi-instance","isolation",{"title":1943,"description":1944,"path":1945,"category":1838,"updatedAt":1506,"sourceType":1173,"tags":1946},"网络模型、发现与配对","基于官方网络中心、配对和 Gateway 拥有的配对文档，梳理 localhost、tailnet、发现、身份和审批之间的关系。","/docs/operations/network-and-pairing",[1947,1544,1948,1949,1950],"network","identity","tailnet","mdns",{"title":1952,"description":1953,"path":1954,"category":1838,"updatedAt":1305,"sourceType":1173,"tags":1955},"OpenClaw 安全最佳实践","了解使用 OpenClaw 时的安全最佳实践，包括密码管理、权限控制和日志监控。","/docs/operations/openclaw-security-best-practices",[1219,1956,1957],"best-practices","guide",{"title":1959,"description":1960,"path":1961,"category":1838,"updatedAt":1384,"sourceType":1173,"tags":1962},"Compaction 前的 memory flush 在保护什么","基于最新官方 Memory、Compaction 和会话管理文档，解释 pre-compaction memory flush 的触发时机、NO_REPLY 机制、软阈值公式，以及为什么它是长期使用体验里的关键缓冲层。","/docs/operations/pre-compaction-memory-flush",[1200,1773,1963,1964,1218],"flush","NO_REPLY",{"title":1966,"description":1967,"path":1968,"category":1969,"updatedAt":1305,"sourceType":1173,"tags":1970},"如何持续跟踪 OpenClaw 更新","建立一套低成本的更新跟踪方法，并把官方 release 和文档变化转化成真正可执行的中文维护动作。","/docs/operations/release-tracking","更新",[1971,1972,1973,1974],"release","changelog","updates","maintenance",{"title":1976,"description":1977,"path":1978,"category":1838,"updatedAt":1305,"sourceType":1173,"tags":1979},"远程访问与 Tailscale / SSH","把 OpenClaw 放到远程主机长期运行时，如何在 SSH、tailnet、Tailscale Serve 和直接 ws/wss 之间做选择。","/docs/operations/remote-access",[1264,1980,1856,1196,1218],"ssh",{"title":1982,"description":1983,"path":1984,"category":1838,"updatedAt":1254,"sourceType":1173,"tags":1985},"Remote Operators 与多设备协作","当 Gateway 跑在远程主机、操作入口分散在多台设备上时，如何理解 operator、node 和长期在线实例的协作边界。","/docs/operations/remote-operators-and-nodes",[1264,1986,1358,1856,1980,1545],"operators",{"title":1988,"description":1989,"path":1126,"category":1838,"updatedAt":1254,"sourceType":1173,"tags":1990},"OpenClaw 安全配置基础","从 Gateway auth、allowlist、Control UI 暴露方式和 Tailscale/SSH 接入策略理解 OpenClaw 的基础安全边界。",[1219,1379,1856,1251],{"title":1992,"description":1993,"path":1994,"category":1838,"updatedAt":1305,"sourceType":1173,"tags":1995},"security audit、--deep 和 --fix 该怎么配合","基于最新官方安全文档，解释 openclaw security audit、--deep 与 --fix 各自适合什么阶段，哪些问题适合自动修复，哪些仍应人工复核。","/docs/operations/security-audit-fix-and-review",[1219,1996,1997,1998,1218],"audit","hardening","fix",{"title":2000,"description":2001,"path":2002,"category":1838,"updatedAt":1384,"sourceType":1173,"tags":2003},"sessions cleanup 和 session maintenance 应该怎么配合","基于最新官方 sessions CLI 文档，解释 openclaw sessions cleanup 的作用范围、dry-run/enforce 语义、active-key 保护，以及它和 cron maintenance 不是同一层清理。","/docs/operations/sessions-cleanup-and-maintenance",[1345,2004,1974,2005,1218],"cleanup","transcripts",{"title":2007,"description":2008,"path":2009,"category":1838,"updatedAt":1401,"sourceType":1173,"tags":2010},"shared inbox 的运营边界和信任模型","基于最新官方 Security、Session 和 Groups 文档，解释 OpenClaw 对 shared inbox 的默认安全假设、适合的协作硬化方式，以及为什么真正的互不信任多租户场景更应该拆成独立 gateway。","/docs/operations/shared-inbox-trust-boundaries",[1219,2011,2012,1196,1218],"shared-inbox","trust-model",{"title":2014,"description":2015,"path":2016,"category":1838,"updatedAt":1506,"sourceType":1173,"tags":2017},"Tailscale Serve / Funnel 怎么选","基于官方 Tailscale 文档，解释 serve、funnel、tailnet 绑定和 allowTailscale 的差异，以及更稳的使用边界。","/docs/operations/tailscale-serve-and-funnel",[1856,2018,2019,1196,1379],"serve","funnel",{"title":2021,"description":2022,"path":2023,"category":1838,"updatedAt":1254,"sourceType":1173,"tags":2024},"团队频道里的 Session 隔离策略","当 OpenClaw 进入 Discord、Slack 等多人频道后，如何把频道、线程、私聊和长期记忆分开，避免上下文污染。","/docs/operations/team-channel-session-strategy",[1405,1433,1500,1208,2025,1218],"group-chat",{"title":2027,"description":2028,"path":2029,"category":1838,"updatedAt":1746,"sourceType":1173,"tags":2030},"Trusted Proxy Auth 怎么用","理解 OpenClaw 的 trusted-proxy 认证模式、适用场景、风险检查项，以及它和普通 TLS 反向代理的本质区别。","/docs/operations/trusted-proxy-auth",[2031,2032,1379,1196,1219],"trusted-proxy","reverse-proxy",{"title":2034,"description":2035,"path":2036,"category":1838,"updatedAt":1262,"sourceType":1173,"tags":2037},"Trusted Proxy 和 Tailscale Serve 怎么选","基于最新官方安全与 trusted proxy 文档，解释 OpenClaw 在 trusted-proxy、token/password 和 Tailscale Serve 之间各自适合什么场景。","/docs/operations/trusted-proxy-vs-tailscale-serve",[2031,1856,2032,1379,1196,1219],{"title":2039,"description":2040,"path":2041,"category":1838,"updatedAt":1305,"sourceType":1173,"tags":2042},"stable、beta、dev 更新通道该怎么选","基于最新官方 update CLI 与 Updating 文档，解释 OpenClaw 的 stable、beta、dev 三条更新轨道、auto-updater 行为和更适合的长期 rollout 顺序。","/docs/operations/update-channels-and-safe-rollout",[2043,1198,2044,2045,2046,2047],"update","stable","beta","dev","rollout",{"title":2049,"description":2050,"path":2051,"category":2052,"updatedAt":1411,"sourceType":1173,"tags":2053},"Anthropic context1m 的 429 和 fallback 应该怎么处理","基于最新官方 Gateway Troubleshooting 与 Model Failover 文档，解释 Anthropic 长上下文 429 为什么常只在长 session 里出现、什么时候该关掉 context1m，以及怎样用 fallback 把这类拒绝变成可恢复事件。","/docs/reference/anthropic-context1m-429-and-fallback","参考",[2054,2055,2056,2057,2058],"anthropic","429","context1m","failover","reference",{"title":2060,"description":2061,"path":2062,"category":2052,"updatedAt":1254,"sourceType":1173,"tags":2063},"API 与参考资料阅读入口","说明 OpenClaw 的参考资料应如何阅读，以及中文用户在查 CLI、配置、诊断和模块说明时该怎么找信息。","/docs/reference/api-reference-overview",[2058,1369,1748,2064],"diagnostics",{"title":2066,"description":2067,"path":2068,"category":2052,"updatedAt":1305,"sourceType":1173,"tags":2069},"approvals CLI、网关与节点 allowlist 怎么管理","基于最新官方 approvals CLI 与 Exec Approvals 文档，解释 openclaw approvals 在本机、Gateway 和 Node 上分别管理什么，以及 per-agent allowlist 最值得先守住哪些边界。","/docs/reference/approvals-cli-and-allowlist",[1510,1630,1508,1196,1018,2058],{"title":2071,"description":2072,"path":2073,"category":2052,"updatedAt":1411,"sourceType":1173,"tags":2074},"认证配置文件怎么轮转，为什么 session 会“粘住”同一套凭据","基于最新官方 Model Failover 文档，解释 OpenClaw 在同一 provider 内如何轮转 auth profiles、什么情况下会进入 cooldown，以及为什么同一个 session 往往会持续使用同一套凭据。","/docs/reference/auth-profile-rotation-and-session-pinning",[1379,1652,2057,1345,2058],{"title":2076,"description":2077,"path":2078,"category":2052,"updatedAt":1411,"sourceType":1173,"tags":2079},"setup code、bootstrapToken 和 /pair pending 应该怎么一起看","基于最新官方 Pairing 文档，解释 Telegram 首次设备接入时 setup code 里到底装了什么、bootstrapToken 只负责哪一步，以及为什么最后仍然要回到 /pair pending 做人工批准。","/docs/reference/bootstrap-code-and-pair-pending",[1544,2080,1431,1545,2058],"bootstrapToken",{"title":2082,"description":2083,"path":2084,"category":2058,"updatedAt":1340,"sourceType":1173,"tags":2085},"引导文件模板系统","AGENTS.md、SOUL.md、BOOTSTRAP.md 等引导文件的用途、写法和最佳实践。","/docs/reference/bootstrap-templates",[2086,1344,1388,1353,1948,1343],"templates",{"title":2088,"description":2089,"path":2090,"category":2052,"updatedAt":1401,"sourceType":1173,"tags":2091},"频道 pairing CLI 和 account scope 应该怎么一起看","基于最新官方 Pairing 文档，解释 openclaw pairing 的 list、approve、clear、--account 与 --notify 分别影响什么，以及多账号渠道下为什么不能只看一个默认 allowFrom 文件。","/docs/reference/channel-pairing-cli-and-account-scope",[1544,2092,1198,2093,1877],"allowFrom","account",{"title":2095,"description":2096,"path":2097,"category":2052,"updatedAt":1506,"sourceType":1173,"tags":2098},"CLI 命令参考","OpenClaw 命令行工具完整参考，包含所有命令和选项说明。","/docs/reference/cli-reference",[1369,2058,2099,2100],"commands","terminal",{"title":2102,"description":2103,"path":2104,"category":2052,"updatedAt":1411,"sourceType":1173,"tags":2105},"Cloudflare AI Gateway 的双层鉴权头应该怎么配","基于最新官方 Cloudflare AI Gateway 文档，解释 provider API key 和 cf-aig-authorization 为什么是两层不同凭据，以及 daemon 场景里最常见的缺失点。","/docs/reference/cloudflare-aig-dual-auth-headers",[2106,2107,1379,1377,2058],"cloudflare-ai-gateway","headers",{"title":2109,"description":2110,"path":2111,"category":2112,"updatedAt":1305,"sourceType":1456,"tags":2113},"社区支持","汇总 OpenClaw 的官方社区入口、反馈方式、提问建议和中文用户更适合的参与路径。","/docs/reference/community","社区",[1456,2114,2115,2116],"github","issues","feedback",{"title":2118,"description":2119,"path":2120,"category":2052,"updatedAt":1506,"sourceType":1173,"tags":2121},"配置参考","OpenClaw 完整配置项参考文档，包含所有可配置选项的详细说明。","/docs/reference/configuration-reference",[1210,2058,2122,2123],"settings","options",{"title":2125,"description":2126,"path":2127,"category":2052,"updatedAt":1262,"sourceType":1173,"tags":2128},"Control UI 设备配对与浏览器授权","基于最新官方 Control UI 与 Pairing 文档，解释为什么远程浏览器首次连接需要设备配对、设备身份如何记住，以及什么时候需要重新批准。","/docs/reference/control-ui-device-pairing",[1465,1544,1545,1486,1877],{"title":2130,"description":2131,"path":2132,"category":2052,"updatedAt":1411,"sourceType":1173,"tags":2133},"cron run 入队语义和 retry backoff 应该怎么理解","基于最新官方 cron CLI 与 Cron Jobs 文档，解释 openclaw cron run 为什么先返回 enqueued、何时该去看 runs，以及 recurring job 连续失败后的退避节奏。","/docs/reference/cron-run-queue-and-retry-backoff",[1367,1624,2134,1708,2058],"scheduler",{"title":2136,"description":2137,"path":2138,"category":2052,"updatedAt":1816,"sourceType":1173,"tags":2139},"Dashboard 的 SecretRef token、sessionStorage 和非 token 化 URL 应该怎么理解","基于最新官方 Dashboard 文档，解释 openclaw dashboard 在普通 token、SecretRef token 和远程入口下分别如何引导认证，以及为什么当前浏览器标签页的 sessionStorage 行为很关键。","/docs/reference/dashboard-secretref-and-sessionstorage",[1251,1485,2140,2141,1379],"secretref","sessionStorage",{"title":2143,"description":2144,"path":2145,"category":2146,"updatedAt":1506,"sourceType":1173,"tags":2147},"调试、运行时覆盖与开发排障","基于官方 debugging 和 FAQ 文档，整理 `/debug`、watch 模式、dev profile 以及排查流式输出异常时最值得先看的入口。","/docs/reference/debugging-and-runtime-overrides","排错",[2148,2149,2150,1896,1613],"debugging","debug","runtime-overrides",{"title":2152,"description":2153,"path":2154,"category":2052,"updatedAt":1384,"sourceType":1173,"tags":2155},"Diagnostics flags 和定向日志应该怎么用","基于最新官方 Diagnostics Flags 与 Logging 文档，解释 OpenClaw 如何用 diagnostics.flags 和 OPENCLAW_DIAGNOSTICS 打开定向调试日志，以及为什么这比全局 verbose 更适合长期排障。","/docs/reference/diagnostics-flags-and-targeted-logs",[2064,2156,2157,2149,2058],"logging","flags",{"title":2159,"description":2160,"path":2161,"category":2052,"updatedAt":1384,"sourceType":1173,"tags":2162},"dmScope 和 identityLinks 应该怎么一起用","基于最新官方会话管理文档，解释 OpenClaw 的 dmScope 四种模式、identityLinks 的真实作用，以及为什么多人 DM、跨渠道私聊和多账户环境不能只改一个开关。","/docs/reference/dm-scope-and-identity-links",[1405,2163,2164,1387,2058],"dmScope","identityLinks",{"title":2166,"description":2167,"path":2168,"category":2052,"updatedAt":1384,"sourceType":1173,"tags":2169},"doctor 的 repair、force 和 non-interactive 应该怎么选","基于最新官方 Doctor 文档，解释 openclaw doctor 在 interactive、--repair、--force、--yes、--non-interactive 和 --deep 之间各自会做什么，避免把修复模式混成“越猛越好”。","/docs/reference/doctor-repair-modes",[1896,1897,2064,2170,2058],"migrations",{"title":2172,"description":2173,"path":2174,"category":2052,"updatedAt":1384,"sourceType":1173,"tags":2175},"环境变量从哪里来，优先级怎么排","基于最新官方 Environment Variables 与 Configuration 文档，解释 OpenClaw 会从哪些来源读取环境变量、为什么默认不覆盖已有值，以及 `.env`、config env 和 shell import 之间真正的优先级。","/docs/reference/env-sources-and-precedence",[1751,1210,1413,2176,2058],"shell",{"title":2178,"description":2179,"path":2180,"category":2052,"updatedAt":1305,"sourceType":1193,"tags":2181},"如何结合官方文档、GitHub 和中文渠道跟踪 OpenClaw","把官方文档、GitHub Releases、Issues、中文教程站、媒体报道和中文社区解读放到同一套可信度框架里，减少信息滞后和误读。","/docs/reference/external-sources-and-trust-levels",[2182,1971,1456,2183,1973],"sources","trust",{"title":2185,"description":2186,"path":2187,"category":2052,"updatedAt":1262,"sourceType":1173,"tags":2188},"Gateway 命令与 RPC 该怎么用","基于最新官方 CLI Reference 与 Gateway protocol 文档，整理 openclaw gateway 子命令、RPC 调用边界、显式凭据要求，以及为什么它更适合被当成控制面入口而不是随手脚本助手。","/docs/reference/gateway-cli-and-rpc",[1196,2189,1369,1824,1359],"rpc",{"title":2191,"description":2192,"path":2193,"category":2052,"updatedAt":1384,"sourceType":1173,"tags":2194},"Gateway-owned pairing 和 device pairing 有什么区别","基于最新官方 Pairing 与 Gateway-owned pairing 文档，解释 node.pair.* 这套旧式网关配对和当前 WS device pairing 的真实边界，避免把两套授权机制混成一套。","/docs/reference/gateway-owned-pairing-vs-device-pairing",[1544,1545,1196,1358,2058],{"title":2196,"description":2197,"path":2198,"category":2052,"updatedAt":1816,"sourceType":1173,"tags":2199},"Gateway 为什么是 session source of truth","基于最新官方 Session 文档，解释 OpenClaw 的 session store、JSONL transcript、token 计数和 UI 查询为什么都应围绕 Gateway 理解，避免把本地浏览器、WebChat 或 operator 设备误当成真实状态源。","/docs/reference/gateway-session-source-of-truth",[1405,1196,1320,1251,2058],{"title":2201,"description":2202,"path":2203,"category":2052,"updatedAt":1411,"sourceType":1173,"tags":2204},"Gateway WebSocket 的 role 和 scope 应该怎么理解","基于最新官方 Gateway Protocol 文档，解释 OpenClaw 的 WebSocket 握手里 role、scopes、client mode 和协议版本各自在声明什么，以及为什么这条连接已经是统一控制面而不只是聊天通道。","/docs/reference/gateway-ws-roles-and-scopes",[1196,1824,2205,2206,2058],"protocol","scopes",{"title":2208,"description":2209,"path":2210,"category":2052,"updatedAt":1401,"sourceType":1173,"tags":2211},"groupPolicy、allowlist 和 mention gating 的顺序应该怎么理解","基于最新官方 Groups、Group Messages 和 Messages 文档，解释 OpenClaw 在群聊里如何按 groupPolicy、群组 allowlist 和 mention gating 三层顺序决定消息是丢弃、只进上下文，还是正式触发回复。","/docs/reference/group-policy-and-mention-gating-order",[1404,2212,1387,1630,1563],"mention",{"title":2214,"description":2215,"path":2216,"category":2052,"updatedAt":1411,"sourceType":1173,"tags":2217},"HEARTBEAT_OK、可见性控制和 quiet-hours 应该怎么一起看","基于最新官方 Heartbeat 与 Automation Troubleshooting 文档，解释 HEARTBEAT_OK 的 ack 语义、alerts-disabled 和 dm-blocked 等可见性控制，以及 quiet-hours 为什么不是故障。","/docs/reference/heartbeat-ack-and-visibility-controls",[1870,2218,2219,2220,2058],"visibility","activeHours","alerts",{"title":2222,"description":2223,"path":2224,"category":2052,"updatedAt":1401,"sourceType":1173,"tags":2225},"HTTP API、Gateway WebSocket 和 SDK 应该怎么分工","基于最新官方 API 与 Web 文档，解释 OpenClaw 里 HTTP API、Gateway WebSocket 和 SDK 各自适合什么场景，帮助团队判断当前到底应该走管理接口、实时会话层还是语言 SDK。","/docs/reference/http-api-vs-gateway-websocket-vs-sdk",[1818,1824,2226,1196,2058],"sdk",{"title":2228,"description":2229,"path":2230,"category":2052,"updatedAt":1401,"sourceType":1173,"tags":2231},"include 合并时，数组和 sibling override 到底怎么生效","基于最新官方 Configuration 文档，解释 OpenClaw 在 $include 合并时数组、对象和 sibling keys 的真实处理顺序，帮助团队避免把 include 当成“总是深合并”的黑盒。","/docs/reference/include-merge-arrays-and-sibling-overrides",[1210,2232,1848,2233,2058],"include","arrays",{"title":2235,"description":2236,"path":2237,"category":2052,"updatedAt":1384,"sourceType":1173,"tags":2238},"Lobster 的调用、审批和 resume token","基于最新官方 Lobster 文档，解释 OpenClaw 里如何用 openclaw.invoke 触发确定性工作流、何时进入 needs_approval，以及 resume token 在恢复流程里扮演什么角色。","/docs/reference/lobster-invoke-and-resume",[1659,2239,1510,1245,2058],"invoke",{"title":2241,"description":2242,"path":2243,"category":2052,"updatedAt":1411,"sourceType":1173,"tags":2244},"记忆检索里的 hybrid search、重排和时间衰减到底在做什么","基于最新官方 Memory 文档，解释 OpenClaw 的 memory_search 为什么不只是向量检索，以及 hybrid search、结果合并、MMR 重排和 temporal decay 各自在修正什么问题。","/docs/reference/memory-hybrid-search-and-ranking-pipeline",[1200,2245,2246,2247,2248,2058],"hybrid-search","ranking","mmr","retrieval",{"title":2250,"description":2251,"path":2252,"category":2052,"updatedAt":1305,"sourceType":1173,"tags":2253},"models status --probe 和 auth profiles 应该怎么看","基于最新官方 Models CLI 文档，解释 openclaw models status --probe、--probe-provider 与认证 profile 的关系，帮助团队区分“配置看起来对”和“当前真的能连通”。","/docs/reference/models-status-probe-and-auth-profiles",[1313,2254,1379,1377,2058],"probe",{"title":2256,"description":2257,"path":2258,"category":2052,"updatedAt":1746,"sourceType":1173,"tags":2259},"配对审批与设备授权管理","从管理员视角理解 OpenClaw 的 DM pairing、设备 pairing、allowFrom 文件和审批命令，避免把授权边界搞乱。","/docs/reference/pairing-admin",[1544,1545,2092,2260,1877],"credentials",{"title":2262,"description":2263,"path":2264,"category":2052,"updatedAt":1305,"sourceType":1173,"tags":2265},"插件安装 spec、--pin 和 update tracking 应该怎么理解","基于最新官方 plugins CLI 文档，解释 ClawHub first、npm-safe spec、--pin、prerelease opt-in 和 plugins.installs 的跟踪逻辑，帮助团队判断插件后续会按什么规则更新。","/docs/reference/plugins-install-specs-and-update-tracking",[1297,1439,420,2266,1973,2058],"pin",{"title":2268,"description":2269,"path":2270,"category":2146,"updatedAt":1262,"sourceType":1173,"tags":2271},"原始流日志怎么抓","基于最新官方 Debugging 文档，整理 OpenClaw 的 raw stream、pi-mono raw chunk 日志分别该在什么场景开启，以及如何避免把调试日志变成隐私风险。","/docs/reference/raw-stream-debugging",[2148,2272,1613,1377,1576],"raw-stream",{"title":2274,"description":2275,"path":2276,"category":2052,"updatedAt":1411,"sourceType":1173,"tags":2277},"remote auth fallback 和 tlsFingerprint 应该什么时候用","基于最新官方 Remote Access 文档，解释 gateway.remote 这套远程连接参数什么时候只是兜底、什么时候会 fail closed，以及 tlsFingerprint 在 wss 场景里真正保护什么。","/docs/reference/remote-auth-fallback-and-tls-fingerprint",[1264,2278,1379,1196,2058],"tlsFingerprint",{"title":2280,"description":2281,"path":2282,"category":2052,"updatedAt":1411,"sourceType":1173,"tags":2283},"回复机器人消息也算 mention 吗，pending history 又什么时候会进上下文","基于最新官方 Groups 与 Group Messages 文档，解释 OpenClaw 在群聊里怎样把 reply metadata 当成隐式 mention，以及未触发回复的群消息何时只进入 pending history、何时会被彻底丢弃。","/docs/reference/reply-mention-and-pending-history",[1404,2284,2285,2286,2058],"mentions","pending-history","reply",{"title":2288,"description":2289,"path":2290,"category":2052,"updatedAt":1384,"sourceType":1173,"tags":2291},"SecretRefs 和运行时快照应该怎么理解","基于最新官方 Secrets Management 文档，解释 env/file/exec secret refs 的解析时机、活动面、失败模式和热重载语义，避免把密钥管理误解成“请求时临时去取”。","/docs/reference/secret-refs-and-runtime-snapshot",[2292,2293,1342,1377,2058],"secrets","secretrefs",{"title":2295,"description":2296,"path":2297,"category":2052,"updatedAt":1401,"sourceType":1173,"tags":2298},"secure DM mode 和 owner pinning 应该怎么一起理解","基于最新官方 Session 与 Security 文档，解释 OpenClaw 的 secure DM mode、owner pinning、pairing / allowlist / open 三类 DM 入口，以及什么时候该从连续主会话切到隔离模式。","/docs/reference/secure-dm-mode-and-owner-pinning",[1405,1219,2163,1544,1630],{"title":2300,"description":2301,"path":2302,"category":2052,"updatedAt":2303,"sourceType":1173,"tags":2304},"session JSONL、compaction entry 和 branch summary 应该怎么理解","基于最新官方 Session Management Deep Dive 文档，解释 OpenClaw 的 session JSONL 结构、compaction entry、branch summary 和 store counters 分别在回答什么问题，避免把 transcript 文件当成一团无结构日志。","/docs/reference/session-jsonl-and-compaction-entries","2026-04-01",[1405,2305,2306,1773,2058],"transcript","jsonl",{"title":2308,"description":2309,"path":2310,"category":2052,"updatedAt":2303,"sourceType":1173,"tags":2311},"openclaw sessions 的 store scope 和巡检方式","基于最新官方 sessions CLI 文档，解释 openclaw sessions 在默认 agent、单 agent、all-agents 和显式 store 路径下分别在看什么，以及长期运维里为什么值得把它当作 session store 巡检入口。","/docs/reference/sessions-cli-store-scope-and-audit",[1345,1369,2312,1996,1218],"store",{"title":2314,"description":2315,"path":2316,"category":2052,"updatedAt":1411,"sourceType":1173,"tags":2317},"哪些配置会被官方当成 shared-user ingress 信号","基于最新官方 security audit 文档，解释 OpenClaw 为什么会把开放 DM、群目标和 wildcard sender 规则识别成 shared-user ingress 信号，以及这些提醒真正想让你检查什么。","/docs/reference/shared-user-ingress-signals",[1219,2011,1996,2318,2058],"ingress",{"title":2320,"description":2321,"path":2322,"category":2052,"updatedAt":1262,"sourceType":1173,"tags":2323},"status、health 和 logs 该怎么分工","基于最新官方 CLI reference，整理 openclaw status、health、logs 三组命令各自应该回答什么问题，以及值班和排障时更稳的使用顺序。","/docs/reference/status-health-and-logs",[1369,1905,2324,1613,2325],"health","troubleshooting",{"title":2327,"description":2328,"path":2329,"category":2052,"updatedAt":2303,"sourceType":1173,"tags":2330},"对话记录清理（provider fixups）到底改了什么，不改什么","基于最新官方 Transcript Hygiene 文档，解释 OpenClaw 在运行前对 transcript 做的 provider-specific fixups、图片清理、tool 调用配对修复和思考签名清理分别解决什么问题，以及为什么它不会重写磁盘 JSONL。","/docs/reference/transcript-hygiene-and-provider-fixups",[2305,2331,1377,2332,2058],"hygiene","tool-calls",{"title":2334,"description":2335,"path":2336,"category":2146,"updatedAt":1254,"sourceType":1173,"tags":2337},"故障排除与诊断思路","把 OpenClaw 常见问题按环境、入口、配置、认证和运行状态拆开，建立更高效的排查顺序。","/docs/reference/troubleshooting",[2325,1896,1905,1613],{"title":2339,"description":2340,"path":2341,"category":2052,"updatedAt":1384,"sourceType":1173,"tags":2342},"WebChat 的 history、inject 和展示边界","基于最新官方 WebChat 文档，整理 chat.history 的截断/占位规则、chat.inject 的真实用途，以及为什么 WebChat 看见的 transcript 不是原始 JSONL 的一比一镜像。","/docs/reference/webchat-history-and-inject-boundaries",[1320,2343,2344,2305,2058],"history","inject",{"title":2346,"description":2347,"path":2348,"category":1164,"updatedAt":1305,"sourceType":1173,"tags":2349},"国内云部署思路","面向中文团队整理 OpenClaw 在国内或面向国内网络环境部署时最该先判断的三件事：入口生态、模型端点和长期在线后的运维边界。","/docs/setup/china-cloud-deployment",[2350,2351,2352,1522,1924,1925],"china","cloud","deployment",{"title":2354,"description":2355,"path":2356,"category":1164,"updatedAt":1254,"sourceType":1173,"tags":2357},"部署方式怎么选","从本地安装、Docker、国内云模板和海外一键部署四类路径理解 OpenClaw 的部署选择，而不是只追求“最快装上”。","/docs/setup/deployment-options",[2352,1265,2358,2351,1178],"docker",{"title":5,"description":1166,"path":1169,"category":1164,"updatedAt":1179,"sourceType":1173,"tags":2360},[1176,420,1177,1178],{"title":2362,"description":2363,"path":2364,"category":1164,"updatedAt":1262,"sourceType":1173,"tags":2365},"安装器方式和升级路径怎么选","基于最新官方 Install 与 Updating 文档，整理 install.sh、install-cli.sh、PowerShell 安装器、全局包安装和 git 安装各自适合什么场景，以及后续升级时应该走哪条路径。","/docs/setup/installer-methods-and-upgrade-paths",[1176,2366,1177,585,1974],"updater",{"title":2368,"description":2369,"path":2370,"category":1164,"updatedAt":1506,"sourceType":1173,"tags":2371},"安装器、更新与卸载","基于官方安装器、更新和卸载文档，整理 OpenClaw 从首次安装到原地升级、服务移除和彻底卸载的完整维护路径。","/docs/setup/installer-update-and-uninstall",[1176,2366,2372,1896,1974],"uninstall",{"title":2374,"description":2375,"path":2376,"category":1164,"updatedAt":1506,"sourceType":1173,"tags":2377},"Linux 安装指南","在 Linux 服务器和桌面上安装和配置 OpenClaw 的详细指南。","/docs/setup/linux-installation",[859,1176,1257,2378],"server",{"title":2380,"description":2381,"path":2382,"category":1164,"updatedAt":1506,"sourceType":1173,"tags":2383},"macOS 安装指南","在 macOS 上安装和配置 OpenClaw 的详细指南。","/docs/setup/macos-installation",[853,1176,1257,2384],"apple",{"title":2386,"description":2387,"path":2388,"category":2389,"updatedAt":1254,"sourceType":1173,"tags":2390},"版本迁移与升级检查单","在 OpenClaw 版本升级前后，优先检查配置、CLI、认证和入口层变化，避免把升级直接变成线上事故。","/docs/setup/migration-guide","迁移",[2391,2392,1971,2393],"migration","upgrade","checklist",{"title":2395,"description":2396,"path":2397,"category":1164,"updatedAt":1506,"sourceType":1173,"tags":2398},"Windows 安装指南","在 Windows 上安装和配置 OpenClaw 的详细指南，推荐使用 WSL2。","/docs/setup/windows-installation",[865,1176,1257,1178],{"count":2400,"latestDate":1364,"items":2401},116,[2402,2410,2421,2428,2438,2446,2451,2460,2468,2474,2481,2488,2495,2503,2508,2518,2528,2535,2541,2551,2562,2570,2575,2581,2587,2595,2602,2608,2616,2622,2629,2635,2641,2647,2653,2659,2664,2670,2677,2683,2690,2696,2702,2707,2713,2719,2726,2732,2737,2748,2754,2760,2766,2773,2780,2786,2792,2798,2808,2814,2820,2825,2831,2836,2843,2849,2855,2860,2866,2872,2877,2883,2888,2894,2900,2906,2912,2918,2923,2928,2935,2941,2949,2954,2960,2968,2974,2980,2986,2993,2998,3003,3010,3015,3020,3026,3032,3039,3045,3050,3056,3061,3072,3080,3085,3093,3098,3105,3110,3116,3121,3127,3132,3140,3146,3152],{"title":2403,"description":2404,"path":2405,"category":2406,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":2409},"OpenClaw 支持超过 50 个集成平台","OpenClaw 宣布已支持超过 50 个消息和生产力平台集成，成为最全面的 AI 助手解决方案。","/news/50-integrations","生态动态","2026-03-09","openclaw.ai",[1833,1198,1457],{"title":2411,"description":2412,"path":2413,"category":2414,"date":2415,"updatedAt":1288,"sourceType":1173,"source":2408,"tags":2416},"OpenClaw 与主流 AI 模型对比分析","深入对比 OpenClaw 支持的各类 AI 模型，帮助用户选择最适合自己需求的模型配置。","/news/ai-model-comparison","技术深度","2026-03-07",[1313,2417,2418,1651,2419,2420],"comparison","gpt","llama","analysis",{"title":2422,"description":2423,"path":2424,"category":2425,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":2426},"OpenClaw 支持多种 AI 模型选择","OpenClaw 支持 Anthropic Claude、OpenAI GPT 和本地模型，为用户提供灵活的 AI 选择。","/news/ai-model-flexibility","功能介绍",[2427,1313,1651,2418,1265],"ai",{"title":2429,"description":2430,"path":2431,"category":2432,"date":2433,"updatedAt":1288,"sourceType":2114,"source":2434,"tags":2435},"OpenClaw API v2 正式发布","OpenClaw 发布全新 API v2 版本，带来更强大的功能、更好的性能和更完善的开发者体验。","/news/api-v2-release","产品更新","2026-03-10","github.com/openclaw/openclaw",[1818,2436,2437,2226],"v2","developer",{"title":2439,"description":2440,"path":2441,"category":2442,"date":2433,"updatedAt":2433,"sourceType":1173,"source":2443,"tags":2444},"OpenClaw on AWS：云上一键部署指南发布","AWS 官方发布 OpenClaw on Lightsail 部署指南，用户可在 AWS 云平台快速部署自己的 AI 助手实例。","/news/aws-lightsail-deployment","云服务集成","AWS Blog",[1376,2351,2352,2445],"lightsail",{"title":2447,"description":2448,"path":2449,"category":2432,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":2450},"OpenClaw 浏览器自动化功能升级","OpenClaw 浏览器自动化功能迎来重大升级，支持更多操作和更好的稳定性。","/news/browser-automation-v2",[1486,1246,1971,2043],{"title":2452,"description":2453,"path":2454,"category":2425,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":2455},"OpenClaw Canvas 实时可视化功能详解","深入了解 OpenClaw 的 Canvas 功能，如何使用 A2UI 语法创建交互式可视化界面。","/news/canvas-a2ui",[2456,2457,2458,2459],"canvas","a2ui","visualization","ui",{"title":2461,"description":2462,"path":2463,"category":2464,"date":1506,"updatedAt":1506,"sourceType":1456,"source":2465,"tags":2466},"OpenClaw 中国社区热潮：本地化部署与中文教程需求激增","OpenClaw 在中国市场迎来爆发式增长，小红书、知乎等平台讨论热度持续攀升，中文教程和本地化部署成为用户最关注的话题。","/news/china-community-boom","社区动态","社区观察",[2350,1456,1228,2467],"localization",{"title":2469,"description":2470,"path":2471,"category":2406,"date":2407,"updatedAt":1254,"sourceType":2114,"source":2472,"tags":2473},"ClawHub 技能市场突破 300 技能大关","OpenClaw 官方技能市场 ClawHub 已收录超过 300 个开源技能，为用户提供丰富的扩展选择。","/news/clawhub-300-skills","github.com/openclaw/clawhub",[1211,1439,1457,1297],{"title":2475,"description":2476,"path":2477,"category":2464,"date":2407,"updatedAt":1254,"sourceType":1456,"source":2478,"tags":2479},"OpenClaw 开发者社区突破 5 万人","OpenClaw 开发者社区持续增长，Discord 成员已超过 50,000 人。","/news/developer-community","discord.gg/openclaw",[1456,1433,1207,2480],"growth",{"title":2482,"description":2483,"path":2484,"category":2485,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":2486},"OpenClaw Discord 集成配置","了解如何将 Discord Bot 连接到 OpenClaw，实现服务器和频道管理。","/news/discord-integration","渠道指南",[1433,1780,2487,1228],"channel",{"title":2489,"description":2490,"path":2491,"category":2432,"date":2407,"updatedAt":1254,"sourceType":2114,"source":2492,"tags":2493},"OpenClaw 企业部署最佳实践发布","OpenClaw 官方发布企业级部署指南，包含 Ansible 自动化、容器化部署和安全配置。","/news/enterprise-deployment","github.com/openclaw/openclaw-ansible",[1217,2352,2494,2358],"ansible",{"title":2496,"description":2497,"path":2498,"category":2499,"date":2500,"updatedAt":1288,"sourceType":1173,"source":2408,"tags":2501},"OpenClaw 企业版功能详解","深入了解 OpenClaw 企业版的专属功能、部署方案和安全特性，助力企业数字化转型。","/news/enterprise-edition-guide","产品介绍","2026-03-06",[1217,2352,1219,2502],"features",{"title":2504,"description":2505,"path":2506,"category":2485,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":2507},"OpenClaw 飞书集成配置","了解如何将 OpenClaw 集成到飞书，实现企业协作。","/news/feishu-integration",[1522,1523,2487,1217,1228],{"title":2509,"description":2510,"path":2511,"category":2512,"date":1288,"updatedAt":1288,"sourceType":1456,"source":2513,"tags":2514},"OpenClaw 创始人 Peter Steinberger：从独立开发者到开源明星","OpenClaw 创始人 Peter Steinberger 的创业故事，从 Clawdbot/Moltbot 到爆火开源项目的历程。","/news/founder-story","人物故事","社区整理",[2515,2516,2517,1456],"founder","story","opensource",{"title":2519,"description":2520,"path":2521,"category":2522,"date":2407,"updatedAt":1254,"sourceType":2114,"source":2523,"tags":2524},"OpenClaw GitHub 星标突破 28.7 万","OpenClaw 开源项目在 GitHub 上的星标数突破 287,000，成为最受欢迎的开源 AI 助手项目之一。","/news/github-stars-milestone","项目动态","github.com/openclaw",[2114,2525,2526,2527],"stars","milestone","open-source",{"title":2529,"description":2530,"path":2531,"category":2432,"date":2532,"updatedAt":1506,"sourceType":2114,"source":2434,"tags":2533},"OpenClaw 本地模型支持全面升级","OpenClaw 现已支持更多本地大语言模型，包括 Llama 3、Mistral、Qwen 等，让用户在保护隐私的同时享受 AI 能力。","/news/local-model-support","2026-03-05",[1574,1576,2419,2534,1573],"mistral",{"title":2536,"description":2537,"path":2538,"category":2432,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":2539},"OpenClaw macOS 伴侣应用 Beta 发布","OpenClaw 推出专为 macOS 15+ 设计的伴侣应用，提供更便捷的菜单栏访问体验。","/news/macos-companion-app",[853,2540,2045,1971],"app",{"title":2542,"description":2543,"path":2544,"category":2545,"date":2407,"updatedAt":1254,"sourceType":2546,"source":2408,"tags":2547},"OpenClaw 获 MacStories 专题报道：个人 AI 助手的未来","知名科技媒体 MacStories 发表专题报道，高度评价 OpenClaw 为个人 AI 助手领域带来的创新。","/news/media-coverage","媒体报道","media",[2546,2548,2549,2550],"macstories","coverage","press",{"title":2552,"description":2553,"path":2554,"category":2555,"date":1254,"updatedAt":1254,"sourceType":1351,"source":2556,"tags":2557},"外部报道：Meta 收购 Moltbook，OpenClaw 生态再次进入主流视野","根据 2026 年 3 月 11 日自动抓取的外部报道，Meta 已收购基于 OpenClaw 构建的 AI 代理社交网络 Moltbook。本文将事件背景、与 OpenClaw 的关联，以及对中文用户的参考价值整理为站点可读版本。","/news/meta-moltbook-openclaw-background","行业动态","自动抓取外部报道（2026-03-11）",[2558,2559,461,2560,2561],"meta","moltbook","ai-agent","industry",{"title":2563,"description":2564,"path":2565,"category":2432,"date":2566,"updatedAt":1288,"sourceType":1173,"source":2408,"tags":2567},"OpenClaw 移动端体验全面优化","OpenClaw 发布移动端重大更新，带来全新界面设计、性能优化和多项新功能。","/news/mobile-experience-update","2026-03-08",[1420,1667,1668,2568,2569],"ux","performance",{"title":2571,"description":2572,"path":2573,"category":2432,"date":1506,"updatedAt":1288,"sourceType":2114,"source":2434,"tags":2574},"OpenClaw 多 Agent 协作功能正式发布","OpenClaw 发布多 Agent 协作功能，支持多个 AI 代理协同工作，实现复杂任务的自动化处理。","/news/multi-agent-collaboration",[1298,1526,1245,1246],{"title":2576,"description":2577,"path":2578,"category":2425,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":2579},"OpenClaw 多平台客户端详解","了解 OpenClaw 在 macOS、iOS、Android 等多平台上的客户端能力，以及如何实现跨设备无缝使用。","/news/multiplatform-clients",[2580,853,1667,1668,1666],"clients",{"title":2582,"description":2583,"path":2584,"category":2432,"date":2532,"updatedAt":1254,"sourceType":2114,"source":2434,"tags":2585},"OpenClaw 2026.3.7 版本观察","结合最新 release 观察当前版本中最值得中文用户优先关注的变化方向。","/news/mvp-launch",[1971,2586,1972],"version",{"title":2588,"description":2589,"path":2590,"category":2591,"date":2592,"updatedAt":1288,"sourceType":1173,"source":2408,"tags":2593},"OpenClaw 开源一周年：回顾与展望","OpenClaw 开源项目迎来一周年里程碑，回顾这一年的成长历程和社区贡献。","/news/open-source-anniversary","官方公告","2026-03-01",[2594,2527,1456,2526],"anniversary",{"title":2596,"description":2597,"path":2598,"category":2432,"date":2599,"updatedAt":1262,"sourceType":2114,"source":2600,"tags":2601},"OpenClaw 2026.3.13 官方发布：Cron、插件碰撞、Docker 时区和网关稳定性继续修复","基于 2026 年 3 月 14 日发布的官方 GitHub Release，整理本轮最值得中文站读者关注的调度、插件、Docker、渠道和 UI 修复点。","/news/openclaw-2026-3-13-release","2026-03-14","https://github.com/openclaw/openclaw/releases",[1971,1972,1367,1297,2358,1196],{"title":2603,"description":2604,"path":2605,"category":2432,"date":2303,"updatedAt":1364,"sourceType":2114,"source":2606,"tags":2607},"OpenClaw 2026.4.1 发布：/tasks、SearXNG、Bedrock Guardrails 和 Feishu 评论流进入主线","2026 年 4 月 1 日的 OpenClaw 2026.4.1 版本，把后台任务板、SearXNG 搜索、Bedrock Guardrails 和 Feishu Drive 评论流一起推进到了更成熟的位置。","/news/openclaw-2026-4-1-release","https://github.com/openclaw/openclaw/releases/tag/v2026.4.1",[1971,1366,1716,1375,1522,1378],{"title":2609,"description":2610,"path":2611,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2613,"tags":2614},"OpenClaw 集成观察：HTTP API、Gateway WebSocket 与 SDK 的三层接口面正在被官方写清","基于 2026 年 3 月 25 日可见的官方 API、Web 与 Gateway 文档，最近开发者侧最值得关注的变化之一是不同接口面的分工正在被官方主动拆清。","/news/openclaw-api-surface-watch-2026-03-25","生态观察","https://docs.openclaw.ai/api/v2",[1818,1824,2226,1196,2615],"integration",{"title":2617,"description":2618,"path":2619,"category":2612,"date":1305,"updatedAt":1305,"sourceType":1173,"source":2620,"tags":2621},"OpenClaw 执行审批观察：CLI、per-agent allowlist 与聊天转发正在把宿主机执行面做成正式治理层","基于 2026 年 3 月 24 日可见的官方 approvals CLI 与 Exec Approvals 文档，最近最值得关注的信号不是“能不能审批”，而是宿主机执行边界已经开始形成一套完整治理面。","/news/openclaw-approvals-surface-watch-2026-03-24","https://docs.openclaw.ai/tools/exec-approvals",[1510,1508,1630,1219,1196,1018],{"title":2623,"description":2624,"path":2625,"category":2612,"date":1816,"updatedAt":1816,"sourceType":1173,"source":2626,"tags":2627},"OpenClaw 开始把 AUTH_TOKEN_MISMATCH 写成可恢复的漂移场景","官方最新 Dashboard 文档把 AUTH_TOKEN_MISMATCH、trusted retry 和 token drift recovery 串成了一条更完整的恢复路径，让认证失败不再只是黑箱报错。","/news/openclaw-auth-mismatch-retry-watch-2026-03-26","https://docs.openclaw.ai/web/dashboard",[1251,1379,2628,1624,1884],"drift",{"title":2630,"description":2631,"path":2632,"category":2612,"date":1411,"updatedAt":1411,"sourceType":1173,"source":2633,"tags":2634},"OpenClaw 的自动化运维面正在收成一条更清楚的排障梯子","官方最近围绕 Heartbeat、cron CLI 和 Automation Troubleshooting 的文档更新，正在把自动化问题从“感觉没触发”收敛成更可观测的几层：调度、入队、运行结果、可见性与时间窗口。","/news/openclaw-automation-ops-ladder-watch-2026-03-29","https://docs.openclaw.ai/automation/troubleshooting",[1246,1870,1367,2325,1218],{"title":2636,"description":2637,"path":2638,"category":2612,"date":1364,"updatedAt":1364,"sourceType":1173,"source":2639,"tags":2640},"OpenClaw 正在把 /tasks 做成后台工作总账本，而不是聊天里的附属提示","官方近期补全的 Background Tasks 与 tasks CLI 文档，说明 OpenClaw 的后台任务体系已经从隐式执行，转向更正式的 ledger、审计和清理模型。","/news/openclaw-background-tasks-watch-2026-04-30","https://docs.openclaw.ai/automation/tasks",[1366,1246,1367,1368,1996,1218],{"title":2642,"description":2643,"path":2644,"category":2612,"date":1364,"updatedAt":1364,"sourceType":1173,"source":2645,"tags":2646},"OpenClaw 的 Amazon Bedrock 接入开始把 Guardrails 正式推到 provider 层","官方近期完善的 Amazon Bedrock 文档，把 AWS credential chain、自动发现和 Guardrails 全部写到了同一页里，说明 Bedrock 正在从能接入走向能治理。","/news/openclaw-bedrock-guardrails-watch-2026-04-30","https://docs.openclaw.ai/providers/bedrock",[1375,1376,1378,1377,1675],{"title":2648,"description":2649,"path":2650,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2651,"tags":2652},"OpenClaw 开始把 Broadcast Groups 从路由技巧推进成多代理协作入口","官方最新 Broadcast Groups 文档把多 agent 同群运行的触发条件、session 隔离和处理策略写得更完整了，也让它和普通 bindings 的分工更清楚。","/news/openclaw-broadcast-groups-watch-2026-03-25","https://docs.openclaw.ai/channels/broadcast-groups",[1403,1388,1404,1387,1432],{"title":2654,"description":2655,"path":2656,"category":2612,"date":1411,"updatedAt":1411,"sourceType":1173,"source":2657,"tags":2658},"OpenClaw 的浏览器管理员面正在收成一条完整信任链","官方最近围绕 Pairing、Remote Access、Trusted Proxy Auth 和 Dashboard 的文档更新，正在把浏览器入口从“页面能打开”收敛成“地址、认证、设备与 operator 权限”四层联动的信任链。","/news/openclaw-browser-trust-chain-watch-2026-03-29","https://docs.openclaw.ai/gateway/trusted-proxy-auth",[1251,2031,1544,1264,1219],{"title":2660,"description":2661,"path":2662,"category":2612,"date":1305,"updatedAt":1305,"sourceType":1173,"source":2620,"tags":2663},"OpenClaw 渠道观察：Telegram 和 Discord 正在从聊天入口扩展成正式审批面","基于 2026 年 3 月 24 日可见的官方 Exec Approvals 文档，Telegram 与 Discord 最近最值得关注的变化不是又多了一个命令，而是它们已经开始承担受控审批入口。","/news/openclaw-channel-approval-clients-watch-2026-03-24",[1431,1433,1510,1198,1986],{"title":2665,"description":2666,"path":2667,"category":2464,"date":1192,"updatedAt":1192,"sourceType":1456,"source":2668,"tags":2669},"OpenClaw 在中国 AI 生态中的位置：从中文教程热到本地化能力竞赛","基于 2026 年 3 月 16 日整理素材，梳理 OpenClaw 在中国 AI 生态里的关注点：本地部署、中文模型接入、数据安全与本土服务集成。","/news/openclaw-china-ecosystem-watch-2026-03-16","content/tmp/2026-03-16/openclaw-china-ai-ecosystem-analysis.md",[2350,1457,2467,2420],{"title":2671,"description":2672,"path":2673,"category":2612,"date":1305,"updatedAt":1305,"sourceType":1173,"source":2674,"tags":2675},"OpenClaw ClawHub 观察：sync、lockfile 与最小 telemetry 让技能注册表更像正式分发生态","基于 2026 年 3 月 24 日可见的官方 ClawHub 文档，最近最值得关注的变化不是“技能数量”，而是技能分发、版本记录和同步行为正在更像一套正式 registry。","/news/openclaw-clawhub-sync-watch-2026-03-24","https://docs.openclaw.ai/tools/clawhub",[1439,1211,1448,1449,2676,1440],"telemetry",{"title":2678,"description":2679,"path":2680,"category":2406,"date":1262,"updatedAt":1262,"sourceType":1173,"source":2681,"tags":2682},"OpenClaw CLI 观察：命令行已经不只是辅助工具，而是在慢慢收敛成正式控制面","基于 2026 年 3 月 21 日可见的官方 CLI Reference、Gateway protocol 与 Dashboard 文档，整理最近最值得中文站关注的 CLI 变化：status/health/logs 分层、gateway RPC 边界，以及 Dashboard 和 CLI 之间更清晰的协作关系。","/news/openclaw-cli-control-plane-watch-2026-03-21","https://docs.openclaw.ai/cli",[1369,1196,2189,1359,1218],{"title":2684,"description":2685,"path":2686,"category":2612,"date":1384,"updatedAt":1384,"sourceType":1173,"source":2687,"tags":2688},"OpenClaw 的配置分层边界越来越清楚","官方最近围绕 Environment Variables、Configuration、Logging 和 Debugging 的文档更新，正在把正式配置、env 注入和一次性 override 拆成更清楚的层。","/news/openclaw-configuration-layering-watch-2026-03-22","https://docs.openclaw.ai/help/environment",[1210,1751,1386,2689,1218],"overrides",{"title":2691,"description":2692,"path":2693,"category":2406,"date":1262,"updatedAt":1262,"sourceType":1173,"source":2600,"tags":2694},"OpenClaw 上下文观察：Compaction、Session 连续性与 persona 保真正在成为官方显式关注点","基于 2026 年 3 月 21 日可见的官方 Context 文档与 GitHub Releases 页面，整理最近最值得中文站关注的上下文变化：compaction 后 token 检查、session continuity、persona/language 保真，以及它们对长期使用的意义。","/news/openclaw-context-compaction-watch-2026-03-21",[1772,1773,1345,1200,2695],"continuity",{"title":2697,"description":2698,"path":2699,"category":2406,"date":1262,"updatedAt":1262,"sourceType":1173,"source":2700,"tags":2701},"OpenClaw 控制面观察：Control UI、设备配对与 Tailscale Serve 正在把浏览器管理做成正式能力","基于 2026 年 3 月 21 日可见的官方 Control UI、Dashboard、Pairing 与 Tailscale 文档，整理最近最值得关注的控制面变化：浏览器设备配对、语言支持、远程 Serve 与更明确的管理面边界。","/news/openclaw-control-surface-watch-2026-03-21","https://docs.openclaw.ai/web/control-ui",[1465,1251,1856,1544,1264],{"title":2703,"description":2704,"path":2705,"category":2612,"date":1816,"updatedAt":1816,"sourceType":1173,"source":2626,"tags":2706},"OpenClaw 正在把 Dashboard bootstrap 写成更安全的默认路径","官方最新 Dashboard 文档更明确地说明了 openclaw dashboard 在 localhost、SecretRef token 和 headless 环境里的引导行为，也让它更像正式控制面入口。","/news/openclaw-dashboard-bootstrap-watch-2026-03-26",[1251,1344,2140,1379,1465],{"title":2708,"description":2709,"path":2710,"category":2612,"date":1305,"updatedAt":1305,"sourceType":1173,"source":2626,"tags":2711},"OpenClaw Web 控制面观察：Dashboard 与 WebChat 的认证引导和回流边界正在变清楚","基于 2026 年 3 月 24 日可见的官方 dashboard CLI、Web Dashboard 与 WebChat 文档，最近 Web 控制面最值得关注的变化是认证引导、SecretRef token 处理和 WebChat 回流边界正在被主动写清。","/news/openclaw-dashboard-webchat-auth-watch-2026-03-24",[1251,1320,1485,2140,1387,2712],"web",{"title":2714,"description":2715,"path":2716,"category":2406,"date":1192,"updatedAt":1192,"sourceType":1456,"source":2717,"tags":2718},"OpenClaw 开发者生态扩张观察：中文技能与本地工作流成为新增长点","基于 2026 年 3 月 16 日临时素材，整理 OpenClaw 开发者生态在中文社区中的扩展方向，重点关注中文技能、本地平台集成与企业工作流落地。","/news/openclaw-developer-ecosystem-watch-2026-03-16","content/tmp/2026-03-16/openclaw-developer-ecosystem-expansion.md",[1207,1211,1457,2350],{"title":2720,"description":2721,"path":2722,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2723,"tags":2724},"OpenClaw 的 devices CLI 正在把设备授权写成一条完整生命周期","官方最近围绕 devices CLI 的补强，让 approve、revoke、rotate 和 fresh token 不再像零散命令，而更像完整的设备授权生命周期。","/news/openclaw-device-token-lifecycle-watch-2026-03-25","https://docs.openclaw.ai/channels/pairing",[1545,1544,1485,1890,2725],"rotate",{"title":2727,"description":2728,"path":2729,"category":2612,"date":1384,"updatedAt":1384,"sourceType":1173,"source":2730,"tags":2731},"OpenClaw 的诊断与修复工作流正在成型","官方最近围绕 Doctor、Diagnostics Flags、Debugging 和 sessions cleanup 的文档更新，正在把 OpenClaw 的排障方式从“看日志猜”推进到更清楚的 repair ladder。","/news/openclaw-diagnostics-repair-watch-2026-03-22","https://docs.openclaw.ai/doctor",[1896,2064,1897,2148,1218],{"title":2733,"description":2734,"path":2735,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2730,"tags":2736},"OpenClaw 排障观察：doctor 正在从“检查器”继续长成带备份心智的修复入口","基于 2026 年 3 月 25 日可见的官方 Doctor 文档，最近排障层最值得关注的变化之一是 doctor 对 stale config、unknown keys 和 legacy 状态的处理边界越来越清楚。","/news/openclaw-doctor-repair-boundary-watch-2026-03-25",[1896,1897,1748,1974,2064],{"title":2738,"description":2739,"path":2740,"category":2741,"date":1192,"updatedAt":1192,"sourceType":1456,"source":2742,"tags":2743},"OpenClaw 教育场景观察：AI 助教、个性化学习与高校试点想象空间","基于 2026 年 3 月 16 日教育领域临时稿，梳理 OpenClaw 在高校与教学场景中的潜在落地方向，包括答疑、学习路径推荐和教师工作流辅助。","/news/openclaw-education-adoption-watch-2026-03-16","行业观察","content/tmp/2026-03-16/openclaw-education-sector-adoption.md",[2744,2745,2746,2747],"education","adoption","ai-tutor","higher-education",{"title":2749,"description":2750,"path":2751,"category":2741,"date":1192,"updatedAt":1192,"sourceType":1456,"source":2752,"tags":2753},"OpenClaw 企业应用热度上升：中文团队更关注私有化部署与流程接入","基于 2026 年 3 月 16 日企业方向临时稿，整理 OpenClaw 在中文企业场景中的关注重点，包括私有化部署、安全边界、行业接入与内部工作流自动化。","/news/openclaw-enterprise-adoption-watch-2026-03-16","content/tmp/2026-03-16/openclaw-enterprise-adoption-boom.md",[1217,2352,1245,2350],{"title":2755,"description":2756,"path":2757,"category":2406,"date":1262,"updatedAt":1262,"sourceType":1173,"source":2758,"tags":2759},"OpenClaw 扩展层观察：ClawHub、插件托管 hooks 与 onboarding 勾选正在把扩展能力收拢成一条更完整链路","基于 2026 年 3 月 21 日可见的官方 Skills、ClawHub、Plugins 与 Hooks 文档，整理最近最值得中文站关注的扩展层变化：技能 registry、插件托管 hooks，以及 onboarding 阶段对推荐 hooks 的直接引导。","/news/openclaw-extension-stack-watch-2026-03-21","https://docs.openclaw.ai/automation/hooks",[1211,1439,1297,1299,1458],{"title":2761,"description":2762,"path":2763,"category":2612,"date":1364,"updatedAt":1364,"sourceType":1173,"source":2764,"tags":2765},"OpenClaw 的 Feishu 入口正在从聊天机器人走向文档协作流","官方近期更新的 Feishu 文档，把扫码接入、群控边界和 Drive 评论线程动作都写进了主线，说明 Feishu 已经不只是简单聊天入口。","/news/openclaw-feishu-drive-comments-watch-2026-04-30","https://docs.openclaw.ai/channels/feishu",[1522,1523,1524,1525,1198,1526],{"title":2767,"description":2768,"path":2769,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2770,"tags":2771},"OpenClaw 正在把 gateway-owned pairing 的过期与轮换边界说清楚","官方最新 Gateway-owned pairing 文档把 pending request 的 5 分钟过期、fresh token 生成和 UI 只是审批前端这几层边界写得更清楚了。","/news/openclaw-gateway-pairing-expiry-watch-2026-03-25","https://docs.openclaw.ai/gateway/pairing",[1196,1544,2772,1485,1358],"pending",{"title":2774,"description":2775,"path":2776,"category":2612,"date":1816,"updatedAt":1816,"sourceType":1173,"source":2777,"tags":2778},"OpenClaw 正在把 Gateway 的 session source-of-truth 地位写得更明确","官方最新 Session 文档更明确地说明 session store、JSONL transcript 和 token 计数都应围绕 Gateway 理解，这会直接影响 WebChat、Dashboard 和远程 operator 的排障方式。","/news/openclaw-gateway-source-of-truth-watch-2026-03-26","https://docs.openclaw.ai/session",[1196,1405,1320,1251,2779],"state",{"title":2781,"description":2782,"path":2783,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2784,"tags":2785},"OpenClaw 开始把群聊入口判断顺序写成可复述规则","官方最近在 Groups、Group Messages 和 Messages 文档里，把群入口的 groupPolicy、allowlist 和 mention gating 顺序写得更完整了，也让“没回”和“没进系统”首次更容易区分。","/news/openclaw-group-policy-watch-2026-03-25","https://docs.openclaw.ai/channels/groups",[1404,2212,1630,1563,1387],{"title":2787,"description":2788,"path":2789,"category":2612,"date":1411,"updatedAt":1411,"sourceType":1173,"source":2784,"tags":2790},"OpenClaw 正在把群触发从“@一下就行”写成更完整的治理链","官方最近围绕 Groups、Group Messages 和 Broadcast Groups 的文档更新，正在把 reply-to implicit mention、pending history、forum topic session key 和 shared-group rollout 写成更完整的群入口治理链。","/news/openclaw-group-trigger-governance-watch-2026-03-29",[1404,2284,2791,1403,1675],"activation",{"title":2793,"description":2794,"path":2795,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2796,"tags":2797},"OpenClaw 配置观察：include 合并边界正在从“能拆文件”继续走向“能预测最终结果”","基于 2026 年 3 月 25 日可见的官方 Configuration 文档，最近配置层最值得关注的变化之一是 include、数组处理和 sibling override 的顺序正在被官方主动写清。","/news/openclaw-include-merge-boundary-watch-2026-03-25","https://docs.openclaw.ai/gateway/configuration",[1210,2232,1848,2233,1218],{"title":2799,"description":2800,"path":2801,"category":2406,"date":1262,"updatedAt":1262,"sourceType":1173,"source":2802,"tags":2803},"OpenClaw 官方 Showcase 基础设施观察：Home Assistant、Nix 与远程文件流转正在成为高频落地方向","基于 2026 年 3 月 21 日可见的官方 Showcase 页面，整理最近最值得关注的基础设施与部署类案例，观察 OpenClaw 在家庭服务器、可复现部署和远程实例运维上的真实应用。","/news/openclaw-infra-showcase-watch-2026-03-21","https://docs.openclaw.ai/start/showcase",[2804,2352,2805,2806,2807],"showcase","home-assistant","nix","infrastructure",{"title":2809,"description":2810,"path":2811,"category":2612,"date":1384,"updatedAt":1384,"sourceType":1173,"source":2812,"tags":2813},"OpenClaw 的长期会话治理能力正在变完整","官方最近围绕 session、memory、compaction 和 secure DM mode 的文档更新，正在把长期连续性、上下文边界和重置策略拼成一条更完整的治理链。","/news/openclaw-long-session-governance-watch-2026-03-22","https://docs.openclaw.ai/concepts/session",[1345,1200,1773,2695,1675],{"title":2815,"description":2816,"path":2817,"category":2612,"date":1384,"updatedAt":1384,"sourceType":1173,"source":2818,"tags":2819},"OpenClaw 的后台维护生命周期正在变清楚","官方最近围绕 cron、sessions cleanup、doctor 和 retention 的文档更新，正在把长期运行时的会话、日志和作业痕迹分成更清楚的维护层次。","/news/openclaw-maintenance-lifecycle-watch-2026-03-22","https://docs.openclaw.ai/cron",[1974,1367,1345,1863,1218],{"title":2821,"description":2822,"path":2823,"category":2432,"date":2407,"updatedAt":1254,"sourceType":2114,"source":2434,"tags":2824},"OpenClaw 2026年3月版本更新：技能系统与安全性全面升级","OpenClaw 发布重要更新，带来性能优化、全新技能系统和安全性改进。","/news/openclaw-march-2026-update",[1971,2043,1972,1211,1219],{"title":2826,"description":2827,"path":2828,"category":2612,"date":1305,"updatedAt":1305,"sourceType":1173,"source":2829,"tags":2830},"OpenClaw 记忆观察：Markdown 仍然是 source of truth，memory plugin slot 正在把索引层做成可切换能力","基于 2026 年 3 月 24 日可见的官方 Memory、CLI memory 与 Plugins 文档，最近最值得关注的变化之一是记忆体系的文件事实层和插件增强层正在被官方主动拆清。","/news/openclaw-memory-plugin-slot-watch-2026-03-24","https://docs.openclaw.ai/concepts/memory",[1200,1297,1598,1590,1605],{"title":2832,"description":2833,"path":2834,"category":2612,"date":1411,"updatedAt":1411,"sourceType":1173,"source":2829,"tags":2835},"OpenClaw 正在把记忆检索从“向量搜索”写成一条完整流水线","官方最近围绕 Memory 和 memory CLI 的文档更新，正在把 hybrid search、重排、temporal decay、session indexing 和 embedding cache 逐步写成一条更完整的检索链。","/news/openclaw-memory-retrieval-pipeline-watch-2026-03-29",[1200,2248,2245,1606,1728],{"title":2837,"description":2838,"path":2839,"category":2406,"date":1262,"updatedAt":1262,"sourceType":1173,"source":2802,"tags":2840},"OpenClaw 官方 Showcase 记忆观察：WhatsApp Memory Vault、Karakeep 与中文学习 Skill 正在把语音和知识流转成长期资产","基于 2026 年 3 月 21 日可见的官方 Showcase 页面，整理最近最值得中文站关注的记忆与知识类案例，观察 OpenClaw 如何把转录、向量检索和学习流程接成长链路。","/news/openclaw-memory-showcase-watch-2026-03-21",[2804,1200,1493,2841,2842],"vector-search","knowledge",{"title":2844,"description":2845,"path":2846,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2847,"tags":2848},"OpenClaw 的 mention gating 正在从单一 @ 规则变成跨渠道触发层","官方最新 Groups 和 Group Messages 文档显示，mention gating 已经不再只服务 WhatsApp 群，而是在 Telegram、Slack、Discord、iMessage 等入口上逐步形成统一触发层。","/news/openclaw-mention-gating-watch-2026-03-25","https://docs.openclaw.ai/channels/group-messages",[2212,1404,1431,1433,1500],{"title":2850,"description":2851,"path":2852,"category":2612,"date":1384,"updatedAt":1384,"sourceType":1173,"source":2853,"tags":2854},"OpenClaw 的消息入口语义正在变清楚","官方最近围绕 Messages、WebChat 和 Channel Routing 的文档更新，正在把消息入口、上下文桶、历史展示和投递节奏拆成更明确的几层。","/news/openclaw-message-surface-watch-2026-03-22","https://docs.openclaw.ai/messages",[1563,1320,1387,1567,1198],{"title":2856,"description":2857,"path":2858,"category":2612,"date":1305,"updatedAt":1305,"sourceType":1173,"source":2681,"tags":2859},"OpenClaw 模型观察：models status 正在从状态展示继续长成探活入口","基于 2026 年 3 月 24 日可见的官方 CLI 文档，最近模型层最值得关注的变化之一是 models status 已经不只负责展示主模型和 fallback，而是开始承担 auth profile 探测。","/news/openclaw-model-probe-watch-2026-03-24",[1313,2254,1377,1379,1933],{"title":2861,"description":2862,"path":2863,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2864,"tags":2865},"OpenClaw 节点观察：headless node、普通设备节点与 Gateway 的宿主边界正在被官方写清","基于 2026 年 3 月 25 日可见的官方 Nodes、Architecture 与 Pairing 文档，最近节点层最值得关注的变化之一是能力宿主边界正在被主动拆清。","/news/openclaw-node-host-boundary-watch-2026-03-25","https://docs.openclaw.ai/nodes",[1358,1543,1196,1544,1545],{"title":2867,"description":2868,"path":2869,"category":2406,"date":1262,"updatedAt":1262,"sourceType":1173,"source":2870,"tags":2871},"OpenClaw 接入观察：从 2026.1.29 的迁移信号到现在的 Onboarding Wizard，官方已经把“第一次跑通”做成更完整链路","基于 2026 年 3 月 21 日可见的官方 Onboarding、Install 与 Releases 页面，整理 OpenClaw 从命名迁移、路径自动迁移到本地/远程 wizard 分流这条接入链路最近最值得注意的变化。","/news/openclaw-onboarding-migration-watch-2026-03-21","https://docs.openclaw.ai/start/wizard",[1250,2391,1669,2392,1974],{"title":2873,"description":2874,"path":2875,"category":2612,"date":1816,"updatedAt":1816,"sourceType":1173,"source":2700,"tags":2876},"OpenClaw 的远程 operator 正在从“谁都能开网页”转向浏览器级交接管理","随着 Dashboard、Control UI 和 device pairing 文档持续补强，官方越来越清楚地把浏览器 profile、设备 pairing 和控制面交接写成同一条管理面问题。","/news/openclaw-operator-browser-watch-2026-03-26",[1986,1486,1465,1544,1264],{"title":2878,"description":2879,"path":2880,"category":2612,"date":1411,"updatedAt":1411,"sourceType":1173,"source":2881,"tags":2882},"OpenClaw 正在把 Dashboard、WebChat 和 WebSocket 收成一套 operator surface","官方最近围绕 Dashboard、WebChat 和 Gateway Protocol 的文档更新，越来越清楚地把这些入口解释成同一套 operator surface 的不同层，而不是彼此割裂的功能页。","/news/openclaw-operator-surface-convergence-watch-2026-03-29","https://docs.openclaw.ai/gateway/protocol",[1251,1320,1824,1986,1359],{"title":2884,"description":2885,"path":2886,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2723,"tags":2887},"OpenClaw 的 pairing CLI 正在从单条 approve 命令长成正式入口治理面","官方最近把 pairing CLI 的 list、clear、--account 和 --notify 等行为写得更完整了，也让聊天入口审批越来越像一套正式的运营控制面。","/news/openclaw-pairing-cli-scope-watch-2026-03-25",[1544,2092,1198,2093,1218],{"title":2889,"description":2890,"path":2891,"category":2406,"date":1262,"updatedAt":1262,"sourceType":1173,"source":2892,"tags":2893},"OpenClaw 官方插件生态观察：社区插件、内置 Provider 插件与 Hook Pack 正在形成更完整扩展层","基于 2026 年 3 月 21 日可见的官方插件与 hooks 文档，整理 OpenClaw 插件生态最近最值得关注的三个变化：社区插件目录、package pack、多层 hooks 组织方式。","/news/openclaw-plugin-ecosystem-watch-2026-03-21","https://docs.openclaw.ai/plugins",[1297,1457,1299,1456,1458],{"title":2895,"description":2896,"path":2897,"category":2612,"date":1305,"updatedAt":1305,"sourceType":1173,"source":2898,"tags":2899},"OpenClaw 插件观察：安装 spec 和 update tracking 正在决定插件后续会沿哪条轨道走","基于 2026 年 3 月 24 日可见的官方 plugins CLI 文档，最近插件层最值得关注的变化之一是 install spec、--pin 与 plugins.installs 正在被官方主动连成一条生命周期链。","/news/openclaw-plugin-install-tracking-watch-2026-03-24","https://docs.openclaw.ai/cli/plugins",[1297,1439,420,2266,1973],{"title":2901,"description":2902,"path":2903,"category":2612,"date":1305,"updatedAt":1305,"sourceType":1173,"source":2904,"tags":2905},"OpenClaw 工作流观察：OpenProse 与 Lobster 的上下层分工正在变清楚","基于 2026 年 3 月 24 日可见的官方 Lobster 文档，最近最值得关注的信号是 OpenProse 与 Lobster 的边界正在被官方主动写清，多智能体准备和确定性执行不再混成一层。","/news/openclaw-prose-lobster-watch-2026-03-24","https://docs.openclaw.ai/tools/lobster",[1658,1659,1245,1510,1298],{"title":2907,"description":2908,"path":2909,"category":2612,"date":1411,"updatedAt":1411,"sourceType":1173,"source":2910,"tags":2911},"OpenClaw 正在把 provider、模型和远程执行分成不同治理层","官方最近围绕 Models、Model Failover 和 node 的文档更新，正在把 provider auth、模型 allowlist、多模态能力和远程 node 执行拆成更清楚的治理层。","/news/openclaw-provider-capability-governance-watch-2026-03-29","https://docs.openclaw.ai/concepts/models",[1377,1313,1358,1379,1675],{"title":2913,"description":2914,"path":2915,"category":2612,"date":1411,"updatedAt":1411,"sourceType":1173,"source":2916,"tags":2917},"OpenClaw 的 provider 故障恢复正在变成一条更清楚的梯子","官方最近围绕 Model Failover、Gateway Troubleshooting、LiteLLM 和 Cloudflare AI Gateway 的文档更新，正在把模型故障从“直接换模型”收敛成更清楚的几层：能力条件、profile 轮转、统一网关和跨模型 fallback。","/news/openclaw-provider-recovery-ladder-watch-2026-03-29","https://docs.openclaw.ai/concepts/model-failover",[1377,2057,1313,1196,1218],{"title":2919,"description":2920,"path":2921,"category":2406,"date":1262,"updatedAt":1262,"sourceType":1173,"source":2600,"tags":2922},"OpenClaw 发布观察：2026.3.13 恢复型 Release 暴露出版本跟踪里最容易忽略的三层差异","基于 2026 年 3 月 21 日可见的 GitHub Releases 页面，整理 OpenClaw 2026.3.13 恢复型 Release 的关键信号，以及中文站在跟踪版本时最该注意的 npm 版本、Git tag 和 GitHub Release 名称差异。","/news/openclaw-release-watch-2026-03-21",[1971,1972,1974,1973],{"title":2924,"description":2925,"path":2926,"category":2612,"date":1384,"updatedAt":1384,"sourceType":1173,"source":2626,"tags":2927},"OpenClaw 的远程管理员面边界越来越清楚","官方最近围绕 Dashboard、Pairing、Gateway-owned pairing 与 nodes 的文档更新，正在把远程协作、浏览器入口和设备接入的边界拆得更清楚。","/news/openclaw-remote-admin-watch-2026-03-22",[1251,1544,1358,1264,1877],{"title":2929,"description":2930,"path":2931,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2932,"tags":2933},"OpenClaw 的 routing precedence 正在成为更明确的排障坐标系","官方最近围绕 Channel Routing 的写法，正在把 peer、thread inheritance、guild、team、account 和 channel 等命中层级固定下来，让路由排障越来越像查规则，而不是猜模型。","/news/openclaw-routing-precedence-watch-2026-03-25","https://docs.openclaw.ai/channels/channel-routing",[1387,1386,2934,1198,1388],"threads",{"title":2936,"description":2937,"path":2938,"category":2612,"date":1364,"updatedAt":1364,"sourceType":1173,"source":2939,"tags":2940},"OpenClaw 把 SearXNG 推进 bundled web_search provider，搜索层开始更适合自托管","官方近期上线的 SearXNG Search 文档，说明 OpenClaw 的 web_search 已经不只适合外部 API，也开始正式支持自托管聚合搜索。","/news/openclaw-searxng-search-watch-2026-04-30","https://docs.openclaw.ai/tools/searxng-search",[1716,1605,1717,1290,1199],{"title":2942,"description":2943,"path":2944,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2945,"tags":2946},"OpenClaw Secret 观察：active snapshot 正在把密钥轮换从“即时取值”收成“原子切换”","基于 2026 年 3 月 25 日可见的官方 Secrets Management 文档，最近 secrets 层最值得关注的变化之一是 active snapshot 与 last-known-good 的边界越来越清楚。","/news/openclaw-secret-snapshot-watch-2026-03-25","https://docs.openclaw.ai/gateway/secrets",[2293,2947,2948,2292,1218],"snapshot","rotation",{"title":2950,"description":2951,"path":2952,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2812,"tags":2953},"OpenClaw 正在把 secure DM mode 写成共享入口的默认安全心智","官方最近围绕 Session、Security 和 CLI Security 的更新，正在把 secure DM mode 从一个可选技巧，推成多人 DM 入口的基础隔离建议。","/news/openclaw-secure-dm-mode-watch-2026-03-25",[1405,1219,2163,1544,2011],{"title":2955,"description":2956,"path":2957,"category":2612,"date":1305,"updatedAt":1305,"sourceType":1173,"source":2958,"tags":2959},"OpenClaw 安全观察：security audit 已经从提醒工具继续长成加固入口","基于 2026 年 3 月 24 日可见的官方安全文档，最近最值得关注的信号是 openclaw security audit 不再只是列问题，而是在形成 audit、deep、fix 三段式加固路径。","/news/openclaw-security-audit-fix-watch-2026-03-24","https://docs.openclaw.ai/gateway/security",[1219,1996,1998,1997,1218],{"title":2961,"description":2962,"path":2963,"category":2964,"date":1192,"updatedAt":1192,"sourceType":1456,"source":2965,"tags":2966},"OpenClaw 安全与合规话题升温：中文团队更在意可审计与本地数据边界","基于 2026 年 3 月 16 日安全方向临时稿，整理 OpenClaw 在中文环境下最受关注的安全议题，包括本地运行、合规要求、可审计性与金融等高敏行业采用。","/news/openclaw-security-compliance-watch-2026-03-16","安全观察","content/tmp/2026-03-16/openclaw-security-audit-milestone.md",[1219,2967,1576,1217],"compliance",{"title":2969,"description":2970,"path":2971,"category":2612,"date":1384,"updatedAt":1384,"sourceType":1173,"source":2945,"tags":2972},"OpenClaw 的安全运维边界继续细化","官方最近围绕 Secrets、approvals forwarding、trusted proxy 和 Control UI 降级开关的文档，正在把安全问题从抽象原则推向更可执行的运维边界。","/news/openclaw-security-ops-watch-2026-03-22",[1219,2292,1510,2973,1218],"proxy",{"title":2975,"description":2976,"path":2977,"category":2612,"date":2303,"updatedAt":2303,"sourceType":1173,"source":2978,"tags":2979},"OpenClaw 正在把 session transcript 从 JSONL 文件写成结构化会话事实层","官方最近新增的 Session Management Deep Dive 文档，把 session header、message tree、compaction entry 和 branch summary 这几层边界写得更清楚了。","/news/openclaw-session-jsonl-deep-dive-watch-2026-04-01","https://docs.openclaw.ai/reference/session-management-compaction",[1405,2306,1773,2305,1196],{"title":2981,"description":2982,"path":2983,"category":2612,"date":2303,"updatedAt":2303,"sourceType":1173,"source":2984,"tags":2985},"OpenClaw 的 sessions CLI 正在从会话列表命令长成 store 巡检入口","官方最近把 sessions CLI 的 scope、all-agents、active 和显式 store 路径写得更完整了，也让它更适合作为长期运维里的 session store 巡检面。","/news/openclaw-sessions-cli-watch-2026-04-01","https://docs.openclaw.ai/cli/sessions",[1345,1369,2312,1996,1218],{"title":2987,"description":2988,"path":2989,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":2990,"tags":2991},"OpenClaw 正在把 shared inbox 明确限定为协作硬化，而不是多租户承诺","官方最新 security audit 文档正在更明确地区分协作型 shared inbox 与互不信任多租户环境，并把 secure DM、sandbox 和 workspace-scoped access 组合成更完整的加固建议。","/news/openclaw-shared-inbox-trust-model-watch-2026-03-25","https://docs.openclaw.ai/cli/security",[1219,2011,2012,2992,1196],"sandbox",{"title":2994,"description":2995,"path":2996,"category":2406,"date":1262,"updatedAt":1262,"sourceType":1173,"source":2802,"tags":2997},"OpenClaw 官方 Showcase 更新：Telegram PR 反馈、酒窖 Skill 与 Tesco 自动购物成为新样板","基于 2026 年 3 月 21 日可见的官方 Showcase 页面，整理最近最值得中文站关注的三个社区案例，观察 OpenClaw 在评审、个人数据库和购物自动化上的真实落地方式。","/news/openclaw-showcase-watch-2026-03-21",[2804,1456,1431,1211,1246],{"title":2999,"description":3000,"path":3001,"category":2612,"date":1411,"updatedAt":1411,"sourceType":1173,"source":2990,"tags":3002},"OpenClaw 正在把团队入口治理拆成更细的几层","官方最近围绕 security audit、session、broadcast groups 和 channel routing 的文档更新，正在把 shared-user ingress、identityLinks、broadcast precedence 和 shared inbox 硬化拆成更清楚的治理面。","/news/openclaw-team-ingress-governance-watch-2026-03-29",[2011,2164,1403,1387,1219],{"title":3004,"description":3005,"path":3006,"category":2612,"date":2303,"updatedAt":2303,"sourceType":1173,"source":3007,"tags":3008},"OpenClaw 正在把 transcript hygiene 从隐藏兼容层写成正式参考边界","官方最近单独写出 Transcript Hygiene 文档后，tool call 修补、图片清理和 provider fixups 不再只是内部细节，而成了更清楚的运行前兼容层。","/news/openclaw-transcript-hygiene-watch-2026-04-01","https://docs.openclaw.ai/zh-CN/reference/transcript-hygiene",[2305,1377,2331,2332,3009],"compatibility",{"title":3011,"description":3012,"path":3013,"category":2612,"date":1305,"updatedAt":1305,"sourceType":1173,"source":2657,"tags":3014},"OpenClaw 远程入口观察：trusted-proxy 正在被官方明确定义为高收益但高责任模式","基于 2026 年 3 月 24 日可见的官方 trusted-proxy auth 文档，最近最值得关注的不是怎么把页面转发出来，而是 OpenClaw 正在主动强调 trusted-proxy 的安全责任转移。","/news/openclaw-trusted-proxy-risk-watch-2026-03-24",[2031,1219,1264,1196,1379],{"title":3016,"description":3017,"path":3018,"category":2612,"date":1816,"updatedAt":1816,"sourceType":1173,"source":2777,"tags":3019},"OpenClaw 的 UI 和 API 排障正在越来越像按层定位，而不是猜谁错了","官方最新 Session、WebChat 和 API 文档共同强化了一条思路：状态冲突时先回到 Gateway 事实层，再区分 UI 投影视图和 API 结构化返回。","/news/openclaw-ui-api-debug-watch-2026-03-26",[1196,1320,1818,2148,1405],{"title":3021,"description":3022,"path":3023,"category":2612,"date":1305,"updatedAt":1305,"sourceType":1173,"source":3024,"tags":3025},"OpenClaw 维护观察：卸载边界正在从“删包”变成“服务、状态、profile 与远程主机”的完整收口","基于 2026 年 3 月 24 日可见的官方 Updating 与 uninstall 文档，最近最值得关注的变化之一是 OpenClaw 的卸载和移除边界正在被官方主动写清，不再只是删除 CLI。","/news/openclaw-uninstall-boundaries-watch-2026-03-24","https://docs.openclaw.ai/cli/uninstall",[2372,1974,1652,1196,2779],{"title":3027,"description":3028,"path":3029,"category":2612,"date":1305,"updatedAt":1305,"sourceType":1173,"source":3030,"tags":3031},"OpenClaw 更新观察：stable、beta、dev 正在从版本标签变成正式 rollout 体系","基于 2026 年 3 月 24 日可见的官方 update CLI 与 Updating 文档，最近最值得关注的变化之一是更新通道和 auto-updater 行为已经被官方写成一套明确的 rollout 逻辑。","/news/openclaw-update-channels-watch-2026-03-24","https://docs.openclaw.ai/cli/update",[2043,2044,2045,2046,2047],{"title":3033,"description":3034,"path":3035,"category":2406,"date":1262,"updatedAt":1262,"sourceType":1173,"source":2802,"tags":3036},"OpenClaw 官方 Showcase 语音观察：Phone Bridge、Telegram Voice Notes 与多语言转录正在把语音入口做实","基于 2026 年 3 月 21 日可见的官方 Showcase 页面，整理最近最值得中文站关注的语音与电话类案例，观察 OpenClaw 在电话桥接、TTS 回传和多语言转录上的真实方向。","/news/openclaw-voice-phone-showcase-watch-2026-03-21",[2804,1479,3037,3038,1493],"phone","tts",{"title":3040,"description":3041,"path":3042,"category":2612,"date":1401,"updatedAt":1401,"sourceType":1173,"source":3043,"tags":3044},"OpenClaw 语音观察：全局 wake words 与设备本地 toggle 的分层正在变清楚","基于 2026 年 3 月 25 日可见的官方 Voice Wake 文档，最近语音层最值得关注的变化之一是 Gateway 级词表与设备本地开关的边界正在被官方主动强调。","/news/openclaw-voice-wake-boundary-watch-2026-03-25","https://docs.openclaw.ai/nodes/voice-wake",[1479,1804,1805,1358,1545],{"title":3046,"description":3047,"path":3048,"category":2406,"date":1262,"updatedAt":1262,"sourceType":1173,"source":2626,"tags":3049},"OpenClaw Web 入口观察：Dashboard、WebChat 与 Gateway WebSocket 正在收敛成一套更清晰的使用分工","基于 2026 年 3 月 21 日可见的官方 Dashboard、WebChat 与架构文档，整理最近最值得中文站关注的 Web 入口变化：Dashboard 的快速打开、WebChat 的 Gateway 直连，以及控制面和聊天面的职责分离。","/news/openclaw-web-surfaces-watch-2026-03-21",[1251,1320,1824,1465,2712],{"title":3051,"description":3052,"path":3053,"category":2612,"date":1816,"updatedAt":1816,"sourceType":1173,"source":3054,"tags":3055},"OpenClaw 正在把 WebChat、Dashboard 和 API 的入口职责写得更清楚","官方最近围绕 WebChat、Session 和 API 的写法，让 Dashboard 更像控制面、WebChat 更像会话 UI、API 更像结构化集成面，入口分工正在变得更稳定。","/news/openclaw-webchat-control-surface-watch-2026-03-26","https://docs.openclaw.ai/web/webchat",[1320,1251,1818,1196,1516],{"title":3057,"description":3058,"path":3059,"category":2612,"date":1384,"updatedAt":1384,"sourceType":1173,"source":2904,"tags":3060},"OpenClaw 工作流治理能力继续成型","官方最近的 ClawHub、Lobster、OpenProse 与 Exec approvals 文档，正在把技能发现、确定性执行和审批恢复串成更完整的一条线。","/news/openclaw-workflow-governance-watch-2026-03-22",[1245,1659,1439,1510,1675],{"title":3062,"description":3063,"path":3064,"category":3065,"date":3066,"updatedAt":3066,"sourceType":1193,"source":3067,"tags":3068},"OpenClaw 中文站本周更新：扩展能力地图、案例展示重构与周更内容节奏启动","本周中文站完成扩展目录重排、案例展示页重构，并开始按“教程 + 更新 + 案例”三类节奏持续发布内容。","/news/openclawcn-weekly-update-2026-03-15","站点更新","2026-03-15","openclawcn.xyz",[3069,3070,1199,2804,3071],"site-update","content","weekly",{"title":3073,"description":3074,"path":3075,"category":3076,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":3077},"OpenClaw 隐私优先：数据保留在本地设备","OpenClaw 强调数据本地存储，用户数据保留在自有设备上，不上传到云端。","/news/privacy-first","产品理念",[1576,3078,1219,3079],"local-first","data",{"title":3081,"description":3082,"path":3083,"category":2522,"date":2407,"updatedAt":1254,"sourceType":2114,"source":2523,"tags":3084},"OpenClaw 项目持续活跃：主仓库星标突破 287k","OpenClaw 开源项目持续快速发展，主仓库星标数突破 287,000，ClawHub 技能目录已收录 349 个开源项目。","/news/project-update-march-2026",[2114,2525,1456,2480],{"title":3086,"description":3087,"path":3088,"category":2591,"date":2566,"updatedAt":1506,"sourceType":1173,"source":2408,"tags":3089},"OpenClaw 2026 年第一季度回顾","回顾 OpenClaw 在 2026 年第一季度的重要更新、社区成长和产品里程碑。","/news/q1-2026-review",[3090,3091,3092,2526],"quarterly","review","2026",{"title":3094,"description":3095,"path":3096,"category":2414,"date":1254,"updatedAt":1288,"sourceType":1173,"source":2408,"tags":3097},"OpenClaw 安全架构深度解析","深入了解 OpenClaw 的安全设计理念、数据保护机制和企业级安全特性。","/news/security-architecture",[1219,1576,1217,1209],{"title":3099,"description":3100,"path":3101,"category":3102,"date":1254,"updatedAt":1254,"sourceType":1456,"source":3103,"tags":3104},"OpenClaw 安全最佳实践：保护你的 AI 助手免受风险","随着 OpenClaw 的普及，安全问题日益受到关注。本文整理了保护本地 AI 助手的关键安全措施和最佳实践。","/news/security-best-practices","安全公告","安全社区",[1219,1576,1956,1307],{"title":3106,"description":3107,"path":3108,"category":2485,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":3109},"OpenClaw Signal 隐私通讯集成","了解如何将 OpenClaw 连接到 Signal，实现隐私通讯。","/news/signal-privacy",[1734,1576,2487,1228],{"title":3111,"description":3112,"path":3113,"category":2464,"date":2433,"updatedAt":1506,"sourceType":2114,"source":2434,"tags":3114},"OpenClaw 技能市场突破 400 个技能","OpenClaw 技能市场迎来重要里程碑，社区贡献的技能数量突破 400 个，覆盖更多应用场景。","/news/skills-marketplace-400",[1211,2526,1456,3115],"marketplace",{"title":3117,"description":3118,"path":3119,"category":2485,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":3120},"OpenClaw Slack 工作区集成","了解如何将 OpenClaw 集成到 Slack 工作区，实现团队协作。","/news/slack-workspace",[1500,1343,2487,1228],{"title":3122,"description":3123,"path":3124,"category":2425,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":3125},"OpenClaw Tailscale 远程访问完全指南","了解如何使用 Tailscale 安全远程访问 OpenClaw，包括 Serve、Funnel 和身份认证。","/news/tailscale-integration",[1856,1264,3126,1219],"vpn",{"title":3128,"description":3129,"path":3130,"category":2485,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":3131},"OpenClaw Telegram Bot 配置指南","了解如何创建和配置 Telegram Bot 连接到 OpenClaw。","/news/telegram-bot",[1431,1780,2487,1228],{"title":3133,"description":3134,"path":3135,"category":3136,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":3137},"OpenClaw 与 VirusTotal 合作推出技能安全验证","OpenClaw 宣布与 VirusTotal 合作，为技能（Skills）提供安全验证服务，确保用户使用安全的 AI 技能。","/news/virustotal-integration","安全更新",[1219,3138,1211,3139],"virustotal","verification",{"title":3141,"description":3142,"path":3143,"category":2425,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":3144},"OpenClaw 语音与 Canvas 功能详解","深入了解 OpenClaw 的语音交互能力和实时 Canvas 可视化功能，如何在日常场景中发挥价值。","/news/voice-and-canvas",[1479,2456,2458,3145],"multimodal",{"title":3147,"description":3148,"path":3149,"category":2432,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":3150},"OpenClaw iOS 语音唤醒功能正式发布","OpenClaw iOS 应用现已支持语音唤醒功能，用户可以通过\"Hey Siri\"风格的唤醒词激活助手。","/news/voice-wakeup-ios",[1667,1479,3151,1971],"wakeup",{"title":3153,"description":3154,"path":3155,"category":2485,"date":2407,"updatedAt":1254,"sourceType":1173,"source":2408,"tags":3156},"OpenClaw WhatsApp 连接完全指南","详细了解如何将 WhatsApp 连接到 OpenClaw，包括配对、安全配置和常见问题解决。","/news/whatsapp-connection",[1432,2487,3157,1228],"baileys",{"count":3159,"items":3160},105,[3161,3168,3175,3182,3189,3196,3205,3211,3217,3223,3229,3236,3245,3253,3259,3269,3278,3285,3293,3302,3308,3316,3321,3326,3336,3342,3349,3354,3360,3367,3374,3381,3387,3392,3398,3404,3409,3414,3420,3426,3432,3438,3443,3449,3455,3462,3467,3474,3480,3486,3493,3498,3504,3509,3516,3525,3530,3537,3543,3548,3556,3563,3569,3574,3579,3585,3591,3599,3604,3610,3615,3621,3626,3632,3638,3643,3648,3654,3659,3666,3673,3679,3684,3690,3695,3702,3708,3715,3723,3729,3734,3739,3745,3750,3756,3761,3766,3772,3777,3785,3791,3796,3802,3807,3812],{"title":3162,"description":3163,"path":3164,"category":3165,"difficulty":3166,"updatedAt":1262,"sourceType":1173,"tags":3167},"管理员常用 CLI 值班手册","结合最新官方 CLI Reference、Gateway protocol 和 Dashboard 文档，总结长期运行环境里管理员最常用的 CLI 值班顺序：先看 status、再看 health、最后进 logs 与 gateway RPC。","/best-practices/admin-cli-playbook","运维实践","初级",[1369,1877,1218,1613,1196],{"title":3169,"description":3170,"path":3171,"category":3172,"difficulty":3166,"updatedAt":1254,"sourceType":1351,"tags":3173},"AI 提示词工程指南","优化与 AI 助手的交互效果，包括提示词技巧、角色设定和上下文管理。","/best-practices/ai-prompt-engineering","进阶指南",[3174,1772,1245,2427],"prompting",{"title":3176,"description":3177,"path":3178,"category":3179,"difficulty":3180,"updatedAt":1401,"sourceType":1173,"tags":3181},"API 集成面该怎么选：管理、实时还是嵌入式开发","结合最新官方 API、Gateway Web 与 SDK 文档，整理一套更稳的接口面选择方法，帮助团队区分什么时候走 HTTP API、什么时候走 Gateway WebSocket、什么时候用 SDK。","/best-practices/api-surface-selection","开发治理","中高级",[1818,1824,2226,2615,1209],{"title":3183,"description":3184,"path":3185,"category":3186,"difficulty":3187,"updatedAt":1384,"sourceType":1173,"tags":3188},"需要审批的自动化流程应该怎么设计","结合最新官方 Lobster、Exec approvals 和 OpenProse 文档，整理一套更稳的自动化设计顺序，让分析、审批和副作用执行分层出现。","/best-practices/approval-gated-automation","自动化治理","高级",[1246,1510,1659,1508,1675],{"title":3190,"description":3191,"path":3192,"category":3193,"difficulty":3194,"updatedAt":1254,"sourceType":1351,"tags":3195},"自动化工作流设计","使用 OpenClaw 构建自动化工作流，包括定时任务、事件触发和条件分支。","/best-practices/automation-workflows","自动化","中级",[1246,1516,1871,1552],{"title":3197,"description":3198,"path":3199,"category":3200,"difficulty":3180,"updatedAt":1254,"sourceType":1351,"tags":3201},"备份、恢复与灾难恢复","建立完善的备份策略，包括配置备份、数据备份和灾难恢复方案。","/best-practices/backup-recovery","运维管理",[3202,3203,3204,1218],"backup","recovery","disaster-recovery",{"title":3206,"description":3207,"path":3208,"category":3209,"difficulty":3187,"updatedAt":1401,"sourceType":1173,"tags":3210},"Broadcast Groups 上线前，先把多代理协作边界定清楚","结合最新官方 Broadcast Groups 与 Channel Routing 文档，整理多代理同群运行时的角色拆分、工具权限、响应节奏和群入口触发规则，避免把实验能力直接变成高噪声群机器人。","/best-practices/broadcast-group-governance","渠道治理",[1403,1404,1388,1675,1387],{"title":3212,"description":3213,"path":3214,"category":3215,"difficulty":3187,"updatedAt":1411,"sourceType":1173,"tags":3216},"浏览器管理员面要按信任链分层开放","结合最新官方 Pairing、Remote Access、Trusted Proxy Auth 和 Dashboard 文档，总结浏览器管理面更稳的开放顺序，避免把地址可达、身份认证、设备配对和 operator 权限混成一个问题。","/best-practices/browser-admin-trust-chain","协作运维",[1251,1465,2031,1544,1219],{"title":3218,"description":3219,"path":3220,"category":3172,"difficulty":3194,"updatedAt":1254,"sourceType":1351,"tags":3221},"浏览器自动化实战","利用 OpenClaw 的浏览器控制能力实现网页自动化，提升工作效率。","/best-practices/browser-automation",[1486,1246,3222,1516],"chromium",{"title":3224,"description":3225,"path":3226,"category":3227,"difficulty":3194,"updatedAt":1254,"sourceType":1351,"tags":3228},"Canvas 交互式界面开发","学习使用 A2UI 语法创建交互式 Canvas 界面，包括表单、图表和数据展示。","/best-practices/canvas-interactive","可视化开发",[2456,2457,2459,2458],{"title":3230,"description":3231,"path":3232,"category":3233,"difficulty":3187,"updatedAt":1384,"sourceType":1173,"tags":3234},"用 message CLI 和命令入口时，怎么避免发到错误会话","结合最新官方 Messages、Channel Routing 和 WebChat 文档，整理频道目标、session key、reply routing 和 operator 命令入口之间的关系，避免“命令发对了，结果进错桶”。","/best-practices/channel-command-session-targeting","消息治理",[1198,1387,3235,1405,1218],"message-cli",{"title":3237,"description":3238,"path":3239,"category":3240,"difficulty":3194,"updatedAt":1506,"sourceType":1351,"tags":3241},"OpenClaw 中文优化指南","针对中文用户的 OpenClaw 优化配置，包括模型选择、提示词优化和中文技能推荐。","/best-practices/chinese-optimization","最佳实践",[3242,3243,2467,3244],"chinese","optimization","tips",{"title":3246,"description":3247,"path":3248,"category":3249,"difficulty":3180,"updatedAt":1254,"sourceType":1351,"tags":3250},"CI/CD 集成与部署自动化","将 OpenClaw 集成到 CI/CD 流程，实现自动化构建、测试和部署。","/best-practices/ci-cd-integration","开发流程",[3251,2352,3252,1246],"ci-cd","testing",{"title":3254,"description":3255,"path":3256,"category":3257,"difficulty":3187,"updatedAt":1384,"sourceType":1173,"tags":3258},"正式配置、环境变量和一次性 override 应该怎么分层","结合最新官方 Configuration、Environment Variables、Logging 和 Debugging 文档，总结长期环境里怎么区分 on-disk config、env 注入、CLI 覆盖和 /debug 一次性改动，避免把临时修复留成永久配置。","/best-practices/config-layering-and-oneoff-overrides","配置治理",[1210,1751,2689,2148,1218],{"title":3260,"description":3261,"path":3262,"category":3263,"difficulty":3166,"updatedAt":1288,"sourceType":1456,"tags":3264},"内容创作助手","使用 OpenClaw 构建内容创作工作流，实现写作辅助、翻译、内容优化和多平台发布。","/best-practices/content-creation","内容创作",[3070,3265,3266,3267,3268],"writing","translation","publishing","productivity",{"title":3270,"description":3271,"path":3272,"category":3273,"difficulty":3194,"updatedAt":1411,"sourceType":1173,"tags":3274},"内容网络编辑手册：把文档、实践、新闻和专题真正织成一套知识体系","面向内容站运营，把文档、最佳实践、新闻动态、专题页和学习路径放到同一张编辑地图里，帮助持续产出更完整、更可回流的长文和系列内容。","/best-practices/content-network-editorial-playbook","内容运营",[3070,3275,3276,1282,3277,1956],"seo","editorial","news",{"title":3279,"description":3280,"path":3281,"category":3282,"difficulty":3187,"updatedAt":1384,"sourceType":1173,"tags":3283},"Control UI 安全降级开关应该怎样做 break-glass 管理","结合最新官方安全、Dashboard 和 Control UI 文档，总结 allowInsecureAuth、dangerouslyDisableDeviceAuth 这类降级开关在什么情况下可以临时使用，以及怎样快速回滚。","/best-practices/control-ui-break-glass-policy","安全治理",[1465,1219,3284,1379,1208],"break-glass",{"title":3286,"description":3287,"path":3288,"category":3289,"difficulty":3194,"updatedAt":1288,"sourceType":1173,"tags":3290},"自定义技能开发指南","从零开始开发 OpenClaw 自定义技能，包括项目结构、配置文件、处理逻辑、测试方法和发布流程。","/best-practices/custom-skill-development","开发",[1211,3291,3292,1228],"development","custom",{"title":3294,"description":3295,"path":3296,"category":3297,"difficulty":3194,"updatedAt":1288,"sourceType":1456,"tags":3298},"企业客服自动化","使用 OpenClaw 构建智能客服系统，实现自动问答、工单处理、多渠道接入和数据分析。","/best-practices/customer-service-advanced","企业应用",[3299,1217,1246,3300,3301],"customer-service","chatbot","support",{"title":3303,"description":3304,"path":3305,"category":3306,"difficulty":3194,"updatedAt":1254,"sourceType":1351,"tags":3307},"客户服务场景应用","使用 OpenClaw 构建智能客服系统，包括自动回复、工单管理和满意度调查。","/best-practices/customer-service","应用场景",[3299,1516,1246,3301],{"title":3309,"description":3310,"path":3311,"category":3312,"difficulty":3166,"updatedAt":1254,"sourceType":1351,"tags":3313},"界面定制与主题","定制 OpenClaw Control UI 的界面和主题。","/best-practices/customization-ui","定制开发",[2459,3314,3315,1465],"customization","themes",{"title":3317,"description":3318,"path":3319,"category":3165,"difficulty":3194,"updatedAt":1305,"sourceType":1173,"tags":3320},"Dashboard 认证引导与 token 漂移该怎么处理","结合最新官方 dashboard CLI 与 Web Dashboard 文档，整理一套更稳的 Dashboard 打开和鉴权恢复顺序，避免把本地、远程、SecretRef token 和浏览器缓存问题混成一个故障。","/best-practices/dashboard-auth-bootstrap-and-drift",[1251,1379,1485,2140,1486,1218],{"title":3322,"description":3323,"path":3324,"category":3165,"difficulty":3194,"updatedAt":1816,"sourceType":1173,"tags":3325},"Dashboard 出现授权漂移时，先走恢复梯子，不要上来就重装","结合最新官方 Dashboard 文档，整理一套更稳的 Dashboard 恢复梯子，把 localhost、远程、SecretRef token、trusted retry 和实例混淆分开排，避免把简单 drift 升级成大修。","/best-practices/dashboard-recovery-ladder",[1251,3203,1379,2628,1218],{"title":3327,"description":3328,"path":3329,"category":3330,"difficulty":3194,"updatedAt":1288,"sourceType":1456,"tags":3331},"数据分析助手","使用 OpenClaw 构建数据分析助手，实现报表生成、数据可视化、异常检测和智能洞察。","/best-practices/data-analysis-advanced","数据分析",[3332,2458,3333,3334,3335],"data-analysis","reporting","insights","analytics",{"title":3337,"description":3338,"path":3339,"category":3340,"difficulty":3194,"updatedAt":1254,"sourceType":1351,"tags":3341},"数据分析与可视化","使用 OpenClaw 进行数据分析，包括数据收集、处理和可视化展示。","/best-practices/data-analysis","数据处理",[3079,2420,2458,1516],{"title":3343,"description":3344,"path":3345,"category":3346,"difficulty":3194,"updatedAt":1288,"sourceType":1456,"tags":3347},"开发者工作流自动化","使用 OpenClaw 构建开发者工作流，实现代码审查、调试辅助、文档生成和 Git 操作自动化。","/best-practices/developer-workflow","开发效率",[2437,3348,585,1246,3268],"code-review",{"title":3350,"description":3351,"path":3352,"category":3282,"difficulty":3194,"updatedAt":1401,"sourceType":1173,"tags":3353},"设备配对不是一次性批准，应该有定期复核周期","结合最新官方 Devices CLI 与 Pairing 文档，整理浏览器、桌面设备、移动节点和远程 operator 环境里的设备复核节奏，避免已授权设备集合长期失控。","/best-practices/device-pairing-review-cycle",[1545,1544,3091,1890,2725],{"title":3355,"description":3356,"path":3357,"category":3358,"difficulty":3187,"updatedAt":1401,"sourceType":1173,"tags":3359},"diagnostics.enabled、flags 和 raw stream 该怎么分层","结合最新官方 Diagnostics Flags、Debugging 与 Raw Stream 文档，整理一套更稳的诊断开关分层方法，避免把定向诊断、全局日志和原始流抓包混成一层。","/best-practices/diagnostics-scope-control","排障实践",[2064,2157,2272,1613,2325],{"title":3361,"description":3362,"path":3363,"category":3364,"difficulty":3180,"updatedAt":1254,"sourceType":1351,"tags":3365},"Discord Bot 高级功能开发","深入学习 Discord Bot 的高级功能，包括 Slash 命令、Embed 消息和语音频道集成。","/best-practices/discord-bot-advanced","渠道实践",[1433,1780,1198,3366],"advanced",{"title":3368,"description":3369,"path":3370,"category":3371,"difficulty":3194,"updatedAt":1254,"sourceType":1351,"tags":3372},"Docker 部署与容器化运行","使用 Docker 部署 OpenClaw，包括镜像构建、docker-compose 配置和 Kubernetes 部署。","/best-practices/docker-deployment","部署运维",[2358,2352,3373,1218],"containers",{"title":3375,"description":3376,"path":3377,"category":3378,"difficulty":3187,"updatedAt":1254,"sourceType":1351,"tags":3379},"企业级安全配置","企业环境中的安全配置最佳实践，包括 SSO、审计和合规性。","/best-practices/enterprise-security","企业部署",[1217,1219,3380,2967],"sso",{"title":3382,"description":3383,"path":3384,"category":3385,"difficulty":3194,"updatedAt":1254,"sourceType":1456,"tags":3386},"如何高质量反馈 OpenClaw 问题","把自助排查、站内反馈和 GitHub Issues 用在正确阶段，减少无效沟通并提高问题处理效率。","/best-practices/feedback-loop","社区协作",[2116,2115,1456,2064],{"title":3388,"description":3389,"path":3390,"category":3364,"difficulty":3194,"updatedAt":1205,"sourceType":1173,"tags":3391},"飞书 Bot 接入与团队使用实战","结合官方 Feishu/Lark 文档，整理中文团队接入飞书 Bot 时最值得先确认的事项：长连接模式、群聊边界、额度优化和多人协作时的收口方式。","/best-practices/feishu-bot-development",[1522,1523,1780,1198,1217],{"title":3393,"description":3394,"path":3395,"category":3396,"difficulty":3194,"updatedAt":1816,"sourceType":1173,"tags":3397},"先分清入口职责，再选 Dashboard、WebChat 还是 API","结合最新官方 Dashboard、WebChat、Session 和 API 文档，整理一套更稳的入口选择矩阵，帮助团队在控制面、会话面和集成面之间少走弯路。","/best-practices/gateway-entry-surface-matrix","使用实践",[1196,1251,1320,1818,1300],{"title":3399,"description":3400,"path":3401,"category":3402,"difficulty":3194,"updatedAt":1262,"sourceType":1173,"tags":3403},"群组、私聊与长期记忆的边界怎么守","结合最新官方 Memory 与 Channel Routing 文档，总结 OpenClaw 在群组、私聊、线程和长期记忆之间更稳的边界做法，避免上下文串线和记忆误读。","/best-practices/group-memory-boundaries","协作实践",[1200,1345,1404,1576,1387],{"title":3405,"description":3406,"path":3407,"category":3209,"difficulty":3194,"updatedAt":1401,"sourceType":1173,"tags":3408},"群聊入口上线时，先把 mention 触发策略跑稳","结合最新官方 Groups、Group Messages 和 Messages 文档，整理群聊入口从 allowlist、requireMention 到 /activation 的上线顺序，避免把群机器人一接上就变成高噪声、高成本入口。","/best-practices/group-mention-rollout",[1404,2212,2047,1198,1218],{"title":3410,"description":3411,"path":3412,"category":3193,"difficulty":3194,"updatedAt":1262,"sourceType":1173,"tags":3413},"用 Heartbeat 和 Cron 做低噪音自动化","结合最新官方自动化文档，总结如何用 Heartbeat 承担周期感知、用 Cron 承担精确调度，避免把主会话做成噪音中心。","/best-practices/heartbeat-cron-composition",[1246,1870,1367,1871,1218],{"title":3415,"description":3416,"path":3417,"category":3418,"difficulty":3166,"updatedAt":1262,"sourceType":1173,"tags":3419},"Hooks、插件和 Skills 的启用顺序怎么排","结合最新官方 Hooks、Plugins、Skills 和 Onboarding 文档，总结第一次扩展 OpenClaw 时怎样安排 hooks、插件与 skills 的启用顺序，降低排障复杂度。","/best-practices/hooks-onboarding-sequence","扩展实践",[1299,1297,1211,1250,1458],{"title":3421,"description":3422,"path":3423,"category":3424,"difficulty":3194,"updatedAt":1288,"sourceType":1173,"tags":3425},"Hooks 实战指南","通过实际案例学习 OpenClaw Hooks 的使用，包括消息处理、自动化触发、内容过滤和外部集成。","/best-practices/hooks-practical-guide","实践",[1299,1246,1516,2615],{"title":3427,"description":3428,"path":3429,"category":3430,"difficulty":3187,"updatedAt":1411,"sourceType":1173,"tags":3431},"identityLinks 更适合当成“身份映射表”，而不是联系人备注","结合最新官方 Session、Configuration Reference 和 Security 文档，总结团队里怎样把 identityLinks 当成正式变更对象来维护，避免跨渠道身份映射越配越乱。","/best-practices/identity-links-change-control","会话治理",[2164,1405,1387,1675,1956],{"title":3433,"description":3434,"path":3435,"category":3436,"difficulty":3180,"updatedAt":1254,"sourceType":1351,"tags":3437},"API 集成与二次开发","使用 OpenClaw API 进行二次开发，包括 REST API、WebSocket 和扩展开发。","/best-practices/integration-development","开发指南",[1818,2615,1824,3291],{"title":3439,"description":3440,"path":3441,"category":3172,"difficulty":3194,"updatedAt":1254,"sourceType":1351,"tags":3442},"知识库管理","构建和管理 OpenClaw 知识库，包括知识导入、检索和更新。","/best-practices/knowledge-management",[2842,2248,1200,3070],{"title":3444,"description":3445,"path":3446,"category":3200,"difficulty":3194,"updatedAt":1254,"sourceType":1351,"tags":3447},"日志管理与分析","集中式日志管理、日志分析和日志可视化。","/best-practices/logging-advanced",[1613,3448,2420,1218],"observability",{"title":3450,"description":3451,"path":3452,"category":3453,"difficulty":3187,"updatedAt":1384,"sourceType":1173,"tags":3454},"后台维护任务应该怎么分 lane 和保留周期","结合最新官方 Cron、sessions cleanup、doctor 和 Session 文档，总结长期运行时怎样给 isolated cron、main session、session cleanup 和 run logs 设不同的维护节奏。","/best-practices/maintenance-lanes-and-retention","运维治理",[1974,1367,1345,1863,1218],{"title":3456,"description":3457,"path":3458,"category":3459,"difficulty":3187,"updatedAt":1411,"sourceType":1173,"tags":3460},"索引刷新、embedding cache 和 source of truth 更稳的维护方式","结合最新官方 Memory、memory CLI 和 Session 文档，总结团队里怎样区分 memory files、session transcripts 和检索索引三层对象，避免把“检索层”误当成事实层。","/best-practices/memory-index-refresh-and-trust-boundary","记忆治理",[1200,1606,1728,3461,1956],"source-of-truth",{"title":3463,"description":3464,"path":3465,"category":3172,"difficulty":3180,"updatedAt":1254,"sourceType":1351,"tags":3466},"记忆系统配置与使用","深入了解 OpenClaw 的记忆系统，包括短期记忆、长期记忆和上下文管理。","/best-practices/memory-management",[1200,1772,1345,1353],{"title":3468,"description":3469,"path":3470,"category":3471,"difficulty":3166,"updatedAt":1254,"sourceType":1351,"tags":3472},"移动端使用指南","在 iOS 和 Android 设备上使用 OpenClaw 的完整指南。","/best-practices/mobile-app-usage","入门指南",[1420,1667,1668,3473],"usage",{"title":3475,"description":3476,"path":3477,"category":3478,"difficulty":3194,"updatedAt":1262,"sourceType":1173,"tags":3479},"移动节点感知能力怎么逐步启用","结合最新官方 nodes、camera、voice wake 和 location 文档，总结 iOS/Android 节点在相机、语音、位置三类能力上怎样渐进启用，避免一开始权限过重。","/best-practices/mobile-node-sensors","设备实践",[1420,1358,1419,1582,1479,1583],{"title":3481,"description":3482,"path":3483,"category":3484,"difficulty":3187,"updatedAt":1262,"sourceType":1173,"tags":3485},"Model Health 与 Auth 监控怎么做","结合最新官方 Models CLI、Auth Monitoring 和 Model Failover 文档，总结长期运行时怎样监控 OAuth 过期、缺失凭据和 profile 轮转问题。","/best-practices/model-auth-monitoring","模型治理",[1313,1379,1933,1649,2057,1218],{"title":3487,"description":3488,"path":3489,"category":3200,"difficulty":3180,"updatedAt":1254,"sourceType":1351,"tags":3490},"监控与告警系统","建立完整的监控和告警系统，包括指标收集、告警规则和通知渠道。","/best-practices/monitoring-alerting",[1933,3491,3492,1218],"alerting","metrics",{"title":3494,"description":3495,"path":3496,"category":3209,"difficulty":3194,"updatedAt":1401,"sourceType":1173,"tags":3497},"多账号渠道的 pairing 和 allowFrom 需要分开治理","结合最新官方 Pairing 文档，整理多账号 Telegram、WhatsApp 等渠道下的 pending 审批、allowFrom 文件和账号 scope 的治理顺序，避免默认账号心智把多入口运营带偏。","/best-practices/multi-account-pairing-operations",[1544,2092,2093,1198,1218],{"title":3499,"description":3500,"path":3501,"category":3502,"difficulty":3194,"updatedAt":1254,"sourceType":1351,"tags":3503},"多代理路由配置指南","学习配置 OpenClaw 的多代理路由，实现按渠道、用户或内容类型分配不同代理。","/best-practices/multi-agent-routing","代理配置",[1387,1388,1198,1210],{"title":3505,"description":3506,"path":3507,"category":3478,"difficulty":3180,"updatedAt":1401,"sourceType":1173,"tags":3508},"团队里如何渐进启用 node 能力","结合最新官方 Nodes、Pairing、Camera、Location 与 Voice Wake 文档，整理一套更稳的 node 能力启用顺序，避免一开始就把相机、位置和语音一起打开。","/best-practices/node-capability-rollout",[1358,2047,1419,1479,1582,1583],{"title":3510,"description":3511,"path":3512,"category":3200,"difficulty":3194,"updatedAt":1254,"sourceType":1351,"tags":3513},"通知系统配置","配置 OpenClaw 的通知系统，包括邮件、短信、推送和 Webhook 通知。","/best-practices/notification-system",[3514,1396,3515,1218],"notifications","email",{"title":3517,"description":3518,"path":3519,"category":3520,"difficulty":3194,"updatedAt":3521,"sourceType":1173,"tags":3522},"OpenResponses API 接入与第三方集成","把 OpenClaw Gateway 当成 OpenAI 兼容的 API 后端使用，让第三方应用和工具链直接调用你的自托管 Agent 能力。","/best-practices/openresponses-api-integration","集成开发","2026-05-18",[1818,2615,3523,3524,1196],"openresponses","openai-compatible",{"title":3526,"description":3527,"path":3528,"category":3215,"difficulty":3187,"updatedAt":1384,"sourceType":1173,"tags":3529},"多人协作时怎么管理 Operator 浏览器入口","结合最新官方 Dashboard、pairing、remote access 和 devices 文档，总结团队在浏览器 Control UI、多 operator 接力和值班环境里最需要的使用纪律。","/best-practices/operator-browser-discipline",[1986,1251,1486,1544,1208],{"title":3531,"description":3532,"path":3533,"category":3534,"difficulty":3194,"updatedAt":1816,"sourceType":1173,"tags":3535},"多个 operator 轮流进 Dashboard 时，浏览器交接不要靠记忆","结合最新官方 Dashboard、Control UI 和设备 pairing 文档，整理团队里多个 operator 轮流接管浏览器控制面的交接顺序，避免把 gateway URL、token 来源和已配对浏览器状态混成口口相传的经验。","/best-practices/operator-browser-handoff","协作治理",[1986,1251,1486,1544,3536],"handoff",{"title":3538,"description":3539,"path":3540,"category":3541,"difficulty":3187,"updatedAt":1411,"sourceType":1173,"tags":3542},"operator 入口更稳的升级梯子：先看 UI，再下沉协议和 API","结合最新官方 Dashboard、WebChat、Gateway Protocol 和 API 文档，总结 operator 在排障和协作时怎样按层使用 Dashboard、WebChat、Gateway WebSocket 和 HTTP API，避免一上来就切到过深入口。","/best-practices/operator-surface-escalation-ladder","运维协作",[1986,1251,1320,1818,1516,1956],{"title":3544,"description":3545,"path":3546,"category":3282,"difficulty":3187,"updatedAt":1305,"sourceType":1173,"tags":3547},"团队里如何做 per-agent 执行白名单治理","结合最新官方 approvals CLI 与 Exec Approvals 文档，整理一套更稳的 per-agent allowlist 管理方法，避免一个 agent 的执行权限外溢到整个团队。","/best-practices/per-agent-allowlist-governance",[1510,1630,1508,1219,1675],{"title":3549,"description":3550,"path":3551,"category":3552,"difficulty":3180,"updatedAt":1254,"sourceType":1351,"tags":3553},"性能优化与监控","优化 OpenClaw 性能，包括缓存策略、资源管理和监控配置。","/best-practices/performance-tuning","运维优化",[2569,3554,3555,1933],"tuning","caching",{"title":3557,"description":3558,"path":3559,"category":3306,"difficulty":3194,"updatedAt":1506,"sourceType":1351,"tags":3560},"个人知识管理助手","使用 OpenClaw 构建个人知识管理系统，实现笔记整理、知识检索和智能问答。","/best-practices/personal-knowledge-assistant",[3561,3562,1272,3268],"knowledge-management","notes",{"title":3564,"description":3565,"path":3566,"category":3567,"difficulty":3187,"updatedAt":1262,"sourceType":1173,"tags":3568},"团队里如何管理插件包和 Hook Pack","结合最新官方插件与 hooks 文档，总结团队在使用 package pack、hook pack 和插件托管 hooks 时，怎样降低升级、冲突和安全成本。","/best-practices/plugin-bundle-governance","扩展治理",[1297,1299,1675,1208,1218],{"title":3570,"description":3571,"path":3572,"category":3567,"difficulty":3187,"updatedAt":1305,"sourceType":1173,"tags":3573},"插件更新轨道和卸载回收应该怎么安排","结合最新官方 plugins CLI 文档，整理一套更稳的插件生命周期治理方法，帮助团队管理 install spec、update track、卸载回收以及 memory slot 回退行为。","/best-practices/plugin-lifecycle-governance",[1297,1551,1973,2372,1675],{"title":3575,"description":3576,"path":3577,"category":3215,"difficulty":3187,"updatedAt":1411,"sourceType":1173,"tags":3578},"团队长期运行蓝图：把 OpenClaw 从可用做成可运营","把控制面、渠道、模型、记忆、自动化、安全和维护整合成一套长期运行蓝图，帮助团队把 OpenClaw 从“能跑”推进到“能稳定运营”。","/best-practices/production-operations-blueprint",[1218,1208,1219,1377,1246,1974],{"title":3580,"description":3581,"path":3582,"category":3583,"difficulty":3187,"updatedAt":1305,"sourceType":1173,"tags":3584},"从 Prose 准备到 Lobster 执行，交接线怎么画","结合最新官方 Lobster 文档，整理一套从多智能体准备到确定性执行的交接方法，避免 OpenProse 和 Lobster 混层使用。","/best-practices/prose-to-lobster-handoff","工作流实践",[1658,1659,1245,1510,1298],{"title":3586,"description":3587,"path":3588,"category":3589,"difficulty":3187,"updatedAt":1411,"sourceType":1173,"tags":3590},"团队里怎么分层放开 provider、模型和 node 能力","结合最新官方 Models、Model Failover 和 node 文档，总结团队环境里怎样把 provider auth、模型 allowlist、图片能力和远程 node 执行分成不同放开层级，避免一开始给太大权限面。","/best-practices/provider-and-node-capability-lanes","权限与治理",[1377,1313,1358,1510,1675,1956],{"title":3592,"description":3593,"path":3594,"category":3484,"difficulty":3187,"updatedAt":1262,"sourceType":1173,"tags":3595},"团队里如何给 Provider 加统一网关层","结合最新官方 providers、LiteLLM 和 Cloudflare AI Gateway 文档，总结长期运行时怎样把上游模型与统一网关分层，兼顾成本、回退和可观测性。","/best-practices/provider-gateway-layering",[1377,3596,3597,3598,1387,1218],"gateways","litellm","cloudflare",{"title":3600,"description":3601,"path":3602,"category":3484,"difficulty":3187,"updatedAt":1411,"sourceType":1173,"tags":3603},"Provider 故障时先按恢复阶梯排，不要直接乱切模型","结合最新官方 Model Failover、Gateway Troubleshooting、LiteLLM 和 Cloudflare AI Gateway 文档，总结模型调用异常时更稳的恢复顺序，避免把长上下文、认证轮转、网关鉴权和跨模型 fallback 混成一件事。","/best-practices/provider-recovery-ladder",[1377,2057,3203,1313,1218],{"title":3605,"description":3606,"path":3607,"category":3608,"difficulty":3166,"updatedAt":1254,"sourceType":1173,"tags":3609},"版本升级与内容运营节奏","如何持续跟踪 OpenClaw 的版本变化，并建立稳定的内容运营节奏。","/best-practices/publishing-rhythm","更新跟踪",[1971,1973,1245,1974],{"title":3611,"description":3612,"path":3613,"category":3193,"difficulty":3194,"updatedAt":1411,"sourceType":1173,"tags":3614},"用 quiet hours 和 manual wake 控制自动化节奏","结合最新官方 Heartbeat 与 Automation Troubleshooting 文档，总结如何让 heartbeat 在该安静时安静、在需要时再手动唤醒，避免把自动化做成全天噪音源。","/best-practices/quiet-hours-and-manual-wake",[1870,2219,1246,1218,1956],{"title":3616,"description":3617,"path":3618,"category":3165,"difficulty":3619,"updatedAt":1205,"sourceType":1173,"tags":3620},"把版本观察变成升级决策，而不是看见更新就立刻替换环境","结合最新 release 观察、配置变化和迁移信号，建立一套更稳的升级判断顺序：先看影响层，再看风险，再决定是否马上升级。","/best-practices/release-watch-to-upgrade-decision","基础",[1971,2392,2391,1218,1972],{"title":3622,"description":3623,"path":3624,"category":3453,"difficulty":3187,"updatedAt":1305,"sourceType":1173,"tags":3625},"远程值守时如何设计聊天审批路由","结合最新官方 Exec Approvals 与 Remote Operators 文档，整理一套更稳的远程审批路由设计，避免把远程值守便利性直接变成高权限扩散。","/best-practices/remote-approval-routing",[1510,1264,1431,1433,1986,1387],{"title":3627,"description":3628,"path":3629,"category":3306,"difficulty":3166,"updatedAt":1254,"sourceType":1351,"tags":3630},"远程工作场景应用","使用 OpenClaw 支持远程工作场景，包括分布式团队协作和远程办公。","/best-practices/remote-work",[3631,1526,3268,1208],"remote-work",{"title":3633,"description":3634,"path":3635,"category":3636,"difficulty":3187,"updatedAt":1384,"sourceType":1173,"tags":3637},"从巡检到修复的排障阶梯应该怎么走","结合最新官方 Doctor、Diagnostics Flags、Debugging 和 Troubleshooting 文档，总结一条更稳的 repair ladder，让 status、doctor、flags、repair 和 cleanup 各司其职。","/best-practices/repair-ladder-playbook","排障治理",[1896,2064,2325,1897,1218],{"title":3639,"description":3640,"path":3641,"category":3636,"difficulty":3194,"updatedAt":1262,"sourceType":1173,"tags":3642},"Raw Stream 调试的安全做法","结合最新官方 Debugging 文档，总结在 OpenClaw 里抓 raw stream、provider chunk 和诊断日志时，怎样控制范围、保留最小样本并避免泄露 prompt、密钥和用户数据。","/best-practices/safe-debug-capture",[2148,2156,1576,1219,2325],{"title":3644,"description":3645,"path":3646,"category":3282,"difficulty":3187,"updatedAt":1401,"sourceType":1173,"tags":3647},"Secret rotation 和 active snapshot 应该怎么配合","结合最新官方 Secrets Management 文档，整理一套更稳的密钥轮换方法，帮助团队理解 SecretRef eager resolve、active snapshot 和 reload 失败时的 last-known-good 边界。","/best-practices/secret-rotation-with-active-snapshot",[2293,2292,2948,2947,1218],{"title":3649,"description":3650,"path":3651,"category":3282,"difficulty":3194,"updatedAt":3521,"sourceType":1173,"tags":3652},"Secrets 管理与生产环境密钥安全","从官方 Secrets Management 文档出发，整理一套适合生产环境的密钥管理方法，涵盖 SecretRef、运行时快照、provider 配置和常见排障思路。","/best-practices/secrets-management-production",[2292,1219,3653,2293,1218],"production",{"title":3655,"description":3656,"path":3657,"category":3282,"difficulty":3194,"updatedAt":1401,"sourceType":1173,"tags":3658},"共享 DM 入口上线前的 secure DM 检查清单","结合最新官方 Session、Security 和 CLI Security 文档，整理共享 DM、配对审批、多账号入口和跨渠道身份映射的上线前核查清单，避免把单人默认配置直接带进多人环境。","/best-practices/secure-dm-rollout-checklist",[1219,2163,1544,1405,2047],{"title":3660,"description":3661,"path":3662,"category":3663,"difficulty":3187,"updatedAt":1254,"sourceType":1351,"tags":3664},"OpenClaw 安全加固指南","生产环境中 OpenClaw 的安全加固最佳实践，包括认证、授权和网络配置。","/best-practices/security-hardening","安全配置",[1219,1997,1379,3665],"networking",{"title":3667,"description":3668,"path":3669,"category":3670,"difficulty":3187,"updatedAt":1384,"sourceType":1173,"tags":3671},"长期使用时 session reset 策略怎么定","结合最新官方会话管理文档，整理 daily reset、idle reset、resetByType、resetByChannel 和 resetTriggers 的组合思路，让长期使用既不失连续性，也不把上下文拖到失控。","/best-practices/session-reset-policy","长期治理",[1405,3672,2695,1208,1218],"reset",{"title":3674,"description":3675,"path":3676,"category":3677,"difficulty":3187,"updatedAt":1411,"sourceType":1173,"tags":3678},"共享群入口更稳的放开顺序：allowlist、mention、activation 和 broadcast","结合最新官方 Groups、Group Messages 和 Broadcast Groups 文档，总结团队在群聊里怎样从最窄入口逐步放开到 topic、多 agent 和 always activation，避免一开始就把共享群入口做成高噪音面。","/best-practices/shared-group-entry-rollout","群入口治理",[1404,2284,2791,1403,1675,1956],{"title":3680,"description":3681,"path":3682,"category":3282,"difficulty":3187,"updatedAt":1401,"sourceType":1173,"tags":3683},"shared inbox 能共用入口，但不要共用不该共用的边界","结合最新官方 Security 与 Groups 文档，整理 shared inbox 场景下 operator、工具、宿主文件系统和私有身份的分层建议，避免把协作入口误用成弱隔离的多租户平台。","/best-practices/shared-inbox-operator-separation",[2011,1219,2992,1986,1675],{"title":3685,"description":3686,"path":3687,"category":3688,"difficulty":3187,"updatedAt":1254,"sourceType":1351,"tags":3689},"技能开发进阶：Hook 与事件处理","学习 OpenClaw 技能系统的高级用法，包括 Hook、事件监听和自定义工作流。","/best-practices/skill-development-advanced","技能开发",[1211,1299,1552,3366],{"title":3691,"description":3692,"path":3693,"category":3172,"difficulty":3180,"updatedAt":1254,"sourceType":1351,"tags":3694},"技能开发指南","深入了解 OpenClaw 技能系统，学习如何开发和自定义专属技能。","/best-practices/skills-development",[1211,3291,3314,1199],{"title":3696,"description":3697,"path":3698,"category":3306,"difficulty":3194,"updatedAt":1506,"sourceType":1351,"tags":3699},"OpenClaw 家庭自动化应用","使用 OpenClaw 构建智能家居控制中心，实现语音控制、自动化场景和设备管理。","/best-practices/smart-home-automation",[3700,1246,2805,3701],"smart-home","iot",{"title":3703,"description":3704,"path":3705,"category":3502,"difficulty":3619,"updatedAt":3521,"sourceType":1173,"tags":3706},"SOUL.md 人格与身份定制实战指南","从官方 SOUL.md 机制出发，教你怎么给 Agent 写一个真正有“性格”而不是“说明书”的身份文件，避免常见的人格配置误区。","/best-practices/soul-personality-guide",[1353,3707,1197,1771,3314],"personality",{"title":3709,"description":3710,"path":3711,"category":3712,"difficulty":3194,"updatedAt":1262,"sourceType":1173,"tags":3713},"升级窗口怎么安排更稳","结合最新官方 Install、Updating、Migration 和 Release 文档，总结长期运行时怎样安排 OpenClaw 的升级窗口、验证顺序和回滚边界，避免把升级变成线上事故。","/best-practices/staged-upgrade-windows","维护实践",[2392,2391,1971,1974,3714],"rollback",{"title":3716,"description":3717,"path":3718,"category":3719,"difficulty":3187,"updatedAt":3521,"sourceType":1173,"tags":3720},"Sub-agents 子代理工作流与任务拆分","学习如何把复杂任务拆给多个子代理处理，让 OpenClaw 的主 Agent 变成任务调度器而不是所有事都自己干。","/best-practices/sub-agents-workflow","高级用法",[3721,1245,1298,3722,1366],"sub-agents","delegation",{"title":3724,"description":3725,"path":3726,"category":3727,"difficulty":3194,"updatedAt":1254,"sourceType":1351,"tags":3728},"团队协作与工作区管理","配置团队工作区，实现多用户协作、权限管理和团队知识共享。","/best-practices/team-collaboration","团队协作",[1208,1343,1583,1526],{"title":3730,"description":3731,"path":3732,"category":3534,"difficulty":3187,"updatedAt":1262,"sourceType":1173,"tags":3733},"团队里如何管理 Gateway、Operator 与浏览器控制面","结合最新官方 remote、Control UI、pairing 和 security 文档，总结团队环境里怎样定义主 Gateway、operator 设备和浏览器控制面，降低多人协作时的运维混乱。","/best-practices/team-gateway-operator-playbook",[1196,1986,1465,1544,1208,1218],{"title":3735,"description":3736,"path":3737,"category":3364,"difficulty":3180,"updatedAt":1254,"sourceType":1351,"tags":3738},"Telegram Bot 开发进阶指南","深入学习 Telegram Bot 的高级功能，包括自定义键盘、Inline 模式和群组管理。","/best-practices/telegram-bot-development",[1431,1780,1198,3366],{"title":3740,"description":3741,"path":3742,"category":3249,"difficulty":3180,"updatedAt":1254,"sourceType":1351,"tags":3743},"测试策略与质量保障","建立 OpenClaw 的测试策略，包括单元测试、集成测试和端到端测试。","/best-practices/testing-strategies",[3252,3744,2615,1245],"quality",{"title":3746,"description":3747,"path":3748,"category":3453,"difficulty":3194,"updatedAt":3521,"sourceType":1173,"tags":3749},"Transcript 会话记录治理与归档策略","结合官方 Transcript Hygiene 文档，整理一套会话记录的治理方法，帮助长期运行的 OpenClaw 实例控制存储增长、保障隐私合规。","/best-practices/transcript-hygiene-governance",[2305,1345,2331,1576,2967,1218],{"title":3751,"description":3752,"path":3753,"category":3754,"difficulty":3187,"updatedAt":1254,"sourceType":1351,"tags":3755},"高级故障排除与诊断","深入排查 OpenClaw 复杂问题，包括性能问题、渠道故障和系统崩溃。","/best-practices/troubleshooting-advanced","故障排除",[2325,2064,2569,1198],{"title":3757,"description":3758,"path":3759,"category":3282,"difficulty":3187,"updatedAt":1305,"sourceType":1173,"tags":3760},"Trusted Proxy 上线前应该过哪些检查","结合最新官方 trusted-proxy auth 与 security audit 文档，整理一套上线前检查顺序，避免把只是做 TLS 的反向代理误当成可托付身份的安全代理。","/best-practices/trusted-proxy-rollout-checklist",[2031,2032,1379,1219,2047],{"title":3762,"description":3763,"path":3764,"category":3165,"difficulty":3194,"updatedAt":1816,"sourceType":1173,"tags":3765},"UI 和 API 看到的状态对不上时，先查哪一层","结合最新官方 Session、WebChat 和 API 文档，整理一套更稳的排障顺序，帮助团队区分 Gateway 事实层、UI 投影视图和结构化接口之间的差异。","/best-practices/ui-vs-api-state-debugging",[1196,1320,1818,2148,1405],{"title":3767,"description":3768,"path":3769,"category":3453,"difficulty":3187,"updatedAt":1305,"sourceType":1173,"tags":3770},"团队里如何给 stable、beta、dev 分层","结合最新官方 update CLI 与 Updating 文档，整理一套更稳的更新分层策略，帮助团队把 stable、beta、dev 变成有职责分工的 rollout 体系。","/best-practices/update-channel-staging",[2043,2044,2045,2046,3771,2047],"staging",{"title":3773,"description":3774,"path":3775,"category":3200,"difficulty":3194,"updatedAt":1254,"sourceType":1173,"tags":3776},"版本升级与迁移","OpenClaw 版本升级步骤、迁移指南和回滚方案。","/best-practices/upgrade-migration",[2392,2391,3714,1974],{"title":3778,"description":3779,"path":3780,"category":3781,"difficulty":3166,"updatedAt":1254,"sourceType":1351,"tags":3782},"语音助手配置与使用指南","全面了解 OpenClaw 语音功能的配置和使用，包括语音唤醒、连续对话和语音合成。","/best-practices/voice-assistant-setup","语音交互",[1479,3783,3784,1257],"wakeword","speech",{"title":3786,"description":3787,"path":3788,"category":3789,"difficulty":3166,"updatedAt":1254,"sourceType":1351,"tags":3790},"语音功能最佳实践","如何在日常场景中高效使用 OpenClaw 的语音功能，提升工作和生活效率。","/best-practices/voice-usage","使用技巧",[1479,3473,3268,1291],{"title":3792,"description":3793,"path":3794,"category":3396,"difficulty":3166,"updatedAt":1262,"sourceType":1173,"tags":3795},"Web 入口怎么选：Dashboard、WebChat、message CLI","结合最新官方 Dashboard、WebChat 和 CLI 文档，总结什么时候该用 Dashboard、什么时候用 WebChat、什么时候更适合用 openclaw message 做验证与自动化。","/best-practices/web-entry-selection",[1251,1320,1369,2712,1516],{"title":3797,"description":3798,"path":3799,"category":3396,"difficulty":3194,"updatedAt":1305,"sourceType":1173,"tags":3800},"WebChat 更适合当什么，不适合当什么","结合最新官方 WebChat 文档，整理一套更稳的 WebChat 使用策略，帮助团队把它作为 operator 和验证入口，而不是过早承担所有长期协作场景。","/best-practices/webchat-operator-usage-policy",[1320,1251,3801,1387,1516],"operator",{"title":3803,"description":3804,"path":3805,"category":3193,"difficulty":3194,"updatedAt":1262,"sourceType":1173,"tags":3806},"用 Webhooks 做安全的外部事件接入","结合最新官方 Webhooks 文档，总结如何把 Gmail、表单、工单和内部系统事件安全送进 OpenClaw，同时避免会话污染和误投递。","/best-practices/webhook-ingest-routing",[1832,1299,1246,1833,1219],{"title":3808,"description":3809,"path":3810,"category":3273,"difficulty":3619,"updatedAt":3066,"sourceType":1193,"tags":3811},"用 OpenClaw 搭建每周“教程 + 更新 + 案例”内容流水线","把教程、版本更新和案例拆成固定节奏，用一套低成本流程持续为中文站带来搜索流量、时效内容和转化素材。","/best-practices/weekly-content-pipeline",[3070,3267,1245,3275,3071],{"title":3813,"description":3814,"path":3815,"category":3364,"difficulty":3194,"updatedAt":1254,"sourceType":1351,"tags":3816},"WhatsApp 自动化工作流实战","利用 OpenClaw 的 WhatsApp 渠道实现自动化工作流，包括自动回复、消息转发和定时提醒。","/best-practices/whatsapp-automation",[1432,1246,1198,1245],{"all":3818,"docs":1185,"news":2400,"bestPractices":3159},392,1792394218662]