OpenClaw领航指南(一):从零安装你的AI助手

📘 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 —

本文由逻魔代码原创，未经授权禁止任何形式转载。
转载请联系授权，并保留出处。