给AI安个家:OpenClaw 2.0 装出你的 7*24 管家

— openclaw·重新出发 · 第 01 篇 —

给AI安个家：OpenClaw 2.0 装出你的 7×24 管家

把编码 Agent 变成 7×24 在线私人管家，第一步，让它住进你自己的机器

01开篇：一只龙虾的第二次入职

半年前，2026 年 2 月，这个公众号发过一篇《30 分钟快速上手 OpenClaw》。那时它还是 1.x。之后那套教程停在了半路，它却完成了一次彻底的大蜕壳——OpenClaw 2.0（v2026.8.1），一次合并了 16,977 个 pull request、698 个直接 commit、987 位贡献者参与的改版。旧教程里的不少步骤，如今已经对不上了。

所以这个系列叫"重新出发"，是个双关：产品重新出发，我们也重新出发。

OpenClaw 的吉祥物是一只龙虾。龙虾的成长方式很特别：蜕壳。这个项目自己就蜕过好几次——从 Warelay 到 Clawd，再到 2026 年 1 月底定名 OpenClaw，社区信条是"蜕壳即成长"。2.0 是又一次蜕壳：壳换了，龙虾还是那只龙虾，项目口号也一直没变——"你的助手。你的机器。你的规则。"

这个系列我们把 OpenClaw 想象成一位 AI 管家，8 篇教程就是管家的入职八步：安家、接总机、建记忆、培训技能、排班表、全屋可达、签保密协议、转正上岗。今天是第一步——安家落户，给管家一个住在你自己机器上的家。

02核心概念：OpenClaw 2.0 是什么，为什么值得自己搭

💬 2.1 一次规模惊人的蜕壳

v2026.8.1（代号 OpenClaw 2.0）的规模，官方发布说明用三个数字概括：16,977 个 pull request、698 个直接 commit、987 位贡献者——改动触及安装、消息、记忆、技能、自动化、安全等每一个部分。规模之外，对第一次上手的人更重要的是它改了什么。有三处变化最要紧：

— 蜕壳即成长：从 1.x 到 2.0 的一次彻底蜕壳 —

还有两处变化先埋个伏笔，本系列后面会展开：消息方面，Telegram、Slack、Discord 和原生应用的对话保留更完整，你已接收的消息不会因为一次重启就丢；记忆方面，合格的个人 Agent 可以从该 Agent 的其他私人对话中召回相关上下文——管家开始有"记性"了，这是第 03 篇的主角。

💬 2.2 自托管 vs 托管：信任边界划在哪

为什么放着现成的托管 AI 助手不用，要在自己机器上装一套？官方文档里有一段论述值得转述：

这段话的推论就是 OpenClaw 的立场：这种替你行动的东西，应该住在你的硬件上。OpenClaw 是一个自托管网关，Gateway 进程跑在你自己的机器或服务器上，私人对话、记忆、凭据不经过任何第三方托管服务。官方对目标用户的描述是"开发者和高级用户，想要一个可以从任何地方发送消息的个人 AI 助手——而不放弃数据控制权或依赖托管服务"。

治理上一句话带过：项目由独立的 OpenClaw Foundation 治理，以 MIT 许可开源发布，没有付费层、没有官方托管服务——它的商业模式里没有"你的数据"这一项。

💬 2.3 三层架构：渠道 → 网关 → Agent

OpenClaw 的全部设计可以压缩成一张三层图（本系列首张统一视觉卡片，后文反复引用）：

聊天渠道 Channel        飞书 · 钉钉（国内主通道）/ Telegram / WhatsApp /                       Slack / Discord / Signal / iMessage / WebChat……        ↓网关 Gateway            长期运行的守护进程，默认监听 127.0.0.1:18789                       会话、路由、渠道连接的唯一真相来源        ↓智能体 Agent            干活的大脑（默认捆绑 Pi），带会话、记忆、工具

— OpenClaw 三层架构：渠道 Channel → 网关 Gateway → 智能体 Agent —

自上而下看：

这套分层就是本系列的地图：第 02 篇接渠道，03-05 篇武装 Agent，06 篇扩展控制平面和节点，07 篇收紧边界，08 篇整体上岗。

03实战：五步安家

