夜雨聆风📘 OpenClaw 领航指南 · 第一篇
从零安装，把你的 AI 助手养起来 🦞
上个月，我开始使用一款叫 OpenClaw 的 AI 智能体框架。两周时间，我的工作流发生了翻天覆地的变化——写代码、回消息、定时任务、部署文章，它全包了。
今天带你从零开始，亲手安装属于你的第一个 AI 助手。这是「OpenClaw 领航指南」系列第一篇，后面我会陪你从新手到进阶，像养一只电子龙虾🦞一样，把它喂大、训好、用到飞起。
—— ✦ ——
一、为什么是 OpenClaw？
你可能已经在用 ChatGPT、Claude、DeepSeek 了。打开网页、输入问题、等待回答——这套流程大家都熟。
但问题是：你需要每次都打开浏览器，复制粘贴上下文，手动完成任务。
OpenClaw 不一样。它是一个运行在你本机的 AI 智能体框架，可以：
- 🔌 接入微信、Telegram、飞书——在任何聊天窗口对话 AI
- 🤖 调用 20+ 种工具——读文件、搜网页、执行命令、定时任务……
- 🧠 支持多模型切换——DeepSeek、Claude、OpenAI、智谱
- 💻 完全开源——MIT 协议，代码透明，数据留在本地
- 📱 跨平台——macOS / Linux / Windows 通吃
简单说：OpenClaw 不是另一个聊天机器人，而是一个能替你干活的 AI 管家。或者说，它是你养在服务器里的一只电子龙虾🦞——你喂它指令，它给你干活。
—— ✦ ——
二、系统要求
| 项目 | 要求 |
| 操作系统 | macOS 12+ / Linux / Windows 10+ |
| Node.js | v22.19 以上（推荐 v24） |
| 包管理器 | npm / pnpm / bun 任选 |
💡 Windows 用户注意：原生支持，但 WSL2 更稳定，推荐在 WSL2 里装。别问为什么，问就是踩过坑。
—— ✦ ——
三、安装（三选一）
🚀 方式一：一键安装（新手首选）
打开终端，一条命令搞定：
# macOS / Linux / WSL2 curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell（管理员）：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser iwr -useb https://openclaw.ai/install.ps1 | iex
脚本自动检测系统、安装 Node.js、安装 OpenClaw、启动引导。别走开，装完直接进初始化向导。
🛠 方式二：npm 手动安装
已有 Node.js 环境的同学：
npm install -g openclaw@latest openclaw onboard --install-daemon
🐳 方式三：Docker 部署
服务器环境一把梭：
docker run -d \ --name openclaw \ -p 18789:18789 \ -v ~/.openclaw:/root/.openclaw \ --restart unless-stopped \ openclaw/openclaw:latest
—— ✦ ——
四、初始化配置（关键步骤）
安装完成后，首次运行自动进入引导。手动安装需执行：
openclaw onboard --install-daemon
① 选择模型提供商
| 方案 | 提供商 | 获取方式 |
| 推荐 ⭐ | DeepSeek | platform.deepseek.com 注册 |
| 备选 | 智谱 GLM | open.bigmodel.cn |
| 海外用户 | OpenAI / Anthropic | 官网流程 |
个人推荐 DeepSeek：v4-flash 性价比极高，v4-pro 处理复杂任务，价格不到 OpenAI 的 1/10，中文理解甩海外几条街。
② 配置 API Key
按提示填入 API Key 即可。密钥存在本地 ~/.openclaw/ 目录，不上传任何第三方服务器。
③ 连接通讯平台
建议先跳过，后面有专题文章教。龙虾得慢慢养🦞
—— ✦ ——
五、启动与使用
openclaw gateway
访问控制台：http://localhost:18789
💡 后台运行：
openclaw gateway daemon start openclaw status # 查看状态 openclaw gateway logs # 查看日志
—— ✦ ——
六、第一次对话
装都装好了，来调戏一下：
你好，请用三句话介绍你自己。
帮我检查一下当前系统的 CPU 和内存使用情况。
🎉 你已经拥有了一个能帮你干活的 AI 助手
这只是开始，后面还有更多姿势解锁。
—— ✦ ——
七、常见问题排查
| 问题 | 解决方式 |
| openclaw 命令找不到 | 重开终端，或检查 PATH |
| 权限不足 | macOS/Linux 加 sudo |
| sharp 安装失败 | 先 brew install vips 再重试 |
| 模型调用失败 | 检查 API Key 和 Base URL |
| 端口被占用 | openclaw gateway --port 18790 |
—— ✦ ——
八、本期要点回顾
- OpenClaw 是本地 AI 智能体框架，不是又一个聊天机器人
- 安装只需一条命令，3 分钟搞定
- 支持多模型、多平台接入
- 核心优势：本地优先、开源透明、工具丰富
—— ✦ ——
🔜 下期预告
下一篇 「OpenClaw 领航指南（二）：四种交互方式与多模型配置」，带你：
- 搞懂 CLI / TUI / Web Dashboard / 聊天通道 四种入口，各有什么适用场景
- 多模型切换：DeepSeek 写代码、GLM 读长文，各司其职
- 国内网络环境下让 OpenClaw 跑得又稳又快
记得关注，养🦞路上不迷路。
📮 安装遇到问题？评论区留言，一一回复
👍 觉得有用，分享给身边的程序员朋友
🔔 点「关注」逻魔代码，不错过后续深度教程
— END —
本文由 逻魔代码 原创，未经授权禁止任何形式转载。
转载请联系授权，并保留出处。