管理员
Published on 2026-03-12 / 12 Visits
0
0

OpenClaw 专属部署与实战教程 (Mac 通用版:支持 M 系列与 Intel 老设备)

#PC


首先是硅基流动注册:https://cloud.siliconflow.cn/i/R9lJjxZy,本期教程需要用到,可以先注册,本注册码可以获得新人token赠送。(有同学反映年后只注册不赠送14块了,需要实名认证可赠送16元,或者充点,不然后面会报错403!

如果不想玩了,彻底卸载Openclaw(Mac专用),如果不想玩了,或者是装错了全部重头再来的话看这篇!可以卸载

这里是一些评论区常见问题(还在更新,等我睡醒):Openclaw安装中的一些常见问题,这里是视频讲解:【Mac装龙虾必看!OpenClaw本地部署8个致命报错全解决】 https://www.bilibili.com/video/BV1iHPbzvEqJ/?share_source=copy_web&vd_source=334326fdaf4bb43135f9ac1ecc9239e0

关于云端部署本地部署的选择:

如果为了长期重度使用,调出适合自己的Openclaw,一定要选择本地

我也出了视频,链接如下:【OpenClaw (龙虾) 本地部署还是租云端?一人公司与小白新手的防坑指南】 https://www.bilibili.com/video/BV1b9N3zCENy/?share_source=copy_web&vd_source=334326fdaf4bb43135f9ac1ecc9239e0

本教程建议配合视频观看:【OpenClaw本地部署保姆级教程,新手小白龙虾安装指南】 https://www.bilibili.com/video/BV1o1AZzmEz7/?share_source=copy_web&vd_source=334326fdaf4bb43135f9ac1ecc9239e0

Windows版本

安装教程在这里:WIN版本的openclaw安装(不推荐)

作为一人公司,我们选择基础设施的核心标准是:省心、安全、零成本长待机。在部署 OpenClaw 这类本地 AI Agent 时,不同平台的体验有着天壤之别:

首选 :Mac (支持最新 M 系列与 Intel 老款系统):这是天生的 AI 工作站。

  1. 无论新老,一视同仁:因为本教程接入的是硅基流动(云端 API),所有繁重的 AI 推理(如总结、清洗数据)都在云端完成。目前我手上有两台Mac设备,老款 Intel MacBook (macOS 12) 与新的 M4 Mac mini 在这里的运行逻辑完全一致,只负责轻量的文本转发,老设备也绝不会卡顿或严重发热,并且安装过程完全一样。(我就是在Macbook上试安装后,写好此篇教程才到Mac mini上安装的。)所以哪怕为了整理整理文件感受Openclaw的魅力,也完全可以买一台二手千元以内的Mac,一样用。

  2. 系统级稳定与能效:Mac mini拥有极低的待机功耗,让它 24 小时开机也几乎不费电费,完美契合“数字员工”的长待机定位。

  3. 工作流闭环:macOS 底层是纯正的类 Unix 系统,完美兼容各种极客工具,且能直接、实时地读写你的本地工作目录,与你前台的 Claude Code 完美交接文件,没有网络同步的延迟和断层。

次选:云服务器 (Linux):纯正的生产环境,网络极佳,极其稳定。

  1. 优点:现在很多厂商买个小服务器都有新人优惠,99一年适合部署的服务器很多。并且服务器一般也使用类 Unix 系统,方便openclaw的各种扩展功能。另外比如阿里云、腾讯云都已经原生带了openclaw一键部署的功能和服务,小白上手也很简单,研究不明白还能直接发送工单问他们的客服,社群同学有人实测问这类部署问题也会有专人解答(阿里云)。

  2. 优点之2:我把比如KimiClaw、Minimax的MaxClaw或者Coze的Openclaw也归类到这里,也是方便简单易上手,感受一下玩玩完全没问题,并且价格也算合适,比如Coze是49单月的高级版可以有。

  3. 缺点在于:云端服务器不仅需要持续按月付费,更要命的是,云端与你本地电脑的文件夹(内容工厂)存在物理隔离,需要复杂的同步机制(如 Syncthing)才能打通本地工作流,平白增加了维护成本,所以如果希望创建本地内容工厂或者其他操作,基本可行性不大,况且服务器的带宽通常也就是个基础的2M,堪忧。并且由于服务器本身性能问题,使得分级调用大模型节约token不可能,因为有些任务可以使用脚本跑,有些可以数据清理的工作可以交给本地大模型,这些都可能出现问题。

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

