当前位置: 首页 > news >正文

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

一、前言

上篇说完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。

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


参考资料:

官方安装文档:https://docs.openclaw.ai/start/getting-started

官方Discord:https://discord.gg/clawd

http://www.jsqmd.com/news/540729/

相关文章:

  • 这里模拟各种操作并断言结果
  • ABAQUS盾构隧道开挖模型:一环七片含螺栓配筋的Cae文件(单位:毫米)
  • 2026零基础学化妆怎么选?新手择校全攻略,实用好懂易上手 - 品牌测评鉴赏家
  • CentOS7下docker方式安装magento2
  • HUNYUAN-MT企业级Java集成指南:构建高并发翻译微服务
  • 如何使用 Java 替换特定字符串后的文本
  • 代码随想录一刷记录Day6——leetcode454.四数相加II 383. 赎金信 15. 三数之和 18. 四数之和
  • Altium Designer 19导出Gerber文件,我踩过的这些坑希望你别再踩(附完整配置清单)
  • APP测试 - adb基础命令2
  • 手把手教你无损合并磁盘分区:从删除卷到空间分配的5个关键陷阱
  • 无线通信入门:为什么说DFT是提升OFDM信道估计性能的“降噪神器”?
  • 二手圆锯机市场2026评测:实力企业大盘点,行业内二手圆锯机厂商推荐耀本机械专注行业多年经验,口碑良好 - 品牌推荐师
  • 避坑指南:Joern生成PDG时行号丢失问题的3种解决方案
  • Llama-3.2V-11B-cot开发者案例:基于Streamlit定制化UI扩展实践
  • 2026年最新化妆学校权威排行榜 小白择校必看 - 品牌测评鉴赏家
  • gdb 之 attach
  • 扎根工业一线!JBoltAI两款数智化产品解锁工厂提效新路径
  • DevEco Studio NEXT实战:如何快速定位并解决hvigor的configProps报错问题
  • 抖音无水印视频智能下载与高效管理解决方案:从技术原理到行业应用
  • 生发机构哪家好?黑奥秘AI智能检测让效果可量化 - 美业信息观察
  • 保姆级教程:在CherryStudio中为Qwen/DeepSeek模型配置专属知识库(含思源笔记API对接全流程)
  • COS化妆培训学校哪家好?零基础择校全攻略,轻松选对优质院校 - 品牌测评鉴赏家
  • 防脱生发哪家机构靠谱?黑奥秘四大自研成分提供科技支撑 - 美业信息观察
  • Qwen3-32B-Chat镜像性能实测:OpenClaw任务执行效率提升30%
  • 在遵义学美容,我跑了几家培训学校后的真实感受 - 品牌测评鉴赏家
  • 道心网络安全学习笔记系列之好靶场的信息收集2
  • CentOS 6.5 yum 安装 MongoDB 2.6及 相关配置
  • 3.26软工
  • Doris从入门到上天系列第五篇:Doris中的物化视图
  • 如何去选择品质优秀的段码屏厂家