说实话，折腾开发环境有时候就像是在解谜，尤其是当你试图把一个强大的工具塞进Docker容器里的时候。Zui近，我就在Mac上尝试通过Docker来安装和配置OpenClaw，过程嘛，既充满了“原来如此”的顿悟，也夹杂着“怎么会这样”的抓狂。为了让大家少走弯路，我决定把这份从零开始的记录整理出来咱们一步步来别急，慢慢来。

一、 准备工作：构建你的Ubuntu容器

我们得有一个地方来跑我们的服务。既然是Docker，那肯定离不开镜像。我选择的是UbuntuZui新版，毕竟稳定且熟悉。这一步其实hen简单，但却是万丈高楼的地基。

拉取镜像

打开你的终端，不管是iTerm2还是系统自带的Terminal，输入下面的命令把镜像拉下来。网速快的话几秒钟就搞定，慢的话……嗯，不如先去倒杯水？

docker pull ubuntu:latest

创建并启动容器

镜像有了接下来就是创建容器。这里有个小细节要注意，我们需要映射端口，否则你在容器里跑得风生水起，外面却访问不了那不就成了自娱自乐了吗？虽然下面的命令里端口部分留空了让你自己填，但记得把宿主机的端口和容器内部的端口对应上。

docker run -it -p <宿主机端口>:<容器端口> --name openclaw ubuntu

执行完这行命令，你就直接进入容器的交互式界面了。那种瞬间穿越到另一个系统的感觉，是不是还挺奇妙的？

让容器在后台“隐身”运行

有时候我们不想一直挂着这个终端窗口，这时候就需要用到Docker的一个小技巧。先按 Ctrl+P，紧接着按 Ctrl+Q。这一套组合拳下来容器就会乖乖地在后台运行了而你回到了宿主机的怀抱。Ru果不放心，Ke以用 docker ps kankan它是不是还活着。

下次想进去找它玩，就用 docker attach openclaw，就像老朋友重逢一样简单。

二、 环境初始化：工欲善其事

刚进来的Ubuntu容器其实挺“干净”的，干净到连个 vim dou没有。这可不行，咱们得先武装一下。

geng新软件源

老规矩，第一步永远是geng新。别问为什么这是程序员的肌肉记忆。

apt-get update

安装必要工具

我们需要 curl 来下载脚本，需要 vim 来改配置，git 自然也是少不了的。顺手把 systemctl 也装上，虽然容器里一般不用systemd，但万一呢？

apt-get install -y curl vim git systemctl

三、 Node.js环境搭建：踩坑预警

OpenClaw是基于Node.js的，所以这一步至关重要。而且，这里有个大坑，我差点就没爬出来。

安装NVM和Node.js

直接装Node.js有时候版本管理起来hen麻烦，所以我推荐用NVM 。去 nodejs.org 官网kankan，或者直接用下面的脚本流。这是目前比较通用的安装方式，跟着敲命令就行，别手抖。

# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 让nvm生效，相当于重启了一下shell环境
\. "$HOME/.nvm/nvm.sh"
# 下载并安装你需要的Node.js版本：
nvm install 24
# 验证一下版本，别装了个寂寞
node -v 
npm -v

修复那个让人头秃的软链接问题

重点来了！敲黑板！我在安装Skills的时候遇到过这个错误，提示找不到 npm。查了一圈才发现，原来是NVM的软链接断了。NVM通常通过 ~/.nvm/current 指向当前激活的版本，但这个链接有时候会莫名其妙地缺失。

Gateway的PATH里明明包含了 /root/.nvm/current/bin，但因为链接不存在它就像个瞎子一样找不到npm。这时候，我们需要手动把这个链子接上。

# 记得把下面的 v24.x.x 替换成你实际安装的版本号
ln -s /root/.nvm/versions/node/v24.x.x /root/.nvm/current

这一步Zuo完，记得重启一下Gateway，不然它还是不知道路修好了。

四、 OpenClaw的安装与配置

环境好了主角终于该登场了。

全局安装

这一步Zui简单，一行命令搞定。记得加上 @latest，咱们要用Zui新的，不要老古董。

npm install -g openclaw@latest

初始化配置

安装完不是结束，只是开始。我们需要运行 onboard 命令来进行初始化配置。这个命令Ke以反复执行，所以第一次配错了也没关系，大不了重来。

openclaw onboard --install-daemon

修改配置文件：打通任督二脉

默认情况下OpenClaw的绑定模式是 loopback，也就是只有本地的“.”Neng访问。我们在宿主机里想访问它？门儿dou没有。所以我们需要动动刀子，改一下配置。

配置文件藏在这个位置：~/.openclaw/openclaw.json。拿出你的 vim，把它打开。

vim ~/.openclaw/openclaw.json

我们要把 gateway.bind 改成 lan，并且把 mode 设置为 local。这样它才允许局域网访问。大概长下面这样，别把JSON格式搞坏了逗号什么的douhen重要。

{
  "gateway": {
    "mode": "local",
    "bind": "lan",
    "port": 8080, 
    "auth": {
       "mode": "token",
       "token": "your-token" 
    },
  },
}

改完记得保存退出，然后重启网关服务让配置生效。

openclaw gateway restart

五、 运行与访问：见证奇迹的时刻

配置dou搞定了接下来就是启动Dashboard，kankan我们的劳动成果。

启动服务

输入这个命令，就像按下了发射按钮。

openclaw dashboard

在浏览器中打开

这时候终端里会输出一堆信息，其中Zui关键的就是那个URL。通常长这样：

Dashboard URL: http://0.0.0.0:8080/?token=yourtoken

因为我们在Docker启动时Zuo了端口映射，所以现在打开你宿主机上的浏览器，输入 http://localhost:宿主机映射端口/?token=yourtoken。Ru果一切顺利，你应该Nengkan到OpenClaw的控制界面了。

Ru果提示“No GUI detected”，那是因为它检测不到图形界面让你用SSH转发。不过咱们既然Zuo了端口映射，直接用上面的URL访问一般就没问题了。

六、 疑难杂症：那些年我踩过的坑

哪怕照着Zuo，有时候还是会遇到奇奇怪怪的问题。这里列几个我遇到的，希望Neng帮到你。

1. Pairing required

有时候你会kan到这个错误，相关的issue在GitHub上也Neng搜到。这通常是因为配对流程没走完，或者token不对。检查一下你的 openclaw.json 里的token设置，或者重新跑一遍onboard。

2. 修改Pending.json解决界面问题

Ru果网页上有些东西一直刷不出来或者状态不对，Ke以试着编辑 ~/.openclaw/devices/pending.json，把 silent 设置为 true。改完之后回到网页刷新一下说不定就好了。这招有时候挺玄学的，但确实管用。

3. NVM路径问题 强调

真的，Ru果遇到找不到npm或者node命令的问题，第一时间去检查 /root/.nvm/current 这个软链接是不是还在。不在了就重新建一个，这是解决此类问题的终极杀招。

七、 写在Zui后

整个流程走下来其实并不复杂，无非就是拉镜像、配环境、改配置、起服务。但正是这些琐碎的细节，往往Zui容易让人卡壳。希望这篇记录Neng帮你省去几个小时的抓狂时间。

Ru果你在操作过程中遇到了其他问题，或者觉得这篇文章对你有所帮助，请不吝点击关注一下我的微信公众号：FSA全栈行动 👋。这将是对我Zui大的激励。公众号里不仅有iOS技术，还有Android、Flutter、Python等各种干货，说不定就有你正想了解的技Neng点哦~ 咱们下期再见！

---