AI - 通过 Docker 来安装与访问 OpenClaw

欢迎关注微信公众号：FSA全栈行动 👋

一、简介

这是我在 Mac 上通过 Docker 来安装和配置 OpenClaw 的一份记录，随着文章从上到下一步步做就可以了。

二、docker

拉取 `Ubuntu` 镜像

1docker pull ubuntu:latest
2

创建容器

创建容器，并映射 18789 端口

1docker run -it -p 18789:18789 --name openclaw ubuntu
2

搭配 Docker 容器的分离快捷键，先按 Ctrl+P，再按 Ctrl+Q，使容器从交互式会话中退出，同时保持容器继续在后台运行。

查看运行中的容器

1docker ps
2

重新连接

1docker attach openclaw
2

三、Ubuntu

更新软件源

1apt-get update
2

安装必要的命令

1apt-get install -y curl vim git systemctl
2

安装 `Node.js`

打开 nodejs.org/en/download ，按网页上提供的命令安装 NodeJS

以下是文章发布时的最新安装命令，跟着复制粘贴去执行即可

1# Download and install nvm:
2curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
3
4# in lieu of restarting the shell
5\. "$HOME/.nvm/nvm.sh"
6
7# Download and install Node.js:
8nvm install 24
9
10# Verify the Node.js version:
11node -v # Should print "v24.13.0".
12
13# Verify npm version:
14npm -v # Should print "11.6.2".
15

四、OpenClaw

安装

1npm install -g openclaw@latest
2

配置

1openclaw onboard --install-daemon
2

根据你自身情况进行配置即可，命令可以反复去执行进行配置

网关

配置文件位置位于: ~/.openclaw/openclaw.json

1vim ~/.openclaw/openclaw.json
2

OpenClaw 使用 gateway.bind 配置项控制绑定模式，默认的绑定模式为 loopback，仅 127.0.0.1 可访问。

我们需要在宿主机中访问，则需要修改为 lan，并且将 mode 设置为 local，如:

1{
2  gateway: {
3    mode: "local",
4    bind: "lan",
5    port: 18789,
6    auth: { 
7      mode: "token", 
8      token: "your-token" 
9    },
10  },
11}
12

修改完成后重新网关服务

1openclaw gateway restart
2

运行 `OpenClaw`

1openclaw dashboard
2

输出如下内容

1Dashboard URL: http://127.0.0.1:18789/?token=yourtoken
2Copy to clipboard unavailable.
3No GUI detected. Open from your computer:
4ssh -N -L 18789:127.0.0.1:18789 user@<host>
5Then open:
6http://localhost:18789/
7http://localhost:18789/?token=yourtoken
8Docs:
9https://docs.openclaw.ai/gateway/remote
10https://docs.openclaw.ai/web/control-ui
11

在宿主机的浏览器中打开给出网址即可

1http://127.0.0.1:18789/?token=yourtoken
2

五、疑难杂症

pairing required

Install failed (unknown exit): spawn npm ENOENT

在安装 Skills 时遇到过这个错误提示，原因是 nvm 通过 ~/.nvm/current 指向当前激活的版本，但这个链接缺失了。

Gateway 的 PATH 包含了 /root/.nvm/current/bin，但因为这个链接不存在，所以找不到 npm。

执行如下命令创建软链

1# 根据你自己安装的 node 版本去替换掉 v24.13.0
2ln -s /root/.nvm/versions/node/v24.13.0 /root/.nvm/current
3

然后重启 gateway 即可

1openclaw gateway restart
2

如果文章对您有所帮助, 请不吝点击关注一下我的微信公众号：FSA全栈行动, 这将是对我最大的激励. 公众号不仅有 iOS 技术，还有 Android，Flutter，Python 等文章, 可能有你想要了解的技能知识点哦~

《AI - 通过 Docker 来安装与访问 OpenClaw》是转载文章，点击查看原文。