Windows Ubuntu 本地部署OpenClaw

https://clawd.org.cn/install/docker-quick#%E6%96%B9%E5%BC%8F%E4%BA%8C-%E6%89%8B%E5%8A%A8-docker-compose-%E9%83%A8%E7%BD%B2-%E9%80%82%E5%90%88%E8%BF%9B%E9%98%B6%E7%94%A8%E6%88%B7https://clawd.org.cn/install/docker-quick#%E6%96%B9%E5%BC%8F%E4%BA%8C-%E6%89%8B%E5%8A%A8-docker-compose-%E9%83%A8%E7%BD%B2-%E9%80%82%E5%90%88%E8%BF%9B%E9%98%B6%E7%94%A8%E6%88%B7

步骤 1:创建工作目录

bash 复制代码
mkdir -p /data/docker/openclaw-docker
cd /data/docker/openclaw-docker

步骤 2:创建 .env 环境文件

bash 复制代码
cd /data/docker/openclaw-docker
mkdir data
chmod 777 data

将以下内容复制到 .env 文件:

复制代码
# 镜像配置
OPENCLAW_IMAGE=jiulingyun803/openclaw-cn:latest

# 数据目录(相对于 docker-compose.yml 所在目录)
OPENCLAW_CONFIG_DIR=./data/.openclaw
OPENCLAW_WORKSPACE_DIR=./data/clawd

# 网关配置
OPENCLAW_GATEWAY_PORT=18789
OPENCLAW_BRIDGE_PORT=18790
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_TOKEN=your-secure-token-here

# Claude 集成(可选,仅使用 Claude 作为后端时填写)
CLAUDE_AI_SESSION_KEY=
CLAUDE_WEB_SESSION_KEY=
CLAUDE_WEB_COOKIE=

或者使用 快速创建.env:

复制代码
cat > .env << 'EOF'
OPENCLAW_IMAGE=jiulingyun803/openclaw-cn:latest
OPENCLAW_CONFIG_DIR=./data/.openclaw
OPENCLAW_WORKSPACE_DIR=./data/clawd
OPENCLAW_GATEWAY_PORT=18789
OPENCLAW_BRIDGE_PORT=18790
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_TOKEN=your-secure-token-here
CLAUDE_AI_SESSION_KEY=
CLAUDE_WEB_SESSION_KEY=
CLAUDE_WEB_COOKIE=
EOF

步骤 3:在/data/docker/openclaw-docker目录下创建 docker-compose.yml 文件

将以下内容复制到 docker-compose.yml:

复制代码
services:
  openclaw-cn-gateway:
    image: ${OPENCLAW_IMAGE:-openclaw-cn:local}
    user: node:node
    environment:
      HOME: /home/node
      TERM: xterm-256color
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      CLAUDE_AI_SESSION_KEY: ${CLAUDE_AI_SESSION_KEY}
      CLAUDE_WEB_SESSION_KEY: ${CLAUDE_WEB_SESSION_KEY}
      CLAUDE_WEB_COOKIE: ${CLAUDE_WEB_COOKIE}
    volumes:
      - ${OPENCLAW_CONFIG_DIR:-./data/.openclaw}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR:-./data/clawd}:/home/node/clawd
    ports:
      - "${OPENCLAW_GATEWAY_PORT:-18789}:18789"
      - "${OPENCLAW_BRIDGE_PORT:-18790}:18790"
    init: true
    restart: unless-stopped
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "${OPENCLAW_GATEWAY_BIND:-lan}",
        "--port",
        "${OPENCLAW_GATEWAY_PORT:-18789}"
      ]

  openclaw-cn-cli:
    image: ${OPENCLAW_IMAGE:-openclaw-cn:local}
    user: node:node
    environment:
      HOME: /home/node
      TERM: xterm-256color
      BROWSER: echo
      CLAUDE_AI_SESSION_KEY: ${CLAUDE_AI_SESSION_KEY}
      CLAUDE_WEB_SESSION_KEY: ${CLAUDE_WEB_SESSION_KEY}
      CLAUDE_WEB_COOKIE: ${CLAUDE_WEB_COOKIE}
    volumes:
      - ${OPENCLAW_CONFIG_DIR:-./data/.openclaw}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR:-./data/clawd}:/home/node/clawd
    stdin_open: true
    tty: true
    init: true
    entrypoint: ["node", "dist/index.js"]

快速创建: 在命令行运行,文件会自动创建。

步骤 4:启动容器

复制代码
# 拉取最新镜像
docker compose pull

# 启动网关(后台运行)
docker compose up -d openclaw-cn-gateway

# 查看日志(可选)
docker compose logs -f openclaw-cn-gateway

步骤 5:运行配置向导

复制代码
docker compose run --rm openclaw-cn-cli onboard

配置向导会提示你:

  • 选择网关后端(Claude、Gemini 等)
  • 配置 Feishu、Telegram 等渠道
  • 生成和保存配置

步骤 6:访问 Web UI

打开浏览器访问:

复制代码
http://127.0.0.1:18789/

将配置向导生成的令牌复制到登录页面即可。

部署遇到的问题:

**1、步骤5:**Error: EACCES: permission denied, mkdir '/home/node/.openclaw/agents/main/agent'

bash 复制代码
volumes:
      - ${OPENCLAW_CONFIG_DIR:-./data/.openclaw}:/home/node/.openclaw

本地 ./data 目录没有权限: chmod 777 data/

**2、步骤6:**disconnected 1008 : pairing required openclaw

当首次在新浏览器或设备访问 OpenClaw Gateway 控制面板时,系统会要求管理员批准设备配对,否则会断开连接并提示此错误。

  • 用编辑器打开 pending.json 并修改:
bash 复制代码
#    "silent": true  // silent  true 时自动批准所有配对请求,不提示用户;
#                               false 时保持手动审批;
vim .openclaw/devices/pending.json
 
  • 保存文件,无需重启 Gateway,刷新页面即可生效。
相关推荐
小虎AI生活4 小时前
workbuddy可以操控电脑!真的太省心了,AI博主利器啊
aigc·ai编程
Rabitebla6 小时前
【Linux】文件篇(五):手撕简易 FILE——模拟实现 C 标准 I/O 缓冲机制
linux·服务器·c语言·笔记·学习·ubuntu
xx z10 小时前
Radmin LAN 怎么联机(虚拟局域网建房与加入教程)
windows·工具·软件
广东程序猿小展12 小时前
谷歌相机配置文件怎么导入(GCam 配置导入与不生效排查)
windows·工具·软件
Dawson Zhu17 小时前
【模型量化⑦】W4A8与GPTQ-Int4:极限压缩与MLC-LLM部署实战
人工智能·语言模型·架构·aigc·agi
Csvn1 天前
如果明天供应商涨价 3 倍?三层解耦,换模型只改一行配置(C05)
人工智能·aigc·agent
大模型真好玩1 天前
用 Seedance 2.5 Flash 实现1分钟AI短剧,满足孩子的超级英雄对战梦
人工智能·aigc·deepseek
Dawson Zhu1 天前
【模型量化⑤】Weight-Only INT4:AWQ与GPTQ两大算法深度解析
人工智能·语言模型·架构·aigc·agi
JonaHu2 天前
GPT Image 2.6 多语言海报改版:保留商品细节,分离文案与图像验收
图像处理·人工智能·aigc