30 分钟装好 OpenClaw:保姆级教程,复制粘贴就能跑(2026版)
30 分钟装好 OpenClaw:保姆级教程,复制粘贴就能跑(2026版)
2026-05-06 · 80后AI笔记
实操教程AI工具
很多人问我:”OpenClaw 到底怎么装?网上教程太散了,看半天跑不起来。” 今天这篇,从零到跑通,30分钟搞定。全程复制粘贴,不需要你懂编程。
开始前,先说一件重要的事
OpenClaw 不是普通的 App。
它能读你的文件、发你的邮件、执行你的命令。它的权限比一般软件大得多。
所以安装之前,先建立这个认知:OpenClaw 不是玩具,它是一个数字员工。你需要认真配置它的权限边界。
好,认知到位了,我们开始。
一、环境准备:先检查你的电脑
OpenClaw 支持 macOS、Linux、Windows,但有三个硬性要求:
✅ 系统要求
• Node.js ≥ 22.12.0(这条非常重要,低版本直接报错)
• 内存 8GB 以上(跑大模型调用时占用较多)
• npm 建议升级到最新版
打开终端,输入:
如果低于 22,用 nvm 升级:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 安装并切换到 Node 22
nvm install 22
nvm use 22
二、安装:两条路,选一条就行
方法一:一键安装(推荐新手)
一条命令搞定:
或者用 pnpm(速度更快):
装完确认一下:
# 应该显示类似 openclaw/2026.x.x
方法二:Docker 安装(适合服务器部署)
如果你要部署在云服务器上:
docker pull openclaw/openclaw:latest
# 启动容器
docker run -d \
–name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest
⚠️ 注意:确保端口 18789 没有被其他进程占用。
三、配置向导:一步步来,别跳步
安装完成后,运行:
--install-daemon 会把它装成后台服务,开机自启,不用每次手动启动。
向导会问你几个问题,我逐一解释:
① 选哪个 AI 模型?
三个主流选项:
Anthropic Claude
推理强、工具调用稳定,官方首选。推荐模型:claude-sonnet-4-6
OpenAI GPT
生态成熟、响应快。推荐模型:gpt-4o
DeepSeek(中国用户推荐)
价格极低(约 Claude 的 1/10),中文理解好,国内访问友好。推荐模型:deepseek-chat
② API Key 怎么搞?
以 Anthropic 为例:
• 访问 console.anthropic.com
• 进入 API Keys 页面,创建新 Key
• 粘贴到向导提示处
⚠️ 重要:不要用 Claude Pro/Max 订阅账号通过 OAuth 连接。Anthropic 已在 2026 年 1 月正式封禁这种用法,违规账号可能被封。正确方式是用 API Key(按量计费)。
③ Canvas Host 绑定(安全关键,别跳!)
这一步很多新手会跳过,但非常重要。
默认情况下,OpenClaw 的控制面板会绑定在局域网 IP,意味着你家或公司网络里的任何设备都能访问。改成 127.0.0.1 后,只有本机可以访问。
安装完成后,修改配置文件,找到 canvas_host 配置项,改为:
④ 连接消息平台
向导会引导你连接第一个消息渠道。以 Telegram 为例:
• 在 Telegram 找到 @BotFather
• 发送 /newbot 创建新 Bot
• 获取 Bot Token,粘贴到向导
WhatsApp 需要扫描二维码配对(WhatsApp → 设置 → 右上角 QR 图标 → 扫码)。
💡 建议
WhatsApp 最好用专用号码,不要用个人主号。否则所有消息(包括家人朋友)都会进入 Agent 上下文。
四、打开控制面板
配置完成后,浏览器访问:
这是 OpenClaw 的 Web 控制面板,可以:
• 实时查看 Agent 运行状态
• 管理 Skills
• 查看对话历史
• 调整配置
首次访问需要认证 Token,终端运行:
会打印出 Token,粘贴到浏览器即可。
五、第一次对话
在你的 Telegram 或 WhatsApp 里找到刚创建的 Bot,发送:
你好!请做一个自我介绍,告诉我你现在能做什么。
如果一切正常,Agent 会在几秒内回复,告诉你它已连接,并列出当前启用的能力。
六、费用估算:一个月花多少钱?
OpenClaw 本身免费,但调用 AI 模型要花钱。
Agent 每完成一个任务会触发 5-10 次 API 调用,且每次都会携带完整上下文历史,所以比普通聊天消耗 token 多得多。
以下是三种用户的月费估算(基于 Claude Sonnet 4.6,$3/$15 每百万 token):
轻度用户
偶尔查询,少量自动化
$5 – $15/月
中度用户
每日使用,部分自动化
$20 – $50/月
重度用户
持续运行,大量工作流
$80 – $200+/月
省钱小技巧:
• 定期开启新会话(旧上下文堆积是最大 token 消耗源)
• 简单任务切换到 DeepSeek(价格约 Claude 的 1/10)
• 在 API 控制台设置月消费上限,避免意外超支
七、安装完必做的健康检查
跑一条命令,让 OpenClaw 自检并修复常见问题:
它会检查配置文件格式、端口占用、模型连接、Skills 完整性等。
八、常见报错速查表
🔧 报错速查
• command not found: openclaw → npm 全局路径未加入 PATH,重启终端
• Node.js version < 22 → 版本太低,升级 Node
• Port 18789 already in use → 端口被占用,lsof -i :18789 找到并结束
• API Key invalid → Key 有误,控制台重新生成
• Channel linking failed → Token 过期,重新运行 openclaw onboard
写在最后
到这里,你已经完成了:
✅ 安装 OpenClaw CLI
✅ 配置 AI 模型
✅ 连接消息平台
✅ 打开控制面板
✅ 完成健康检查
接下来,是时候让它真正”动”起来了——装上 Skills,给它配上真正的超能力。
80 后学 AI,不需要成为程序员。只需要知道什么工具能帮我们省时间、提效率。
关注我,一个 80 后自学智能体的真实笔记。不整虚的,只写能用的。
关注我,持续分享 👇
80后AI笔记 一个自学智能体的真实记录
夜雨聆风