参考文章：

1. https://www.yuque.com/lianlianfengchen-cvvh2/mg9gqb/vn9b72zn39kdk21u?singleDoc#

官方文档：

https://clawd.org.cn/install/docker-quick.html

镜像构建

镜像源

查看镜像可用版本：curl -s https://ghcr.nju.edu.cn/v2/openclaw/openclaw/tags/list | python3 -m json.tool

镜像源：ghcr.nju.edu.cn/openclaw/openclaw:2026.3.12

• 不要使用官方镜像源，十分慢！如果要用代理甚至要开全局才行

镜像总体构建配置

预处理

compose前最好先创建.config, .data和.logs文件夹并赋予777权限：sudo chmod 777 -R .config/ .data/ .logs/，这是因为openclaw是node用户或者ubuntu等。如果不开放权限将无法访问.config这些目录报错无限重启。

构建代码（docker-compose.yml）

version: '3.8' # 需要>=3.8

services:
  openclaw:
    image: ghcr.nju.edu.cn/openclaw/openclaw:2026.3.12
    container_name: openclaw
    restart: always
    network_mode: host

    # ports: # 可以指定端口，host模式就不用了，全开
      # - "3000:3000"
      # - "18789:18789"

    volumes:
      - ./config:/home/node/.openclaw
      - ./data:/app/data
      - ./logs:/app/logs

    environment:
      - NODE_ENV=production
      - OPENCLAW_CN_MIRROR=true
      - NODE_OPTIONS="--max-old-space-size=2048" 
      # 软限制，要大于1GB，实测1G会报错内存不够。不设置默认是1G

   # shm_size: "512mb" 
    ulimits:
      nproc: 65535
      nofile:
        soft: 65535
        hard: 65535

启动容器

docker compose up -d

-d指后台运行

容器日志查看

docker logs -f openclaw 可以查看容器启动日志，其中有报错信息。

OpenClaw配置

在启动好了之后需要打通本地到服务器中容器的连接。由于openclaw容器设置的host模式，因此已经能够与服务器互通。但仅此而已。有多种方式，可以参考https://clawd.org.cn/gateway/。

本文使用ssh来建立连接：ssh -N -L 18789:127.0.0.1:18789 vcoco，服务需要常驻后台

OpenClaw基本设置

由于本地修改会造成容器内用户对不上的问题，这里都进入容器设置，不修改挂载的.config/等卷。后续能有效解决这个问题再说

1. 进入容器内 docker exec -it openclaw /bin/bash
2. 查看gateway token：cat ~/.openclaw/openclaw.json
3. 本机进入网址127.0.0.1:18789，输入网关token
4. 配置模型，参考：https://help.aliyun.com/zh/model-studio/openclaw

web端能对话或者容器内输入openclaw tui命令能对话就OK了~

tui示例：

node@VM-0-14-ubuntu:/app$ openclaw tui

🦞 OpenClaw 2026.3.12 (unknown) — Your personal assistant, minus the passive-aggressive calendar reminders.

 openclaw tui - ws://127.0.0.1:18789 - agent main - session main

 session agent:main:main


 你好


 ⠋ dillydallying… • 0s | connected                                                                                      你好！欢迎来到 OpenClaw。我已就绪，随时可以帮你完成任务、探索知识、写代 码、分析文件、管理日程，或者只是聊聊天 😊

 有什么想做的？


 你好


 你好！欢迎使用 OpenClaw 控制界面。我已就绪，随时可以帮你：

 - 管理文件、运行命令、调用工具
 - 编写/编辑代码或文档（支持 ACP 模式）
 - 搜索网络、读取网页内容
 - 查看日志、状态、配置
 - 启动子代理（subagent）或会话（session）
 - 运行 cron 任务、发送消息、控制设备等

 你希望从哪开始？ 🌟

镜像换源

• 换源有助于后面apt update并安装vim等软件

参考链接：https://mirrors.tuna.tsinghua.edu.cn/help/debian

也可以考虑安装brew：https://brew.sh/zh-cn/

OpenClaw进阶配置

Skills

• skill国内网站（腾讯，吃瓜~。从被骂到成为赞助商）：https://skillhub.tencent.com/

qwen-image

插件

clawhub（不知道算不算插件）

pnpm setup （设置bin的PATH）
# 如果报错就用下面这个
SHELL=bash pnpm setup
source ~/.bashrc
pnpm add -g clawhub

tavily-search

openclaw自带的brave搜索虽然好用但是付费。这个是有免费额度的（1000次/月）

• 官网：https://app.tavily.com/playground

安装：openclaw plugins install openclaw-tavily

安装后agents里面会多了openclaw-tavily，里面有5个不同的内容。并且skills里面也多了个travily。

飞书机器人