openClaw快速安装部署:让AI住进你的电脑

0 阅读4分钟

一、前言

上篇说完OpenClaw是什么,有小伙伴留言说:

"听起来挺猛,但安装肯定很复杂吧?"

确实,之前我也有这个顾虑。毕竟涉及到Gateway、Agent、多渠道配置,听起来就头大。

但实际搞下来——就两条命令。

今天手把手带你们走一遍,快速让AI跑起来。


二、环境准备

2.1 需要什么

  • Node.js >= 22
  • macOS / Linux / Windows(WSL2)

先检查一下你有没有Node:

打开终端,输入:

node -v

如果显示类似 v22.x.x,说明有了。

如果没有,去 nodejs.org 下载安装,或者用nvm管理:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22

2.2 系统选择

系统推荐度备注
macOS⭐⭐⭐⭐⭐最省心
Linux⭐⭐⭐⭐⭐最稳定
WSL2⭐⭐⭐⭐Windows推荐用这个
Windows原生⭐⭐容易出问题,尽量别用

重点:Windows用户强烈建议用WSL2,别直接在cmd/powershell里折腾。


三、安装步骤

3.1 第一条命令:安装

在终端执行:

npm install -g openclaw@latest

或者用pnpm:

pnpm add -g openclaw@latest

等它跑完,大概几十秒。

3.2 第二条命令:初始化

openclaw onboard --install-daemon

然后它会一步步问你,照着回答就行:

  • 选模型:推荐选Anthropic Claude或者OpenAI GPT-4(需要先去官网申请API key)
  • 选渠道:先跳过,后面专门讲
  • 设信息:你的名字、AI怎么称呼你
  • workspace放哪里:用默认路径就行

不懂的选默认项,一路回车到底。

3.3 启动Gateway

装完之后,启动:

openclaw gateway --port 18789 --verbose

看到类似这些输出就说明跑起来了:

Gateway: bind=lan (0.0.0.0), port 18789
Dashboard: http://192.168.0.111:18789/
Agent: ready

记住这个端口:18789。


四、第一个任务:让它帮你查天气

4.1 试试效果

Gateway启动后,直接在终端输入:

openclaw agent --message "上海今天天气怎么样"

正常情况下,它会调用天气API,返回类似:

上海今天晴转多云,15-22度,微风。

4.2 调不通怎么办

情况1:Skill没加载 如果它说不会,试试让它刷新:就说"请刷新一下Skill列表"

情况2:curl命令不存在 有些精简版系统没预装curl。macOS用 brew install curl,Ubuntu用 sudo apt install curl

情况3:网络问题 国内访问wttr.in有时候抽风,可以考虑挂代理,或者换用国内天气API


五、控制台初体验

5.1 打开Dashboard

浏览器访问:

http://127.0.0.1:18789/

或者局域网其他机器访问:

http://你的IP地址:18789/存在权限问题,最好还是本机访问

你会看到一个Web界面,可以在里面发消息聊天、查看配置、管理Session。 openclaw

5.2 发消息

在输入框里直接发消息,跟AI对话。


六、这些命令够你用了

装完之后,记住这5个命令就够了:

命令用途
openclaw gateway启动Gateway
openclaw dashboard打开Web控制台
openclaw status查看状态
openclaw doctor健康检查+排错
openclaw agent直接对话

常用场景

启动Gateway:openclaw gateway --port 18789 --verbose

打开控制台:openclaw dashboard

发送消息:openclaw message send --target +1234567890 --message "Hello"

跟AI对话:openclaw agent --message "上海天气怎么样"

查看渠道:openclaw status

安全审计:openclaw security audit

进阶命令

命令功能
openclaw agents add添加新Agent
openclaw channels login登录新渠道
openclaw skills list列出技能
openclaw cron list定时任务
openclaw browser start启动浏览器
openclaw update check检查更新

记不住没关系,用到再查:openclaw --help

七、常见的坑

坑1:Node版本太低 症状:安装时报错,提示Node版本不支持 解决:先 node -v 看看版本,然后用nvm升级:nvm install 22,nvm use 22

坑2:端口被占用 症状:提示 Port 18789 already in use 解决:换个端口试试:openclaw gateway --port 18888

坑3:Windows下跑不起来 症状:各种奇怪报错 解决:别挣扎了,装个WSL2吧。运行 wsl --install,然后在WSL里按照上面的步骤重来

坑4:Daemon安装失败 症状:提示权限问题 解决:如果是macOS,可能需要先授权:sudo chown -R $(whoami) ~/.openclaw


八、开机自启

8.1 安装系统服务

初始化时如果选了 --install-daemon,系统重启后会自动启动。

手动安装:

macOS:openclaw daemon install Linux:sudo openclaw daemon install

8.2 手动启动

不想用daemon,每次手动启动也行:

openclaw gateway --port 18789 --verbose

八、总结

安装就两步:

npm install -g openclaw@latest openclaw onboard --install-daemon

然后启动:

openclaw gateway --port 18789 --verbose


参考资料:

官方安装文档:docs.openclaw.ai/start/getti…

官方Discord:discord.gg/clawd