OpenClaw 是一个可以部署在自己服务器上的 AI Agent,能通过 Telegram、飞书等渠道对话,帮你操控系统、定时任务、联网搜索、写代码部署项目的等等,是一个配置好了會非常强的 AI 自动化平台,能帮你对接各种 AI 模型(DeepSeek、Kimi、Claude 都行),还能直接绑飞书、Telegram 这些聊天工具,相当于给自己造了一个随叫随到的 AI 助手。
今天这篇文章,我就来手把手带大家把 OpenClaw 部署到Mac电脑中。Mac 用户安裝体验效果最好,可享受原生GUI体验!
开始之前,先搞清楚几件事
选什么系统?
| 系统 | 推荐程度 | 说明 |
|---|---|---|
| Macos | 强烈推荐 | 体验最好,能调用日历、备忘录、截图等系统功能 |
| Windows | 完全可用 | 推荐用 WSL2 跑,体验接近 Mac |
| Linux | 适合折腾 | 开发者的老朋友了,不多说 |
简单来说:有 Mac 就用 Mac,没有 Mac 用 Windows 也完全没问题。
聊天工具怎么选?
- 国内用户:推荐飞书,API 完善、消息稳定、免费版够用
- 海外用户:推荐 Telegram,Bot 生态最强、功能最全
当然,企业微信、钉钉、QQ 也都支持,只是配置稍微麻烦一点。
硬件要求
别担心,OpenClaw 本身不吃配置,AI 推理都是云端完成的:
- CPU:正常能用就行
- 内存:8GB 起步(推荐 16GB)
- 硬盘:留 10GB 空间
- 网络:能上网就行(需要调 API 嘛)
Mac 安装教程
Mac 上装 OpenClaw 是最省心的,基本上一行命令搞定。
第一步:打开终端
按 Command + 空格,输入 Terminal,回车,终端就出来了。
如果你用 iTerm2 之类的第三方终端也完全 OK。
第二步:一键安装
在终端里粘贴这行命令,回车:
curl -fsSL https://openclaw.ai/install.sh | bash
这个脚本会自动帮你:
- 检测系统环境
- 安装 Node.js(如果你没装的话)
- 下载 OpenClaw
- 配好环境变量
整个过程大概 2-5 分钟,泡杯咖啡的功夫就好了。
第三步:确认装好了
openclaw --version
如果终端输出了版本号(比如 2026.2.9),恭喜你,装好了。
第四步:初始化配置
这一步是重头戏,运行配置向导:
openclaw onboard
向导会一步步问你以下内容:
1. 接受风险提示 —— 选 Yes,放心往下走。
2. 选择启动模式 —— 推荐选 QuickStart,省事。
3. 选择 AI 模型 —— 这里划重点:
新手怕麻烦的话,直接选 qwen(通义千问)就行! 选了之后会自动跳转到 Qwen 的登录页面,授权一下就完事了,不需要自己去申请什么 API Key。这是最省心的方式,适合想赶紧用起来的同学。
不过要注意:Qwen 免费额度每天问答次数有限,超了之后机器人会提示你。如果你用得比较频繁,还是建议后面配一个自己的 API Key。
想自己配 Key 的话,国内推荐这几个:
| 模型 | 特点 | 适合场景 |
|---|---|---|
| DeepSeek | 性价比之王,推理强 | 日常对话、代码生成 |
| Kimi | 200 万字超长上下文 | 长文档分析 |
| 智谱 GLM | 中文理解好 | 中文内容创作 |
提醒一句:不管你选哪个平台,AI 对话都是要消耗 token 的,聊得越多花得越多。尤其是发长文、传文件、搞分析这种,token 消耗会很快。建议平时关注一下用量,别月底收到账单吓一跳。
4. 输入 API Key(选了 Qwen 的可以跳过这步) —— 去对应模型的官网申请,复制粘贴进去就行。
5. 选择聊天工具 —— 飞书、Telegram 或者先选 None 跳过(后面随时能配)。
6. Gateway 端口 —— 默认 18789,直接回车跳过。
7. 选择 Skills —— 用空格键勾选你需要的技能包,不确定的话直接跳过。
8. 启用 Hooks —— 建议启用,用于内容引导、日志和会话记录。
配置完成后,OpenClaw 会自动启动 Gateway 服务。
第五步:验证运行
openclaw channels status
看到 Gateway reachable. 就说明一切正常。
打开浏览器访问 http://127.0.0.1:18789/chat,就能看到 Web 聊天界面了。
六、OpenClaw技能扩展与常用命令
(一)技能插件安装(扩展功能)
OpenClaw默认功能有限,通过ClawHub技能市场可安装上千种插件,推荐以下高频实用技能:
# 1. 安装ClawHub技能管理工具
npx clawhub install clawhub
# 2. 安装常用技能(直接复制批量执行)
# 文件管理核心技能
npx clawhub install filesystem-mcp
# PDF编辑(合并、拆分、内容提取)
npx clawhub install nano-pdf
# 飞书文档同步
npx clawhub install feishu-docs
# 语音转文字(基于OpenAI-Whisper)
npx clawhub install openai-whisper
# 日历管理(对接Mac日历)
npx clawhub install calendar
# 终端命令执行(通过自然语言执行终端命令)
npx clawhub install terminal-exec
# 3. 重启服务使技能生效
openclaw gateway restart
(二)常用命令速查
# 启动网关服务
openclaw gateway start
# 停止网关服务
openclaw gateway stop
# 查看运行状态
openclaw status
# 健康检查(排查问题)
openclaw health
# 更新OpenClaw到最新版本
openclaw update
# 诊断问题
openclaw doctor
# 卸载OpenClaw
openclaw uninstall
# 重新进入配置向导
openclaw onboard
七、常见问题排查
(一)Mac本地部署常见问题
-
安装时提示「Permission denied」:
- 原因:权限不足,未使用sudo命令;
- 解决方案:重新执行安装命令,前缀加上sudo,输入开机密码即可。
- 初始化向导无法连接Kimi:
- 原因:API Key错误或网络问题;
- 解决方案:重新创建Kimi API Key,确保无空格或拼写错误;检查网络是否能访问GitHub。
- 飞书机器人无响应:
- 原因:事件订阅未配置或插件未安装成功;
- 解决方案:重新检查飞书事件订阅配置,确保4个核心事件已添加;重新安装飞书插件:
openclaw plugins reinstall @m1heng-clawd/feishu。
1 条评论