windows上安装必须使用WSL2。虽然有 WSL2 加持,但文件系统路径(\ 与 / 的冲突)、Node.js 环境的各种疑难杂症,以及较高的整机常驻运行功耗,往往会在后期无谓地消耗你极其宝贵的创作精力。

下面,我们将正式开始在这台 Mac 上,部署你的第一位数字员工。

一、 环境准备 (Node.js)

OpenClaw 依赖 Node.js 运行,并且要求较新的版本。

  1. 打开 Mac 终端(Terminal)。

  2. 输入以下命令检查当前版本:

node -v

判断标准:如果返回结果是 v22.x.x 或以上,请直接进入第二步。如果报错或版本低于 22,请前往 Node.js 官网 (nodejs.org) 下载并安装最新的 LTS(长期维护)版本。

当然也可以使用以下命令行来完成

按顺序执行以下三步:

第一步:清空 npm 缓存(防止历史依赖冲突)

Bash

npm cache clean -f

第二步:安装名为 n 的版本管理神器

Bash

sudo npm install -g n

(输入这行后会提示输入你的 Mac 锁屏密码,输完回车即可。)

第三步:一键安装最新的 LTS(长期支持)版本

Bash

sudo n lts

(这段命令跑完后,它会自动帮你下载并覆盖安装 Node.js 最新的稳定版(比如 v22.x),这是目前兼容性最好的版本。)

二、 核心程序安装

我们将使用 npm(Node.js 的包管理器)将 OpenClaw 全局安装到你的 Mac 系统中。

  1. 在终端中输入安装命令(带 sudo 获取管理员权限):

sudo npm install -g openclaw@latest
  1. 按下回车后,系统会提示输入密码(输入你 Mac 电脑的开机/锁屏密码,输入时屏幕不会显示字符,输完直接回车即可)。

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

三、 初始化与大模型接入

这一步将激活 OpenClaw,并为它装上大脑(大模型)和设定工作边界。本教程推荐接入国内极具性价比的硅基流动 (SiliconFlow) 平台提供的 DeepSeek 模型。

  1. 我们要按照下边方法先设置npm权限(当然如果你使用了我前边发过的安装Claude code教程,就不存在这个问题了):

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

  2. 运行初始化与守护进程安装命令:

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

