OpenClaw 从安装到上手完整指南：本地智能体、写代码与跨场景辅助

OpenClaw 是开源、本地优先的个人 AI 智能体（常被社区称作「小龙虾」）：网关跑在你自己的电脑或服务器上，状态与记忆留在本机，再通过 WhatsApp、Telegram、Discord、Slack、iMessage 等数十个频道与你对话。它不只聊天，还能读写文件、跑命令、控制浏览器、加载 Skills / 插件，并可接入 Claude、GPT、Kimi 等托管模型或本地模型。本文按「它是什么 → 安装 → 配置与安全 → 日常与写代码 → 跨场景辅助 → 进阶部署 → 官方入口」展开，尽量写细，方便对照上手。

一、OpenClaw 是什么：先建立正确预期

1. 定位

| 维度 | 说明 |
| --- | --- |
| 形态 | 本机 Gateway + CLI / 桌面 Hub + 多聊天频道 |
| 数据 | 优先本地；模型可走云端 API，也可接本地推理 |
| 能力 | 对话记忆、文件系统、Shell、浏览器、Skills、MCP |
| 受众 | 想自建「常驻私人助手」的人，而不是只要一个网页聊天窗 |

2. 它擅长什么

• 在你常用的 IM 里随时喊助手干活（DM / 群聊）
• 持久记忆偏好、项目与人物关系
• 浏览网页、填表、抽取信息
• 读写本地文件、执行脚本（全权限或沙箱，由你定）
• 用社区 Skills 或自写技能扩展能力
• 作为「模型无关」的 Agent 壳，换后端模型不必换工作流

3. 它不替代什么

• 不替代你对生产环境密钥与资金操作的最终审批
• 不保证「全自动零风险」——本机 Agent 权限越大，误操作面越大
• 不等于某个单一大模型本身；质量高度依赖你配置的模型供应商

二、安装：脚本优先，再验证网关

1. 系统要求（概念）

• Node.js：官方要求较新的 Node 22 / 24 / 25 线；一键脚本可代装（默认常瞄向 Node 24）
• 系统：macOS、Linux、Windows（原生 Hub / PowerShell / WSL2 Gateway）
• 从源码构建才需要 pnpm

2. 推荐安装命令

macOS / Linux / WSL2：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

脚本会检测系统、按需装 Node、安装 OpenClaw，并进入新手引导（onboard）。若只想安装、暂不引导：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

3. 其他安装方式

# 本地前缀（~/.openclaw），少动系统 Node
curl -fsSL https://openclaw.ai/install-cli.sh | bash

# 已有 Node 时
npm install -g openclaw@latest
openclaw onboard --install-daemon

# 源码
git clone https://github.com/openclaw/openclaw.git
cd openclaw && pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

另有 Docker / Podman / Nix / Ansible 等路径，适合服务器与机群。Windows 桌面还可装原生 Hub。

4. 验证

openclaw --version
openclaw doctor
openclaw gateway status

守护进程：macOS 用 LaunchAgent，Linux/WSL2 用 systemd 用户服务，Windows 可用计划任务或启动项。

三、首次配置：模型、频道与安全

1. 新手引导里做什么

1. 选择模型供应商（OpenAI、Anthropic、Moonshot/Kimi 等，以向导当前列表为准）
2. 粘贴 API Key，选定具体模型
3. 绑定至少一个聊天频道（Telegram / Discord 等）
4. 确认 Gateway 已运行，发一条测试消息

2. 安全基线

• 先沙箱 / 最小目录白名单，再逐步放开写权限
• 生产密钥、网银、云控制台不要交给「全自动永不询问」模式
• 群聊里注意谁能 @ 你的 Bot，避免被滥用
• 定期 openclaw doctor，密钥只放本机配置，勿进 Git

3. 常用运维命令

openclaw update --channel stable
openclaw dashboard
openclaw onboard

四、日常使用与代码编辑

1. 日常交互

帮我把 ~/Projects/demo 里失败的单测修到通过，
不要改无关目录，最后用中文总结改动。

好提示包含：目标、范围、验收、禁区。

2. 写代码节奏

1. 先「只读」说明仓库结构
2. 中等任务先计划再改
3. 看 diff / 测试结果
4. 再写 commit message（你审查后提交）

3. 与云端 Coding Agent 的差别

| 点 | OpenClaw | 纯云端 Agent |
| --- | --- | --- |
| 状态位置 | 本机 Gateway | 厂商云端 |
| 入口 | IM + CLI/Hub | IDE / Web 为主 |
| 模型 | 可换 | 多绑定自家模型 |
| 适合 | 私人自动化常驻 | 深度工程会话 |

五、跨场景辅助

• 办公：邮件草稿、群聊纪要、待办整理
• 内容：网页调研 → 大纲 → 初稿（禁编造，要来源）
• 笔记：对接 Obsidian 等知识库
• 设备：音乐 / 智能家居类 Skills（先确认权限）

原则：真实上下文、固定格式、高风险人工确认；重复流程沉淀为 Skill。

六、进阶部署

VPS / Docker / K8s 可远程挂 Gateway；更新用 openclaw update；PATH 找不到命令时检查 npm 全局 bin。

七、两周学习路径

D1–2 安装 + doctor + 绑频道 + 只读
D3–5 小范围写文件并审查
D6–10 浏览器任务 + 一个 Skill
D11–14 守护进程常驻 + 权限收紧

八、常见问题

Q：离线能用吗？ Gateway 在本地，云端模型仍需网络。
Q：和 Cursor 关系？ IDE 深挖仓库；OpenClaw 做跨频道常驻自动化，可并存。

九、官方入口

• 官网：https://openclaw.ai
• 文档：https://docs.openclaw.ai
• 安装：curl -fsSL https://openclaw.ai/install.sh | bash

十、小结

1. 脚本装通 Gateway，先 doctor 再绑频道。
2. 模型可换；权限从最小开始。
3. 写代码仍要看 diff 与测试。
4. 跨场景靠 Skills + 记忆。
5. 上服务器前先鉴权与备份。