概念说完，动手。实战共五步，编号从第 0 步到第 4 步（第 0 步是环境检查，所以从 0 数起）——以下命令均已对照官方文档（截至 v2026.9.4）核对，macOS / Linux / WSL2 为主路径，Windows 差异处单独标注。

💬 3.1 第 0 步：确认 Node 版本

OpenClaw 需要 Node 22.14 或更高版本：22.14+ 起步、24 推荐、26 亦可运行（截至 v2026.9.4）。先查一下：

# 用途：查看当前 Node 版本node -v

输出 v24.x.x 是推荐状态，v26.x.x 也可用；v22.14.x 以上可用；更老的版本（比如系统自带的 18/20）需要先升级——macOS 用 brew install node，或用 nvm、fnm、mise 等版本管理器。偷懒办法也有：下一步的官方安装脚本会自动检测并处理 Node。

💬 3.2 第 1 步：一条命令试起来

先用后装，npx 一行体验：

# 用途：免安装试用 OpenClaw（前台运行 Gateway）npx openclaw@latest

全新安装时，看过一行指向安全指南的提示后选择 Quick start。如果你的机器上已经有可用的 AI 访问（Claude Code 或 Codex CLI 登录、API key），这就是引导唯一的提问：OpenClaw 自动找到它，用一次真实调用验证，保存配置，然后打开 Web 仪表盘。Gateway 会在当前终端前台运行，按 Ctrl+C 停止，配置保留。

觉得合适，就正式安装：

# 用途：官方安装脚本（macOS / Linux / WSL2），自动处理 Node 并启动引导curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）：

# 用途：Windows 官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex

如果你自己管理 Node，也可以走 npm：

# 用途：npm 全局安装 + 引导并安装常驻服务npm install -g openclaw@latestopenclaw onboard --install-daemon

装完先验一下身：

# 用途：确认 CLI 可用openclaw --version

安装器会自动启动引导式设置：Quick start 复用检测到的 AI 访问直接开工；Custom setup 逐步走完所有选项（提供商登录、可选配置，耗时可能较长）。如果机器上检测不到任何可用的 AI 访问，引导会自动进入手动提供商配置，从零填 key 也可以。没配置完不要紧，openclaw configure 随时回来补，openclaw onboard --classic 则打开经典的逐步向导。

— 安装三阶段：试用 → 安装 → 验证 —

💬 3.3 第 2 步：让管家常驻

试用时 Gateway 跑在前台，终端一关管家就下岗了。既然目标是 7×24 在线，就要把它装成系统服务。停掉前台 Gateway（Ctrl+C），然后：

# 用途：把 Gateway 安装为开机自启的系统服务openclaw gateway install

这一条命令在 macOS 上安装 LaunchAgent，在 Linux 和 WSL2 上安装 systemd user unit，在原生 Windows 上安装计划任务（创建被拒绝时回退为每用户启动项）。配置在停止与安装过程中一直保留。

Linux/WSL2 用户注意一个坑：systemd 的 user 服务默认在你登出时被停掉，管家会"睡死"。引导流程会尝试替你启用 lingering（可能请求 sudo），如果没启用，手动补一条：

# 用途：启用 lingering，让用户服务在登出后继续运行（Linux/WSL2）sudo loginctl enable-linger $USER

💬 3.4 第 3 步：验证与第一次对话

# 用途：确认 Gateway 正在运行# 预期输出：监听 18789 端口；健康基线 Runtime: running、Connectivity probe: okopenclaw gateway status

输出确认 Gateway 监听在 18789 端口即为正常（健康基线还包括 Runtime: running 与 Connectivity probe: ok 两项）。然后打开仪表盘：

# 用途：在浏览器中打开 Control UIopenclaw dashboard

本地默认地址是 http://127.0.0.1:18789/。注意这个地址的含义：Gateway 默认只绑定本机回环地址，外网访问不到它——你稍后会感谢这个默认值，远程访问的正确姿势（Tailscale、SSH 隧道之类）留到第 06、07 篇再讲。页面能加载，就说明安装链路全通了。

最后一步仪式感：在 Control UI 的聊天框里输入一句话——收到的第一条回复，就是管家对你说的第一句"到岗报到"。这一句背后，消息走完了"浏览器 → Gateway → Agent → 模型提供商 → 原路返回"的完整链路，也是后面所有玩法共用的一条主干道。

