乐于分享
好东西不私藏

30 分钟装好 OpenClaw:保姆级教程,复制粘贴就能跑(2026版)

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 建议升级到最新版

打开终端,输入:

node -v

如果低于 22,用 nvm 升级:

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 安装并切换到 Node 22
nvm install 22
nvm use 22

二、安装:两条路,选一条就行

方法一:一键安装(推荐新手)

一条命令搞定:

npm install -g openclaw@latest

或者用 pnpm(速度更快):

pnpm add -g openclaw@latest

装完确认一下:

openclaw –version
# 应该显示类似 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 没有被其他进程占用。

三、配置向导:一步步来,别跳步

安装完成后,运行:

openclaw onboard –install-daemon

--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 配置项,改为:

canvas_host: 127.0.0.1

④ 连接消息平台

向导会引导你连接第一个消息渠道。以 Telegram 为例:

• 在 Telegram 找到 @BotFather

• 发送 /newbot 创建新 Bot

• 获取 Bot Token,粘贴到向导

WhatsApp 需要扫描二维码配对(WhatsApp → 设置 → 右上角 QR 图标 → 扫码)。

💡 建议

WhatsApp 最好用专用号码,不要用个人主号。否则所有消息(包括家人朋友)都会进入 Agent 上下文。

四、打开控制面板

配置完成后,浏览器访问:

http://127.0.0.1:18789/

这是 OpenClaw 的 Web 控制面板,可以:

• 实时查看 Agent 运行状态

• 管理 Skills

• 查看对话历史

• 调整配置

首次访问需要认证 Token,终端运行:

openclaw gateway –verbose

会打印出 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 自检并修复常见问题:

openclaw doctor –repair

它会检查配置文件格式、端口占用、模型连接、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笔记 一个自学智能体的真实记录