一、前言
上篇说完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://你的IP地址:18789/ (存在权限问题,最好还是本机访问)
你会看到一个Web界面,可以在里面发消息聊天、查看配置、管理Session。
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