这个路径有几个劣势:

  1. 看不见在 Mac 和 Linux 系统中,凡是以 . 开头的文件夹都是隐藏文件夹。 如果你用了默认路径,OpenClaw 以后抓取的所有灵感、总结的新闻、生成的简报,都放到这里,平时打开访达无法直接看到,如果想要配合 Claude Code 去读取这些素材,或者想自己手动改改内容,还得折腾半天去显示隐藏文件,反人类。

  2. 我打算使用 OpenClaw 构建的是一个“内容工厂”。我希望能直观地看到处理流程:OpenClaw 把新鲜的素材扔进了 00_Inbox文件夹,然后 Claude Code 从里面把素材拿走,加工完放到 该放的地方,由Claude Code主导。 因此我选择把工作区设置在可以随意浏览的普通文件夹中(比如 /Documents/云途AGI/00_OpenClaw_Inbox)里,AI 干了什么活,打开看一眼就清清楚楚。

  3. 安全隔离。也千万不能直接把 Workspace 设成你的整个文档根目录(比如 /Users/用户名/Documents),除非真的想给他完全很大的权限。万一哪天大模型“抽风”或者指令理解错误,它可能会把你几年积累的核心资产瞬间清空。 

  1. 接下来就是选择大模型:

    1. 首先是硅基流动注册:https://cloud.siliconflow.cn/i/R9lJjxZy,本期教程需要用到,可以先注册,本注册码可以获得新人16块代金券赠送,记得手动领取。

    2. 往下翻页:选择 Custom Provider

    3. Base URL (接口地址):

      • 填写硅基流动官方接口:https://api.siliconflow.cn/v1

    4. API Key (鉴权秘钥):

      • 填入你在硅基流动平台生成的真实 API Key(格式如:sk-xxxxxx

    5. Endpoint compatibility (接口类型):

      • 选择第一项:OpenAI-compatible

    6. Model ID(模型名称):

      • 填写想要用的,我这里使用deepseek-ai/DeepSeek-V3.2

    7. 然后Endpoint ID意思是给模型取个别名,是可选的,直接回车就可以,当然你也可以设置。

    8. Gateway port(端口号):

      • 也就是龙虾使用的端口号,他会默认给一个,记住这个,用来登录比如18789

      • 登录网址就是http://localhost:18789

    9. Gateway bind(网关绑定):、

      • 选择默认的第一项Loopback,因为平常我会挂着代理使用,就算使用其他设备也是通过飞书和他交流不会直接局域网访问此网址,防止冲突所以这么选择,大家也这么选择就可以。

    10. Gateway Auth(网关验证方式):

      • 推荐使用Password也就是密码验证。不然选个token自己存了也忘了存哪里,不如密码简单实用。

    11. Tailscale exposure(内网穿透设置):

      • 咱既然使用飞书了,就直接关闭,选择默认的off就行。

    12. 最后一步就是让你输入密码,输入后回车,OpenClaw基本设置就完成了!

四、 接入通讯网关 (绑定飞书)

为了让你能在外面随时随地用手机给家里的 Mac 发指令,我们将 OpenClaw 接入国内极其好用的生产力平台——飞书 (Feishu)。

为什么为国内的大家推荐飞书,而不是飞机?

在通讯网关的选择上,很多开源项目首选 Telegram。但对于身处国内的“一人公司”架构,飞书是目前的绝对最优解:

  1. 国内直连,极致稳定:不需要折腾复杂的网络代理规则。Telegram Bot 经常会因为本地代理断流而导致 AI 失联,而飞书随时随地秒回,绝不掉线。

  2. API 额度“量大管饱”:飞书针对自建应用的免费 API 调用次数近期大幅提升(高达 100 万次/月)。就算你让 AI 一天到晚高强度处理信息,也根本触碰不到限制天花板,彻底告别额度焦虑。

  3. 原生富文本与 Markdown 支持:内容工厂经常会产出带标题、列表的结构化简报。飞书机器人完美支持 Markdown 甚至直接传输文件,AI 发给你的报告排版极佳,阅读体验完爆普通聊天软件。

  4. 工作与生活物理隔离:把 AI 助理放在飞书里,能让你在刷微信朋友圈时不受工作打扰,保持极度专注的“数字办公环境”。

具体绑定步骤:

  1. 选择 Channel:在向导中选择 Feishu 。

  2. 回车后选择Install Feishu plugin,大部分人直接选择Download from npm会出现mpm的权限报错!所以一定要完成第三节中的步骤1,也就是npm权限这个事!

  3. 获取飞书应用凭证:

    1. 电脑浏览器访问 飞书开放平台 (open.feishu.cn),使用你的飞书账号登录。

    2. 点击进入“开发者后台”,点击“创建企业自建应用”,给你的数字员工起个名字(比如 云途AI助理)并上传一个帅气的头像。

    3. 飞书机器人的设置

    4. 在左侧菜单点击“添加应用能力”,开启“机器人”功能。

      1. (注:如果 OpenClaw 要求配置回调地址,请在左侧“事件订阅”中填入终端生成的 Webhook 地址,并发布应用版本。)

      2.    然后在左侧的权限管理出,点击开通权限:

      3. 搜索p2p,出现两个权限全部开启。

      4. 然后搜索message,选择获取消息发送消息以及获取与发送单聊、群组消息开启。

      5. 最后搜索resource,选择获取与上传图片或文件资源,这样以后切换有图像识别或者视频识别能力的模型就都可以读取了,

    5. (这个很关键,否则出来的机器人没有对话框)

    6. 在左侧事件与回调中(在配置完Openclaw的剩余配置如步骤五以后,后返回来配置这项,就不会出现链接失败了!然后再进行步骤六,否则机器人没有聊天框。

      1. 订阅方式选择使用长链接接收事件

      2. 点击添加事件,搜索im.message,全选上点击开通,

    7. 点击上方的发布版本(不发布无法使用)。

    8. 进入应用详情页,在左侧菜单找到“凭证与基础信息”,你将看到两个关键字符串:App ID 和 App Secret,并把这两个信息输入openclaw。

    9. 然后再Group chat policy中选择Disabled,也就是1对1单聊(禁用群聊模式)。剩下两个分别是Open开放式和Allowlist白名单模式。

    10. 接下来会出现DM信息,选择yes然后选择Pairing,这是让你的飞书和他配对

  4. 填入向导:将获取到的 App ID 和 App Secret 复制并粘贴到 Mac 终端的向导对应位置,完成身份绑定。

五、 为你的OpenClaw安装skills以及hooks

接下来会出现Skills status板块以及Hooks板块,也就是为你的龙虾安装技能包以及hooks。

  1. 这节课太长了我们,skills板块直接选择No,后边再讲怎么安装skill。

  2. 以及hooks,我们今天也选择Skip for now跳过,这些都可以后补,因为是个需要个性化的事情。

  3. Gateway service runtime:选择Node,比较稳定(飞书也只有这个可选),whatsapp和telegram可以选择bun。

六、最终测试!

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

  1. Hatch in TUI(我平常使用选这个)

  2. Open the web UI(演示的时候我选这个,在网页端打开)

然后会自动打开一个网页,并且终端窗口显示问题Enable zsh shell xxx,选择yes。

稍等片刻,在飞书中已经可以对话!

当你第一次给机器人发消息,它回复了一串 Pairing code 时: 不要在飞书里回复代码回到 Mac 终端,输入审批命令(以代码 WB4GRFXM 为例):

openclaw pairing approve feishu WB4GRFXM 

🎉 至此,OpenClaw 专属部署全部完成!

额外安全性配置(可选,因人而异): 注入“Append-Only”安全协议

配置完成后,我们要给它打上最高级别的安全规则,防止它误删文件。

  1. 打开 OpenClaw 的设定文件(通常位于 ~/.openclaw/SOUL.md,或者你可以通过它的 Web 面板进入设置页)。

  2. 在 System Prompt 或 Role 描述的开头,强行写入以下内容:

【系统最高指令:收发室协议】

你是一个运行在本地 Mac 上的自动化智能体。你的工作区被严格限制在 Inbox 文件夹内。

在进行任何文件操作时,必须 100% 遵守“只增不减(Append-Only)”原则:

  1. 严禁删除:绝对不允许使用 rm 或 delete 等命令。

  2. 严禁覆盖历史:写入新灵感时,必须且只能使用追加模式(Append)写在文件最末尾,绝不允许修改原有文字。

  3. 新建命名:生成新简报必须带时间戳,例如 简报_YYYYMMDD_HHMM.md

常用管理命令

既然 OpenClaw 成为了后台服务,这里提供几个日后维护常用的命令,请务必收藏:

  • 查看运行状态:

openclaw status
  • 查看实时日志 (排错必备,看看它在后台干嘛):

openclaw logs -f
  • 暂停服务 (修改了配置或卡死时):

launchctl stop ai.openclaw.gateway
  • 重新打开服务:

launchctl start ai.openclaw.gateway

最后


Comment