Day 2 / 7

第2天：安装配置OpenClaw

Mac系统专属教程 - 手把手搭建你的AI助手

📖 阅读时间：约20分钟🎯 难度：入门
学习进度2/7

📚 今天你将学到

  • •为什么推荐Mac系统部署OpenClaw
  • •Node.js环境准备和版本管理
  • •一行命令安装OpenClaw核心程序
  • •接入硅基流动API（DeepSeek模型）
  • •配置飞书通信网关，实现随时随地对话
  • •常见问题排查和解决方案

作为一人公司，我们选择基础设施的核心标准是：省心、安全、零成本长待机。今天我会手把手教你在Mac上部署OpenClaw，并接入国内最稳定的飞书通信网关。

整个过程不超过30分钟，跟着步骤走就行。

为什么极力推荐Mac部署？

在部署OpenClaw这类本地AI Agent时，不同平台的体验有着天壤之别。让我直接说结论：

✅ 首选：Mac（支持M系列与Intel老款）

这是天生的AI工作站。无论新老，一视同仁。

  • • 老设备也能用：因为接入的是硅基流动（云端API），所有AI推理都在云端完成。老款Intel MacBook和新的M4 Mac mini运行逻辑完全一致，只负责轻量的文本转发，绝不会卡顿或发热
  • • 系统级稳定：Mac mini极低的待机功耗，24小时开机也几乎不费电，完美契合"数字员工"的长待机定位
  • • 工作流闭环：macOS底层是纯正的类Unix系统，完美兼容各种极客工具，能直接读写本地工作目录，与Claude Code完美交接文件

⚠️ 次选：云服务器（Linux）

纯正的生产环境，网络极佳，极其稳定。

优点：

  • • 很多厂商有新人优惠，99元/年就能部署
  • • 阿里云、腾讯云已原生支持OpenClaw一键部署
  • • 有问题可以直接发工单问客服

缺点：

  • • 需要持续按月付费
  • • 云端与本地文件夹存在物理隔离，需要复杂的同步机制
  • • 服务器带宽通常只有2M，堪忧
  • • 无法使用本地大模型节约token

❌ 不推荐：Windows

不推荐给非技术狂热爱好者。完全没必要，哪怕是玩玩也推荐上一种。

  • • 必须使用WSL2，配置复杂
  • • 文件系统路径冲突（\\ 与 / 的问题）
  • • Node.js环境各种疑难杂症
  • • 整机常驻运行功耗高

💡 我的建议：如果你是Mac用户，直接按本教程操作。如果你是Windows用户，建议买一台二手千元以内的Mac，一样能用。

第一步：环境准备（Node.js）

OpenClaw依赖Node.js运行，并且要求较新的版本（v22.x或以上）。

检查当前版本

打开Mac终端（Terminal），输入以下命令：

node -v

判断标准：

  • 如果返回 v22.x.x 或以上，直接进入第二步
  • 如果报错或版本低于22，继续下面的安装步骤

安装/升级Node.js

按顺序执行以下三步：

第一步：清空npm缓存

防止历史依赖冲突

npm cache clean -f

第二步：安装版本管理工具n

输入后会提示输入Mac锁屏密码，输完回车即可

sudo npm install -g n

第三步：安装最新LTS版本

自动下载并安装Node.js最新稳定版（v22.x）

sudo n lts

安装完成后，再次验证版本：

node -v
# 应该显示：v22.x.x 或更高

第二步：安装OpenClaw核心程序

环境准备好后，我们使用npm将OpenClaw全局安装到Mac系统中。

设置npm权限

先设置npm权限，避免后续安装出现权限问题：

sudo chown -R $(whoami) ~/.npm

执行安装命令

在终端中输入安装命令（带sudo获取管理员权限）：

sudo npm install -g openclaw@latest

按下回车后，系统会提示输入密码（输入Mac的开机/锁屏密码，输入时屏幕不会显示字符，输完直接回车即可）。

等待代码雨跑完，直到出现类似 added xxx packages 的成功提示。

第三步：初始化与接入大模型

这一步将激活OpenClaw，并为它装上大脑（大模型）。本教程推荐接入国内极具性价比的硅基流动平台提供的DeepSeek模型。

注册硅基流动

首先注册硅基流动账号：

访问：https://cloud.siliconflow.cn

注册后获取API Key（格式如：sk-xxxxxx）

⚠️ 注意：新用户需要充值一点金额（建议10元起），否则后续会报403错误

运行初始化命令

运行初始化与守护进程安装命令：

openclaw onboard --install-daemon

💡 重要：--install-daemon 参数极其重要，它能确保OpenClaw在你关闭终端窗口，甚至Mac重启后，依然在后台默默运行。

配置向导

接下来会进入交互式配置向导，按照以下步骤操作：

问题1：Onboarding mode

选择：Manual（手动）

这样才能自己配置硅基流动的API

问题2：What do you want to set up

选择：Local gateway (info-only)

问题3：工作区路径

默认路径：/Users/你的用户名/.openclaw/workspace

