
最近在研究多 Agent 编排,本机已经跑着 copaw。今天心血来潮,决定把底层的 openclaw 单独拎出来跑个 UI 界面看看。
做个记录,备忘。
1. Opencode 辅助安装:一场优雅的权限绕过
为了省事,我直接唤醒了终端里的 AI 助手(Opencode,挂的 MiniMax 模型)帮我装。AI 的排错逻辑挺有意思:
- 它首先尝试了官方的无脑脚本:
curl -fsSL https://openclaw.ai/install.sh | bash。 - 发现走不通,立刻切成了全局 NPM 安装:
npm install -g openclaw@latest。 - 随后触发了经典报错:
/usr/local/bin/openclaw文件已存在,引发软链接冲突。 - 它的第一反应是
sudo rm强删,但被系统的交互式密码输入卡住了(终端里的 AI 无法直接帮你输密码)。 - 接着它立刻放弃提权,直接用普通权限
rm -f /usr/local/bin/openclaw && npm install -g openclaw@latest。因为我当前账户对该目录有写权限,直接物理抹除并重新接管成功。
最终拿到了 OpenClaw 2026.3.28 版本。AI 时代,连写环境配置都变成了一种结对编程。





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)以防冲突

4. 唤醒 UI 控制台
后台引擎在 19001 端口平稳怠速后,新开一个终端页,带上 dev 参数直连:
openclaw --dev dashboard
浏览器瞬间弹出。虽然目前版本的 Web UI 纯英文,没有任何 zh-CN 的汉化选项,但这并不妨碍。
