OpenClaw 中文指南、安装教程与生态产品对比

本站是面向中文用户的独立 OpenClaw 导航与判断站。先确认 OpenClaw 是否适合当前问题，再决定安装、升级、选择成品客户端、接入渠道或扩展 Skills；不要把“能运行”直接等同于“适合接入真实权限”。

当前版本：Stable 2026.10.5（2026-10-21 核验）

• 常规正式版：v2026.10.5。官方在 2026-10-18（UTC）发布，npm latest 已指向此版本。
• Extended Stable：v2026.9.33。这是单独的 9 月 Gateway 维护线，不是与 10.5 一起发布的全平台桌面版本。
• 预览版：v2026.10.10-beta.3。2026-10-21（UTC）发布，主要修复 Windows / Gateway 启动与升级恢复问题；仅适合隔离测试，不是正式稳定版。

10.5 值得先看四件事：

1. Agent 侧栏改进：搜索、置顶和子 Agent / Processes 状态更易发现。
2. Skill Workshop 历史与 Undo：learned Skills 的修改有历史和恢复能力；不等于第三方 Skill 或 Plugin 自动安全。
3. 公开会话风险：已发布的聊天链接可供持链接者直接读取，包含后续加入的消息；涉及私人信息时尤其谨慎。
4. 升级恢复与数据库迁移：跨 SQLite schema 24→25 后降级，需要事前匹配备份；旧状态格式可能要按 Doctor 提示先做中间升级。

官方 Node 范围仍为 24.16.0+（24.x）或 26.1.0+，推荐 Node 26。详情看2026.10.5 更新解读和版本中心，不要从 Beta 的较大版本号推断它更适合生产。

第一次来：先完成五分钟判断

如果还不能清楚说出要解决的问题，先看五分钟起步判断。它会帮助你确认：

• 目标是信息整理、知识问答、消息协作，还是需要真实写入和执行。
• 是否愿意维护模型、Gateway、渠道、凭证、插件与升级。
• 哪些权限可以从只读开始，哪些动作必须保留人工确认。
• 是否已经准备测试数据、日志和回退方式。

已经决定自行部署

安装中心已按 2026.10.5 稳定版更新 Node、core、Quick Start、桌面 Companion、Docker / VPS、Linux 实际发布资产与升级回退建议。

Node 运行时要求未变：Node 24.16.0+（24.x）或 26.1.0+，推荐 Node 26。10.5 升级前应备份状态库；CLI 与 Gateway service 的实际 runtime 仍需分别检查。

Quick Start 继续可用；9.2 的 managed local-model setup 也仍然有效。无论走哪条路，foreground Gateway 能打开 Dashboard 都不代表已经安装常驻 service；headless 环境的一次性 dashboard link 也不应改造成长期共享凭据。

安装后不要反复重装覆盖现场。先学会状态、Gateway、日志与更新命令；出现异常时从故障排查中心的只读步骤开始。

想先用成品桌面 Agent

产品中心把自行部署 OpenClaw、成品桌面 Agent 与云平台入口分开。重点产品有独立证据页：

• WorkBuddy：腾讯 CodeBuddy 体系内的办公工作台；官方未说明其基于 OpenClaw。
• QClaw：官方明确称基于 OpenClaw 开源生态，侧重桌面与多渠道远控。
• EasyClaw：官网称基于 OpenClaw，提供桌面、云端和企业入口；数据边界需按政策逐项判断。
• Molili：候选入口证据链不完整，当前保持下载隔离，不恢复安装引导。

需要横向选择时进入产品对比中心，不要只按功能数量决定。

从实际问题选择场景

使用场景覆盖晨间简报、Reddit/YouTube 摘要、第二大脑、会议行动项、个人 CRM、习惯追踪和知识库 RAG 等案例。每页会列出来源边界、所需组件、读写类型、风险、设置步骤和故障排除。

首次试点优先使用公开或虚构数据，选择能人工核对的只读任务，再逐步增加外部服务和写操作。

接消息渠道或安装 Skills