⚠️ 不推荐使用默认路径，原因：

  • • 以 . 开头的文件夹是隐藏文件夹，访达无法直接看到
  • • 不方便与Claude Code配合使用
  • • 查看AI处理的文件很麻烦

推荐路径：

/Users/你的用户名/Documents/云途AGI/00_OpenClaw_Inbox

这样可以直观地看到OpenClaw的工作内容，方便与Claude Code协作

⚠️ 千万不要直接设成整个文档根目录（如 /Documents），万一大模型"抽风"可能会清空你的核心资产

问题4：选择大模型

选择：Custom Provider

然后填写以下信息：

  • Base URL：
    https://api.siliconflow.cn/v1
  • API Key：
    sk-xxxxxx（你的硅基流动API Key）
  • Endpoint compatibility：
    OpenAI-compatible
  • Model ID：
    deepseek-ai/DeepSeek-V3.2
  • Endpoint ID：
    可选，直接回车跳过

问题5：Gateway配置

  • Gateway port（端口号）：
    默认会给一个（如18789），记住这个端口号
    登录网址：http://localhost:18789
  • Gateway bind：
    选择 Loopback（默认第一项）
  • Gateway Auth：
    推荐 Password（密码验证）
  • Tailscale exposure：
    选择 off（关闭内网穿透）

最后一步输入密码，回车后OpenClaw基本设置就完成了！

第四步：接入飞书通信网关

为了能在外面随时随地用手机给家里的Mac发指令，我们将OpenClaw接入飞书。

为什么推荐飞书而不是Telegram？

  • • 国内直连，极致稳定：不需要折腾网络代理，随时随地秒回，绝不掉线
  • • API额度量大管饱：免费API调用高达100万次/月，根本触碰不到限制
  • • 原生Markdown支持：AI发给你的报告排版极佳，阅读体验完爆普通聊天软件
  • • 工作与生活物理隔离：把AI助理放在飞书里，刷微信时不受工作打扰

创建飞书应用

按照以下步骤创建飞书机器人：

步骤1：创建应用

  1. 1. 访问 飞书开放平台，使用飞书账号登录
  2. 2. 点击"开发者后台" → "创建企业自建应用"
  3. 3. 给你的数字员工起个名字（如：云途AI助理）并上传头像

步骤2：开启机器人功能

  1. 1. 在左侧菜单点击"添加应用能力" → 开启"机器人"功能

步骤3：开通权限

在左侧"权限管理"中，开通以下权限：

  • • 搜索 p2p：两个权限全部开启
  • • 搜索 message：选择"获取消息"、"发送消息"、"获取与发送单聊、群组消息"
  • • 搜索 resource：选择"获取与上传图片或文件资源"

⚠️ 这个很关键，否则机器人没有对话框

步骤4：配置事件订阅（重要！）

⚠️ 这一步要在完成OpenClaw的剩余配置后再返回来做，否则会链接失败

  1. 1. 在左侧"事件与回调"中
  2. 2. 订阅方式选择：使用长链接接收事件
  3. 3. 点击"添加事件"，搜索 im.message，全选并开通
  4. 4. 点击上方的"发布版本"（不发布无法使用）

步骤5：获取凭证

  1. 1. 在左侧菜单找到"凭证与基础信息"
  2. 2. 复制 App ID 和 App Secret
  3. 3. 这两个信息待会要输入到OpenClaw配置中

在OpenClaw中配置飞书

回到OpenClaw配置向导：

选择Channel：选择 Feishu

安装插件：选择 Install Feishu plugin

⚠️ 大部分人选择"Download from npm"会出现权限报错，所以要先完成第三步中的npm权限设置

填入凭证：

  • • 将获取到的 App ID 和 App Secret 复制粘贴到终端

Group chat policy：选择 Disabled（1对1单聊，禁用群聊模式）

DM信息：选择 yes 然后选择 Pairing

这是让你的飞书和OpenClaw配对

第五步：Skills和Hooks配置

接下来会出现Skills和Hooks配置板块。

  • • Skills status：选择 No（后续课程会讲如何安装skill）
  • • Hooks：选择 Skip for now（跳过，这些都可以后补）
  • • Gateway service runtime：选择 Node（比较稳定）

第六步：最终测试！

到这里会出现问题：How do you want to hatch your bot?

选择启动方式：

  • • Hatch in TUI：终端界面（日常使用推荐）
  • • Open the web UI：网页端（演示时推荐）

Enable zsh shell：选择 yes

稍等片刻，在飞书中已经可以对话！

配对验证

当你第一次给机器人发消息，它回复了一串Pairing code时：

⚠️ 不要在飞书里回复代码！

回到Mac终端，输入审批命令（以代码 WB4GRFXM 为例）：

openclaw pairing approve feishu WB4GRFXM

🎉 至此，OpenClaw专属部署全部完成！

现在你可以在飞书中随时随地与你的AI助手对话了。

常见问题排查

安装过程中可能遇到的问题和解决方案：

给飞书发消息，回复403报错？

原因：硅基流动没有充值

解决：充值一点金额就好（建议10元起）。年前注册还送14块，现在这个活动没有了，需要充值才能跑通。