想在手机上聊？国内最顺的两条路是飞书和钉钉——飞书是内置生产级渠道，扫码即可创建机器人，第 02 篇实战接入。Telegram 等海外渠道在合规网络环境下也是可选项，其中 Telegram 配置最简单，只需一个 bot token。

顺手记两个自救命令，本系列后面会反复用到：

# 用途：体检配置问题 / 只读健康检查并生成脱敏诊断openclaw doctoropenclaw triage

doctor 给人看，输出配置问题清单；triage 更进一步，生成一段脱敏的诊断提示词，可以直接交给 Claude Code、Codex CLI 或 OpenClaw 内置 Agent 排障——提示词会排除 secrets、tokens 和原始聊天载荷，在你选择交给谁之前，没有任何数据离开你的机器。

💬 3.5 第 4 步：选好模型提供商

这一步先判断走哪条路径：如果引导阶段（Quick start 或 Custom setup）已经复用或配置过模型，本步可以直接跳过——你手里已经有一个通过真实调用验证过的连接。需要手动配置、或想换掉默认模型时，往下看。

OpenClaw 不绑任何一家模型，默认模型用 provider/model 格式写在配置文件 ~/.openclaw/openclaw.json 里。以 Anthropic 为例（该配置文件支持 JSON/JSON5 风格）：

{  "agents": { "defaults": { "model": { "primary": "anthropic/claude-opus-4-6" } } }}

国内读者以通义千问（Qwen）为例走一遍完整流程，它是内置的一等提供商，API 兼容 OpenAI 风格。第一步，到 home.qwencloud.com/api-keys 创建或复制 API key；第二步，用国内端点跑引导：

# 用途：Qwen 提供商引导（国内端点；海外端点用 qwen-api-key）openclaw onboard --auth-choice qwen-api-key-cn

第三步，把默认模型设为 Qwen 的默认款 qwen/qwen3.5-plus：

{  "agents": { "defaults": { "model": { "primary": "qwen/qwen3.5-plus" } } }}

第四步，验证模型可用：

# 用途：列出 qwen 提供商可用模型# 预期输出：qwen 可用模型清单（内置目录含 qwen3.5-plus、qwen3-coder-plus 等）openclaw models list --provider qwen

改完配置怎么生效？Gateway 默认监视 ~/.openclaw/openclaw.json 并热加载（hybrid 模式）：模型类配置（agents、models）保存后即改即生效，无需重启；只有 gateway.*（端口、绑定、认证）等关键项才需要重启，而 hybrid 模式连这一步都会自动完成。需要手动重启时，命令是 openclaw gateway restart。

国内读者的好消息：中文生态的提供商支持相当全——阿里云百炼、通义千问、智谱 GLM、百度千帆、DeepSeek、MiniMax、Moonshot（Kimi）、阶跃星辰、字节豆包、腾讯云 TokenHub、小米 MiMo 都在官方支持列表里（截至 v2026.9.4）。国内网络环境下直接选国内提供商，比绕路访问海外 API 稳定得多。除单一提供商外，OpenRouter、LiteLLM 这类统一网关也在支持之列，后续要给管家换模型、做故障转移时再回来折腾。

不想花 API 费用也可以跑：Ollama、LM Studio、vLLM、SGLang 等本地推理都在支持之列，引导设置能自动发现本机已加载的合格本地模型（要求实测有效上下文不低于 16K 的工具型模型），同样先验证再保存。

到这里，安家完成：一个跑在自己机器上的 Gateway，一个验证过的模型连接，一句已经收到的回复。

04避坑指南

— 避坑巡检：安装期高频问题自查 —

# 用途：排查命令找不到问题node -v            # Node 装了吗npm prefix -g      # 全局包装在哪echo "$PATH"       # 全局 bin 目录在 PATH 里吗

# 用途：把 npm 全局 bin 加入 PATHexport PATH="$(npm prefix -g)/bin:$PATH"

05系列回顾与下期预告

回顾一下入职八步的全图：安家落户（本篇）、总机接线、记忆档案、技能培训、排值班表、全屋可达、保密协议、转正上岗。今天完成了第一步——你的机器上现在住着一只验证过身份的龙虾管家，Control UI 里已经有了第一句对话。

但你会发现一个问题：想找管家，得开浏览器进 Control UI，或者 SSH 上服务器。它住下了，你却够不着它。

下期解决这个问题。预告如下——

互动话题