• 渠道中心比较飞书、微信、Telegram、WhatsApp、Discord 与 Slack 的交付形态、凭证和权限边界。
• 飞书接入教程覆盖企业自建应用、WebSocket 事件、pairing、群策略与验证。
• ClawHub说明官方 Skills 市场的入口、扫描与证据边界。
• Skill 安装与验证区分 ClawHub、workspace、Personal Library 与当前 Skill Workshop；新版保留 learned Skill 历史和 Undo，自学习当前使用 auto / off。第三方扩展仍应检查来源、网络和权限。

9.1：Memory 出问题先 reset 派生索引，不要直接删数据库

9.1 新增：

openclaw memory reset --agent main --yes

它用于清理和重建派生 Memory index / embedding cache，不会删除 Session、transcript 或 Memory 原始文件。所以它不是隐私擦除命令，也不应该被写成“清空所有记忆”。

需要重建时再执行：

openclaw memory index --agent main
openclaw memory status --agent main --deep

如果问题只是 index 不兼容或损坏，优先使用这条官方窄恢复路径，不要手工删除 Agent SQLite 数据库扩大故障面。

9.2 起：共享 Gateway 不要依赖默认跨 Agent 权限

9.2 曾调整共享 Gateway 的默认权限。以下是当时省略对应设置的风险示例；在 10.5 实际部署时，应重新核对官方文档和生效配置，不应把历史默认值直接当作当前保证：

tools.sessions.visibility = all
tools.agentToAgent.enabled = true

这意味着，满足其他策略时，具备相关工具的 Agent 可能列出、读取、搜索、发消息或检查其他 Agent 的 Session，其中也可能包含其他用户的 transcript。

共享 Gateway 建议显式配置，不要依赖默认值。例如希望维持更保守的同 Agent 范围，并关闭跨 Agent 调用：

{
  "tools": {
    "sessions": { "visibility": "agent" },
    "agentToAgent": { "enabled": false }
  }
}

真正要求当前 Session 单独隔离时使用 self。需要部分 Agent 互通时使用明确 allow list。

还要注意：agent 只限制到同一个 Agent；多人共用同一个 Agent 时，仍可能看到其他人的 Session。互不信任的用户应使用独立 Gateway，而不是把 Session visibility 当成完整多租户隔离。

9.3：公开聊天链接是分享能力，不是私密预览

9.3 新增 revocable read-only conversation sharing。Session creator 或 Gateway admin 可以发布公开链接，持有链接的人可以读取现有和后续新增的聊天文本，直到访问被撤销。

公开页不会展示 tools、reasoning、files、images 和 executable widgets，但“只读”不等于“私密”：链接可以被转发，撤销也无法收回别人已经保存的副本。

因此含有客户数据、内部代码、敏感运营信息或凭据线索的 Session，不要因为页面是只读就直接分享。普通 private-session preview 仍然走原来的认证边界，两者不要混淆。

真实接入前先守住边界

安全入口把 security audit、security.installPolicy、skills verify 和 ClawHub 扫描串成一条流程。接入前安全清单继续核对触发者、日志、数据范围、人工确认与回滚。

10.5 进一步补强 update / recovery 与 Doctor，但这些机制不会替你验证 Agent 的业务语义、权限和数据边界。共享环境仍要显式设置 Session visibility 与 agent-to-agent policy；hostname blocklist、approval 和网络控制也只是其中一层，不是完整多租户或 egress firewall。

当不能说明谁能触发、数据发给谁、错误如何停止和恢复时，先不要扩大权限。

跟进版本与内容

• 版本中心区分 2026.10.5 Regular Stable、2026.9.33 Extended Stable 与预览渠道。
• 博客已新增 2026.10.5 更新解读，并保留 9.4 历史专题与旧版本迁移资料。
• 关于本站说明非官方身份、来源分级、核验日期、纠错与链接隔离规则。

本站优先使用官方官网、文档与 GitHub。官方发布事实、社区 issue、厂商主张、本站判断和本站实测会分开标注；没有证据的项目保留为未知，不用竞品表或历史营销材料补齐。