大模型连接时fetch failed？

症状：连接大模型时报网络错误

解决：使用以下命令重新启动，可以绕过所有网络拦截和DNS解析问题：

env NODE_TLS_REJECT_UNAUTHORIZED=0 NODE_OPTIONS="--dns-result-order=ipv4first" openclaw onboard --install-daemon

这行命令包含三个部分：

  • • NODE_TLS_REJECT_UNAUTHORIZED=0 - 防止代理软件拦截SSL证书
  • • NODE_OPTIONS="--dns-result-order=ipv4first" - 禁止使用ipv6
  • • openclaw onboard --install-daemon - 正常初始化
没有对本机文件的读写权限？

解决：打开配置文件修改权限设置

open ~/.openclaw/openclaw.json

找到以下部分，改成这样：

"tools": {
  "profile": "full"
}

保存后重启OpenClaw：

launchctl stop ai.openclaw.gateway
launchctl start ai.openclaw.gateway
配置文件改废了怎么办？

解决：使用doctor命令自动修复

openclaw doctor --fix

它会全面扫描（检查Node版本、文件权限、配置格式等），并自动修复所有发现的底层错误。

GUI浏览器窗口密码输入对了还是显示离线？

原因：Safari浏览器的bug，导致密码验证失败

解决方案1（推荐）：换个浏览器打开（如Chrome）

解决方案2：改用token验证方式

open ~/.openclaw/openclaw.json

找到auth部分，改成：

"auth": {
  "mode": "token",
  "token": "你自己设定一个"
}

保存后重启，然后获取令牌化URL：

openclaw dashboard --no-open

会返回一个带token的网址，复制这个网址打开即可

在设置通讯工具界面一直循环？

解决：设置完一次不要再选飞书了，选择 Finished（当然你可以再添加其他通讯工具）

飞书的App ID和Secret填反了怎么办？

解决：连不上会让你重新配置，或者手动修改配置文件

open ~/.openclaw/openclaw.json

找到feishu部分，手动更改即可

常用管理命令

OpenClaw成为后台服务后，这些命令会经常用到：

查看运行状态

openclaw status

查看实时日志（排错必备）

openclaw logs -f

暂停服务

修改了配置或卡死时使用

launchctl stop ai.openclaw.gateway

重新启动服务

launchctl start ai.openclaw.gateway

打开Web管理界面

openclaw dashboard

💡 本章要点回顾

  • • Mac是部署OpenClaw的最佳平台，老款Intel设备也能流畅运行
  • • 推荐使用飞书+硅基流动API的组合，国内直连稳定
  • • 工作区路径不要用隐藏文件夹，方便与Claude Code协作
  • • 遇到问题先用openclaw doctor --fix自动修复
  • • 配对验证要在终端执行，不要在飞书里回复代码

✅ 今日任务

完成OpenClaw的安装和配置，并在飞书中完成第一次对话。建议尝试：

  • • 让AI介绍自己的能力
  • • 问一个简单的问题，测试响应速度
  • • 让AI在工作区创建一个测试文件
  • • 观察AI的回复质量和Markdown排版

明天我们会教你如何给AI"赋予灵魂"，让它有个性、懂你的习惯。

本章一句话Q&A

为什么不推荐Windows安装？

Windows必须使用WSL2，文件系统路径冲突、Node.js环境问题多、整机功耗高。即使是玩玩，也推荐买台二手Mac或用云服务器。

老款Intel Mac能用吗？

完全可以！因为接入的是云端API（硅基流动），所有AI推理都在云端完成，Mac只负责轻量的文本转发，老设备也不会卡顿。

硅基流动要充多少钱？

建议充值10元起。DeepSeek模型非常便宜，10元可以用很久。不充值会报403错误。

为什么推荐飞书而不是Telegram？

飞书国内直连稳定、API额度高达100万次/月、原生支持Markdown、工作生活物理隔离。Telegram需要代理，经常掉线。

工作区路径怎么选？

不要用默认的隐藏文件夹（~/.openclaw/workspace），推荐用可见路径如 ~/Documents/云途AGI/00_OpenClaw_Inbox，方便查看和与Claude Code协作。千万不要设成整个Documents目录。

Mac重启后OpenClaw还在运行吗？

是的！使用--install-daemon参数安装后，OpenClaw会作为系统服务自动启动，Mac重启后也会自动运行。

如何卸载OpenClaw？

运行：launchctl stop ai.openclaw.gateway 停止服务，然后 sudo npm uninstall -g openclaw 卸载程序，最后删除 ~/.openclaw 文件夹即可。

📅 下一章预告

Day 3：赋予灵魂

现在你的AI助手还是"通用版"，和所有人的AI一样。明天我们会教你如何编写身份文件（SOUL.md），让AI有个性、懂你的习惯、说你喜欢的话。这是OpenClaw最有趣的部分。

← 上一篇：初识OpenClaw下一篇：赋予灵魂→

遇到问题？

加入云途AGI社群，获取配套学习资源、群内答疑，与同学们一起交流进步

了解社群详情