🦞## 什么是 OpenClaw？
OpenClaw OpenClaw 是由 Peter Steinberger 和社区创建的开源、自托管个人 AI 助手。与基于云的 AI 助手不同，OpenClaw 完全在你自己的硬件上运行。
## 📦 前置条件
// ⚠️ Windows 用户：强烈推荐使用带 Ubuntu 的 WSL2
## 🚀 安装
方式一：快速安装
方式二：npm/pnpm
## ⚙️ 配置
运行交互式引导向导：
// 💡 专业提示：推荐使用 Anthropic Claude Pro/Max 以获得最佳体验
## 💬 你的第一次对话
启动网关：
发送你的第一条消息：
装之前先决定它跑在哪
这值得花两分钟想清楚，因为之后再搬家意味着通道配置要重做一遍。Agent 能在宿主机上读文件、执行命令，所以问题与其说是性能，不如说是「那台机器能碰到什么」。
| 宿主 | 适合 | 需要注意 |
|---|---|---|
| 一台闲置的小主机或 Mac Mini | 大多数人。常开、安静、运行成本低。 | 要先改掉休眠设置，它才会一直可达。 |
| 一台小 VPS | 需要一个稳定公网地址接 webhook 的人。 | 没有 GPU，本地模型会很慢。暴露任何东西之前先加固 SSH。 |
| 树莓派 5 | 预算紧张时做编排和小模型。 | 8 GB 大约把你限制在 3B 级模型。从 SSD 启动。 |
| 你天天在用的笔记本 | 花一个下午试试看。 | 不适合长期使用——Agent 在那台机器上的触达范围和你一样大。 |
官方文档对最后一行的措辞很直白，值得重复一遍：不要把它装在一台正在使用的工作或个人电脑上。Agent 在技术上能触达宿主机上的每一个文件。一台你重装了也不心疼的机器，才是合适的起点。
安装
安装脚本是各平台上受支持的方式。如果你想先看看再决定，`npx openclaw@latest` 可以在不永久安装任何东西的情况下跑起来。
# macOS / Linux curl -fsSL https://openclaw.ai/install.sh | bash # Windows (PowerShell) iwr -useb https://openclaw.ai/install.ps1 | iex # Or try it without installing anything: npx openclaw@latest
这一步把二进制放进 PATH。此时还没有任何配置，也没有注册服务——那是接下来两步的事。
openclaw onboard
它会写出 `~/.openclaw/openclaw.json` 并引导你选模型。之后重新运行会覆盖这个配置文件，但已积累的数据不受影响——在你为了改点什么而第二次运行它之前，值得先知道这一点。
openclaw gateway install openclaw gateway start openclaw gateway status
这就是那个会被跳过的步骤，也是「下午还好好的 Agent 第二天早上就没了」的原因。`gateway install` 会按平台把它注册到 launchd、systemd 或计划任务；`gateway start` 则让它跑在那个管理器之下，而不是跑在你的 shell 里。
确认它真的是健康的
三条命令回答三个不同的问题，选对那一条能省很多时间。出问题时按这个顺序跑。
openclaw doctor
`doctor` 会检视你的安装并报告缺了什么、配错了什么。去任何地方求助之前先跑它——它通常自己就把问题回答了。
openclaw triage
`doctor` 查的是安装状态，`triage` 看的是此刻实际出了什么错。安装没问题但行为不对时用它。
openclaw dashboard
dashboard 是确认「网关真的在提供服务」而不只是「进程还在」的最快方式。
早点定下来比晚点定下来好的几件事
- ✗在给它接通道之前，先决定允许它执行什么。工具策略是硬性拦截；写得再好的提示词不是。
- ✗永远不要把 18789 端口暴露到公网。用 SSH 隧道或私有网络访问——一个敞开的 Agent 端点，等于一个背后挂着你全部凭据的远程代码执行入口。
- ✗重新运行 onboard 会重写你的配置。如果你手工改过，先留个副本。
- ✗网关需要模型后端先起来。如果你本地跑 Ollama，冷加载会让第一次请求看起来像卡死而不是变慢。