OpenClaw + 微信 ClawBot 部署文档(Ubuntu 22.04 + Docker Compose)

配置步骤:

1、拉取最新镜像
docker pull ghcr.io/openclaw/openclaw:latest

2、清理旧数据(全新部署必须执行)
sudo rm -rf .openclaw

3、启动容器
docker compose down
docker compose up -d

4、修复目录权限(非常关键)
chown -R 1000:1000 ./.openclaw

5、微信插件安装,进入容器
docker exec -it openclaw-gateway /bin/bash
安装微信插件
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
异常处理(插件残留)
rm -rf /home/node/.openclaw/extensions/openclaw-weixin 再次执行上面命令

6、看到 [openclaw-weixin] 插件就绪,开始首次连接… 重新进入容器
docker exec -it openclaw-gateway /bin/bash
登录微信(扫码绑定)
openclaw channels login –channel openclaw-weixin

7、打开微信(必须是8.0.70以上版本) → 我 → 设置 → 插件→「微信 ClawBot」(使用插件内扫码功能)

8、重启网关
docker restart openclaw-gateway

9、访问控制台
http://10.10.10.69:18789#token=free-ai

Docker Compose 配置

1、docker-compose.yml 配置如下:

services:
  openclaw-gateway:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw-gateway
    ports:
      - "18789:18789"
    environment:
        - OPENCLAW_GATEWAY_TOKEN=free-ai
    volumes:
      - ./.openclaw:/home/node/.openclaw
    networks:
      - ds-net
    restart: unless-stopped

networks:
  ds-net:
    driver: bridge

2、OpenClaw 主配置
/home/aliketen/docker-compose-app/.openclaw/openclaw.json 配置如下:

{
  "models": {
    "mode": "merge",
    "providers": {
      "vllm": {
        "baseUrl": "http://10.10.10.53:1234/v1",
        "apiKey": "LMstudio",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-9b-claude-4.6-opus-reasoning-distilled-v2",
            "name": "qwen3.5-9b-claude-4.6-opus-reasoning-distilled-v2",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 100000,
            "maxTokens": 100000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "vllm/qwen3.5-9b-claude-4.6-opus-reasoning-distilled-v2"
      },
      "workspace": "/home/node/.openclaw/workspace"
    }
  },
  "tools": {
    "profile": "coding"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "allowedOrigins": [
        "*"
      ],
      "allowInsecureAuth": true,
      "dangerouslyDisableDeviceAuth": true
    },
    "auth": {
      "mode": "token",
      "token": "free-ai"
    },
    "tailscale": {}
  }
}

3、模型认证配置
/home/aliketen/docker-compose-app/.openclaw/agents/main/agent/auth-profiles.json 配置如下:

{
  "vllm:default": {
    "provider": "vllm",
    "mode": "api_key",
    "apiKey": "LMstudio",
    "baseUrl": "http://10.10.10.53:1234/v1"
  }
}

检查命令:docker logs openclaw-gateway
查看运行状态:openclaw status