OpenClaw养虾笔记 系列 · 第二篇
OpenClaw安装指南30分钟,从零搭建你的本地AI Agent
环境准备 → 安装 → 配置模型 → 配置渠道 → 启动一次配置,随处可用
📖 导读
看完介绍心动了?别急,很多人卡在"安装"这步就放弃了——环境变量、依赖冲突、配置文件……OpenClaw把这些全砍掉了。一条命令装完,三步交互配完,30分钟从零到第一条对话。文末还附了踩坑指南,照着走不会翻。
01 环境要求
硬件要求
| 场景 | CPU | 内存 | 存储 |
| 个人使用(云端模型) | 2核+ | 2GB+ | 10GB SSD |
| 开发/测试 | 4核+ | 4GB+ | 20GB SSD |
| 本地模型(Ollama) | 8核+ | 16GB+ | 50GB+ SSD |
| 企业生产环境 | 8核+ | 16GB+ | 100GB+ NVMe |
💡 如果你用云端模型(DeepSeek、智谱等),对硬件要求很低。只有跑本地模型时才需要大内存和好GPU。
软件要求
唯一硬性依赖:Node.js 24(推荐)或 22.14+
node -v # 需要显示 v24.x.x 或 v22.14+
1 macOS / Linux 安装 Node.js(推荐nvm)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 24
nvm use 24
nvm alias default 24
node -v # v24.x.x ✅
2 Windows 安装 Node.js(推荐nvm-windows)
- 从 GitHub Releases 下载 nvm-windows 安装包
nvm install 24nvm use 24node -v
02 安装OpenClaw
图1:四种安装方式及适用场景
方式一:一键脚本(推荐新手)
curl -fsSL https://openclaw.ai/install.sh | bash\# Windows (PowerShell 管理员)
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd & install.cmd & del install.cmdopenclaw --version
方式二:npm/pnpm 安装(推荐开发者)
npm install -g openclaw@latest\# 或 pnpm(更快)
npm install -g pnpm
pnpm add -g openclaw@latestopenclaw --version
方式三:源码编译(适合二次开发)
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build
pnpm openclaw onboard
pnpm openclaw gateway
方式四:Docker 部署(适合服务器/企业)
docker pull openclaw/openclaw:latestdocker run -d --name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest
03 初始化配置
安装完成后,运行初始化向导:
openclaw onboard
向导会引导你完成三步核心配置:选模型 → 填Key → 选渠道。
第一步:选择大模型
图2:主流大模型选择指南
国内模型推荐(中文场景首选):
| 厂商 | 模型 | 价格 | 推荐度 |
| DeepSeek | DeepSeek-V4 | 极低 | ★★★★★ |
| 智谱AI | GLM-5.1 | 中等 | ★★★★★ |
| MiniMax | MiniMax-M2.7 | 低 | ★★★★★ |
| 豆包 | Doubao-2.0-pro | 低 | ★★★★ |
| 通义千问 | Qwen3.6-Plus | 中等 | ★★★★ |
本地模型(完全免费,需要硬件):
curl -fsSL https://ollama.com/install.sh | shollama pull qwen3:7b # 通义千问3 7B,中文好
ollama pull deepseek-r1:7b # DeepSeek推理模型\# 然后在 openclaw onboard 时选择 Ollama
第二步:配置API Key
① DeepSeek(最具性价比)
访问 platform.deepseek.com,注册账号(支持手机号)
进入"API Keys"页面,点击"创建API Key",复制后在向导中粘贴
② 智谱AI
访问 open.bigmodel.cn,注册账号
在"API Keys"页面创建密钥,复制后在向导中粘贴
💡 大多数国内模型厂商都提供免费额度(通常几十万到几百万token),足够你充分体验。
第三步:选择通讯渠道
图3:通讯渠道选择指南
| 渠道 | 难度 | 适合谁 |
| Web界面 | ⭐ 零配置 | 所有人,localhost:18789 |
| CLI命令行 | ⭐ 零配置 | 开发者,终端直接用 |
| 飞书 | ⭐⭐ 简单 | 字节系/新兴团队 |
| QQ机器人 | ⭐⭐ 简单 | 年轻用户/社区 |
| 微信 | ⭐⭐ 简单 | 国内个人,仅私聊 |
| Telegram | ⭐ 简单 | 海外用户 |
🚀 新手建议:先用Web界面,零配置即可体验。确认好用后再接入飞书/QQ机器人等渠道。
飞书接入简要步骤:
openclaw channels login --channel feishu\# 用飞书App扫描终端中的二维码,自动创建机器人
openclaw gateway restart
QQ机器人接入简要步骤:
\# 前往 https://q.qq.com/ 创建机器人,获取 AppID 和 AppSecret
openclaw channels add --channel qqbot --token "AppID:AppSecret"
openclaw gateway restart
04启动Gateway
配置完成后,通过 onboard 命令安装守护进程并启动:
\# 安装守护进程并启动Gateway(推荐)
openclaw onboard --install-daemon
openclaw gateway status # 查看运行状态
openclaw dashboard # 打开Web管理面板
openclaw logs --follow # 查看日志
openclaw gateway restart # 重启
openclaw gateway stop # 停止
OpenClaw通过 --install-daemon 参数在onboard时自动安装系统守护进程(macOS用launchd,Linux用systemd),无需手动配置。
**启动后验证:**打开浏览器访问 http://localhost:18789,试着发一条消息:"你好,介绍一下你自己"。如果收到正常回复——恭喜,安装配置完成。
OpenClaw代表了一种趋势
AI从"对话助手"进化为"执行助手"
如果你觉得"每天有太多机械性的工作在消耗时间"——这正是OpenClaw要解决的问题。
💡 总结与思考
从敲下第一行安装命令到发出第一条指令,你只用了30分钟。但这个30分钟,可能改变你和AI的协作方式——从"问问题"变成"派任务"。
🤔 值得思考的问题
安装过程是否比你想象的更简单?如果你是团队技术负责人,把OpenClaw部署到团队服务器上,哪些重复性工作最先可以被自动化?
如果你已经成功安装,欢迎在评论区分享你的体验
遇到卡点?GitHub Issues随时等你 · 觉得有用?转发给还在手动巡检的同事