Mac Studio 安装 OpenClaw 多实例共存实录

最近在研究多 Agent 编排,本机已经跑着 copaw。今天心血来潮,决定把底层的 openclaw 单独拎出来跑个 UI 界面看看。

做个记录,备忘。

1. Opencode 辅助安装:一场优雅的权限绕过

为了省事,我直接唤醒了终端里的 AI 助手(Opencode,挂的 MiniMax 模型)帮我装。AI 的排错逻辑挺有意思:

  1. 它首先尝试了官方的无脑脚本:curl -fsSL https://openclaw.ai/install.sh | bash
  2. 发现走不通,立刻切成了全局 NPM 安装:npm install -g openclaw@latest
  3. 随后触发了经典报错:/usr/local/bin/openclaw 文件已存在,引发软链接冲突。
  4. 它的第一反应是 sudo rm 强删,但被系统的交互式密码输入卡住了(终端里的 AI 无法直接帮你输密码)。
  5. 接着它立刻放弃提权,直接用普通权限 rm -f /usr/local/bin/openclaw && npm install -g openclaw@latest。因为我当前账户对该目录有写权限,直接物理抹除并重新接管成功。

最终拿到了 OpenClaw 2026.3.28 版本。AI 时代,连写环境配置都变成了一种结对编程。

image-20260330下午31734247

image-20260330下午31826704

image-20260330下午31858691

image-20260330下午32135388

image-20260330下午32433093

2. 端口冲突

装完后,按常规流程初始化:

openclaw setup
openclaw gateway

结果直接吃了个闭门羹:日志提示 pid 539 kelu: openclaw-gateway (*:18789)。18789 端口已经被占用了。

因为我本机还在跑着 copaw,copaw 也是将 OpenClaw 作为底层通信引擎,早就已经在后台静默拉起了一个 Gateway 守护进程,用了 18789 端口和默认的 ~/.openclaw 工作区。

3. 开启 Dev 沙盒模式

我想同时保留 copaw 的运行状态,又想自己独立玩 OpenClaw 的 Dashboard。既然不能同归于尽,那就只能物理隔离。

OpenClaw 官方提供了一个 --dev 参数,可以解决了多实例共存的问题。

启动独立网关:

openclaw --dev gateway

这行命令直接开辟了一个平行宇宙:

  • 配置文件被隔离到了 ~/.openclaw-dev/openclaw.json
  • 数据工作区被重定向到了 ~/.openclaw/workspace-dev
  • 网关端口自动偏移到了 19001
  • 甚至连局域网的 Bonjour 广播名字,都聪明地加上了后缀 kelu的Mac Studio (OpenClaw) (2) 以防冲突

image-20260330下午30028713

4. 唤醒 UI 控制台

后台引擎在 19001 端口平稳怠速后,新开一个终端页,带上 dev 参数直连:

openclaw --dev dashboard

浏览器瞬间弹出。虽然目前版本的 Web UI 纯英文,没有任何 zh-CN 的汉化选项,但这并不妨碍。

image-20260401上午95833705


清理 Docker 残留网络:解决 ifconfig 中陌生的网桥接口 Mac 上安装 OrbStack 替代 Docker Desktop