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

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

# 一、简介

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

# 二、docker

# 拉取 `Ubuntu` 镜像

docker pull ubuntu:latest

# 创建容器

创建容器，并映射 18789 端口

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

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

# 查看运行中的容器

docker ps

# 重新连接

docker attach openclaw

# 三、Ubuntu

# 更新软件源

apt-get update

# 安装必要的命令

apt-get install -y curl vim git systemctl

# 安装 `Node.js`

打开 https://nodejs.org/en/download (opens new window) ，按网页上提供的命令安装 NodeJS

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

# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# in lieu of restarting the shell
\. "$HOME/.nvm/nvm.sh"

# Download and install Node.js:
nvm install 24

# Verify the Node.js version:
node -v # Should print "v24.13.0".

# Verify npm version:
npm -v # Should print "11.6.2".

# 四、OpenClaw

# 安装

npm install -g openclaw@latest

# 配置

openclaw onboard --install-daemon

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

# 网关

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

vim ~/.openclaw/openclaw.json

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

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

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

修改完成后重新网关服务

openclaw gateway restart

# 运行 `OpenClaw`

openclaw dashboard

输出如下内容

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

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

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

# 五、疑难杂症

# pairing required

# Install failed (unknown exit): spawn npm ENOENT

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

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

执行如下命令创建软链

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

然后重启 gateway 即可

openclaw gateway restart

#OpenClaw

上次更新: 2026/02/02, 16:11:31

← AI - Gemini CLI 摆脱终端限制 AI - 发现一个超级好用的 AI 聚合平台→