OpenClaw 安装指南：Mac、Linux 与 Windows WSL

本地安装是免费试用 OpenClaw 最干净的方式：你在自己已有的机器上运行真实的开源软件，不合适随时可以停止、检查、彻底删除。本指南覆盖 macOS、Linux 和 Windows（通过 WSL）的安装流程，以及 onboarding 和新手最常遇到的报错。

具体命令请始终以官方 Getting Started 指南为准——OpenClaw 迭代很快，官方文档是唯一事实源。把本页当作那份指南的决策伴侣。

开始之前

你需要三样东西：

1. 一个你用得顺手的终端。 macOS 和 Linux 直接可用；Windows 用户请使用 WSL（Windows Subsystem for Linux），不要尝试原生运行网关。
2. Node.js 和 npm（如果你选择 npm 路径）。安装前先在官方文档确认当前支持的 Node 版本。
3. 一个模型提供商账号。 OpenClaw 本身开源免费，但 AI 模型不免费。先注册好提供商账号，如果对方支持，顺手设置消费上限——这能让你的试用成本可预期。

正常情况下，官方快速开始大约需要 5 到 15 分钟，加上模型提供商和首个渠道的接入时间。

安装：两条官方路径

官方文档提供安装脚本和 npm 两条路径。对大多数人来说安装器更快；已经在管理 Node 版本、希望把包装进自己工具链的用户适合 npm 路径。

无论选哪条，都从官方文档页面获取命令——不要从不明来源的视频或博客评论区复制安装命令。安装完成后，按文档列出的版本命令确认二进制已在 PATH 中，再继续下一步。

Onboarding 与第一次对话

openclaw onboard 流程把各个部件连起来：它会引导你选择模型提供商、填入凭证、连接第一个聊天渠道。请刻意把首次会话控制得很小：

• 一个提供商，一个渠道。 OpenClaw 支持很多渠道——Telegram、iMessage、WebChat、Discord、Slack、WhatsApp、Signal、Microsoft Teams 等，部分通过插件支持——但首次测试只需要一个。选你实际在用、风险最低的那个。
• 一个明确的测试任务。 用大白话写下一个目标，比如：「总结这个低风险群聊里昨天的对话」。明确的任务能阻止你因为设置界面摆在那里就把所有账号都接上。
• 一份凭证清单。 记下你添加的每个 token 和 API key。之后轮换或删除它们时你会需要这份清单。

完成一两次有实际价值的对话后，复盘一下：什么好用了、助手能触达哪些数据、这份价值是否值得继续扩大范围。渠道和发送者要一个一个加——不要一次全开。

新手最常踩的五个报错

1. 安装后提示 command not found。 安装目录不在 PATH 里。重启终端，或把安装器输出中显示的路径加进你的 shell 配置文件。
2. Node 版本不受支持。 npm 路径在旧版 Node 上会失败或表现异常。对照官方文档的版本要求，用你的版本管理器切换。
3. 模型提供商鉴权失败。 通常是 API key 错误、过期，或未开通计费。去提供商后台重新生成 key，只对该提供商重跑 onboarding。
4. 渠道连上了但助手从不回复。 检查谁被允许触发它。默认限制较严是正常的——把自己的账号加进允许列表；群聊场景还要检查是否需要 @ 提及才会回复。
5. Windows 用户在 WSL 之外安装。 原生 Windows 不是受支持的路径；请在 WSL 内安装并运行网关。

第一天就设好安全边界

本地试用同样意味着把一个 AI agent 连上你的消息和文件。在扩大任何范围之前，请先读官方安全文档，把允许的发送者列表收小，使用官方的安全审计命令，并且绝不从金融账号或无法轮换的凭证开始。

接下来去哪

本地安装回答的是「这东西适不适合我的工作」——但网关只有在你电脑醒着时才可达。当你需要在笔记本合上时也能用，下一步就是一台小型常开环境：看在 VPS 上运行 OpenClaw：最便宜的常开方案。如果你完全不想碰服务器，先读托管 OpenClaw vs 自托管：怎么选。