通过Claude安装

一句话：装好 Claude Code，在对话框里说一句话 + 把这个页面的 URL 也给它，由 Claude 读完这份文档后带你走完全部流程。

前提：先装 Claude Code（一条命令）

Claude Code 本身的安装门槛已经被一条命令压到最低。访问下面的页面，根据你的操作系统复制对应命令执行即可：

装好后，桌面上会出现 ccl 启动入口（或在终端直接敲 ccl / claude）。从此你的机器上就有了一个能读懂上下文、能跑命令、能根据报错自我纠正的对话式助手。

开口之前：先对号入座

不同场景下，Claude 需要先解决的问题完全不同。你只需要把"场景 + 这个页面的 URL"告诉 Claude，剩下的让 Claude 读完文档来引导你。每种场景的开场白只有一两句话，直接复制即可。

场景 A：本机安装（最常见）

你准备在当前这台机器上装 OpenClaw，作为个人助手。

帮我参考 https://openclaw.cnfan.vip/installation/install-via-claude-code 在本机安装 openclaw。

场景 B：局域网另一台机器上装

你要在 NAS、公司服务器、或另一台开发机上装 OpenClaw，从你当前这台机器远程操作。

帮我参考 https://openclaw.cnfan.vip/installation/install-via-claude-code 在局域网另一台机器上安装 openclaw，目标机器 IP 是 192.168.x.x，系统是 [Ubuntu 24.04 / 飞牛 NAS / macOS / ...]。

场景 C：一台机器部署多个 Docker 实例

公司团队、多用户场景——在一台宿主机上跑多个 OpenClaw 实例。

帮我参考 https://openclaw.cnfan.vip/installation/install-via-claude-code 在一台机器上用 Docker 部署多个 openclaw 实例，目标机器 IP 是 192.168.x.x，系统是 [Ubuntu 24.04 / ...]，初步打算部署 [N] 个实例。

---

下面这部分是 Claude 读完上面的文档后应该遵循的引导规则。用户不需要复制，把场景和 URL 告诉 Claude 即可——Claude 抓取这份文档时会自动读到。

Claude 的引导规则

所有场景都必须遵守

1. 对话式流程：一组一组地问，每组得到用户确认后再进入下一步；不要一次性问完，也不要在用户没确认前跑命令
2. 参考资料：除了本文档，还要抓取并参考下面两份，再决定安装路径：
   • https://openclaw.cnfan.vip/installation/installation-guide — 各操作系统的手动安装详细步骤（WSL2 / VMware / Docker / 直接安装）
   • https://docs.openclaw.ai/zh-CN/install — OpenClaw 官方文档，多实例场景（场景 C）必须参考（本地 installation-guide 主要讲单实例）
3. 解报错：任何步骤出错，根据报错调整方案，不要把锅甩给用户让ta自己搜
4. API Key 判断：
   • 先问用户是否已有 API Key
   • 如果没有，调用 https://ai.cnfan.vip/api/providers 拉取服务商推荐列表（返回 { ok, providers: [...] }，每个 provider 含 provider_name 中文名、description 特点、coding_plan_url 注册入口、anthropic_base_url API 端点、default_haiku_model / default_sonnet_model / default_opus_model 默认模型）
   • 读完列表后，通过对话询问用户需求：使用强度/频率、月度预算、是否要最强模型、是否能接受按量计费、是否打算多用户共用等
   • 基于用户回答 + 各 provider 的 description，主动给出推荐（"首选 X，理由是 …；备选 Y"），用户同意后再继续——不要把列表原样甩给用户让ta自己挑
   • 给出推荐 provider 对应的 coding_plan_url，引导用户访问、完成注册和订阅、拿到 API Key
   • 在 openclaw onboard 时，使用这个 provider 的 anthropic_base_url 和默认模型
5. 装完不是终点：OpenClaw 跑起来只是第一步。继续引导用户完成 openclaw onboard（API Key、默认模型）和聊天工具接入（QQ / 飞书 / 微信等），直到用户能从聊天工具里和龙虾对话为止——不要装完就收尾

场景 A 专属：需要问清楚

• 操作系统（Windows / macOS / Linux 发行版）
• 是否需要沙盒（看机器上有没有工作资料、隐私数据、密钥文件）
• 要接哪些消息渠道（QQ / 飞书 / 微信）

场景 B 专属：远程单机

按这个顺序，一组一组确认：

1. SSH 免密：先确认从用户当前机器到目标机器是否已经免密登录；如果没有，引导用户一步步配好——没配好不往下走
2. 目标环境：目标机器的 Docker / Node / 包管理器现状，哪些需要先装
3. 选型：走 Docker 还是直接安装、是否需要沙盒、要接的消息渠道
4. 装完后通过 SSH 远程跑 onboard 和聊天工具接入

场景 C 专属：多实例 Docker

按这个顺序，一组一组确认：

• 第 1 组｜数量与命名：要部署几个实例？每个实例如何命名/编号？
• 第 2 组｜持久化目录（5 个约束）：① 程序目录支持 upgrade、② 配置/记忆/密钥目录持久化、③ 用户工作空间目录可读写、④ 多实例共享一个公共交换路径、⑤ 每实例 SMB 凭证隔离——每个实例的这些目录分别挂载到宿主机哪里？
• 第 3 组｜共享路径：公共交换路径放哪里？权限如何设？是否需要只读/读写分区？
• 第 4 组｜SMB 隔离：每个实例的 SMB 用户名、密码、可见共享如何隔离？是否对接已有 SMB / 域控？
• 第 5 组｜网络与端口：每个实例的对外端口、容器名、网络隔离方式？
• 第 6 组｜装后引导：每个实例启动后，逐个引导完成 openclaw onboard 和聊天工具接入，直到每个实例都能从聊天工具里和龙虾对话

所有组确认完毕后，再给出完整的 docker-compose.yml 和初始化脚本。

兜底：什么时候需要回到手动流程

Claude Code 引导安装的前提是你能正常使用 Claude Code 本身（能联网、能跑命令）。极少数情况下你需要回到手动流程：

• 你的环境连 Claude Code 都装不上
• 你想完全掌控每一步，不依赖对话引导
• 你在做一个 Claude 没见过的小众环境（例如非常老的发行版）

这些情况走 安装龙虾（手动流程总览）。即便走手动，遇到具体问题也随时可以把报错粘回 Claude Code 让它帮你诊断，参考 诊断龙虾。