文章目录

简述

OpenClaw 是一款开源的自托管式智能交互网关工具，支持本地部署、设备授权管理和多模型集成，本指南将从部署、配置、设备管理到模型对接全流程进行系统化讲解，帮助你快速上手并完成生产级配置。

配置信息

项目地址

  • GitHub 官方仓库：openclaw/openclaw
  • 部署方式：推荐使用项目内置的 docker-compose.xml 进行 Docker 容器化部署
  • 个人修改docker compose 仓库docker-compose

部署方式

下载官方项目叠加 以下个人修改仓库的 docker-compose.yml 或者直接下载个人修改好的仓库都可以
在项目根目录执行

docker compose up -d

中间所有数据配置会在 该目录下 volumes 内部生成，剩下按照文档如下操作就可以使用

核心文件路径

  • 核心配置文件：volumes/node/.openclaw/openclaw.json

  • 配置备份文件：volumes/node/.openclaw/openclaw.json.bak（配置更新时自动生成）

二、核心配置文件详解

openclaw.json 是 OpenClaw 的核心配置文件，包含网关、授权、命令行为等关键配置，完整配置示例及说明如下：


{
  "commands": {
    // 原生命令执行模式（auto=自动适配）
    "native": "auto",
    // 原生技能加载模式（auto=自动加载）
    "nativeSkills": "auto",
    // 服务异常时自动重启
    "restart": true,
    // 所有者信息展示格式（raw=原始格式）
    "ownerDisplay": "raw"
  },
  "gateway": {
    // 网关运行模式（local=本地模式）
    "mode": "local",
    // 绑定网络类型（lan=局域网）
    "bind": "lan",
    // 网关监听端口
    "port": 18789,
    "auth": {
      // 认证模式（token=令牌认证）
      "mode": "token",
      // 访问令牌（建议替换为自定义高强度字符串）
      "token": "fe284bd21ceaf7e3d6b0ab0429f57049289fb73f5524ec9f"
    },
    "controlUi":{
      // 允许 Host 头源回退（仅局域网环境建议开启）
      "dangerouslyAllowHostHeaderOriginFallback": true,
      // 启用 Web 控制界面
      "enabled": true,
      // 允许非安全认证（测试环境使用，生产环境建议关闭）
      "allowInsecureAuth": true
    },
    // 可信代理网段（适配 Docker 网络环境）
    "trustedProxies": ["192.168.65.0/24", "172.17.0.0/16"]
  },
  "meta": {
    // 最后配置版本
    "lastTouchedVersion": "2026.3.9",
    // 最后配置时间
    "lastTouchedAt": "2026-03-11T02:06:17.804Z"
  }
}

三、服务状态与访问管理

查看网关状态

执行以下命令检查 OpenClaw 网关运行状态：


openclaw gateway status

获取访问 Token 及 Web 地址

生成带 Token 的访问链接（不自动打开浏览器）：


openclaw dashboard --no-open

输出示例：


http://127.0.0.1:18789/#token=fe284bd21ceaf7e3d6b0ab0429f57049289fb73f5524ec9f

  • 访问说明：

    • 本地访问：直接使用 127.0.0.1:18789

    • 局域网访问：替换为容器/主机的局域网 IP（如 172.21.0.2:18789）

四、设备授权管理

OpenClaw 采用设备授权机制管控访问权限，需完成待授权设备的审批流程：

查看设备列表

列出待授权（Pending）和已配对（Paired）的设备：


openclaw devices list

输出示例：


🦞 OpenClaw 2026.3.9 (unknown) — Self-hosted, self-updating, self-aware (just kidding... unless?).

│
◇  
Pending (1)
┌──────────────────────────────────────┬─────────────────────────────────────────┬──────────┬────────────┬──────────┬────────┐
│ Request                              │ Device                                  │ Role     │ IP         │ Age      │ Flags  │
├──────────────────────────────────────┼─────────────────────────────────────────┼──────────┼────────────┼──────────┼────────┤
│ 2093a05e-42fa-41ec-ad11-d2f43d5a05a7 │ f0b1cde1474e4cdf21e85eb63baa724eb4c0c87 │ operator │ 172.21.0.1 │ just now │        │
│                                      │ bc539ee700f5a0143c750fa88               │          │            │          │        │
└──────────────────────────────────────┴─────────────────────────────────────────┴──────────┴────────────┴──────────┴────────┘
Paired (1)
┌─────────────────────────────────┬────────────┬───────────────────────────────────────────────────┬────────────┬────────────┐
│ Device                          │ Roles      │ Scopes                                            │ Tokens     │ IP         │
├─────────────────────────────────┼────────────┼───────────────────────────────────────────────────┼────────────┼────────────┤
│ 072f4e750bed8f57ba32b3d6e6ff545 │ operator   │ operator.admin, operator.read, operator.write,    │ operator   │            │
│ cdad053a6df51542388ea7774a968a0 │            │ operator.approvals, operator.pairing              │            │            │
│ f1                              │            │                                                   │            │            │
└─────────────────────────────────┴────────────┴───────────────────────────────────────────────────┴────────────┴────────────┘

4.2 审批待授权设备

使用 Request ID 审批指定设备：


openclaw devices approve 2093a05e-42fa-41ec-ad11-d2f43d5a05a7

成功输出：


🦞 OpenClaw 2026.3.9 (unknown) — The only open-source project where the mascot could eat the competition.

Approved f0b1cde1474e4cdf21e85eb63baa724eb4c0c87bc539ee700f5a0143c750fa88 (2093a05e-42fa-41ec-ad11-d2f43d5a05a7)

五、对话模型配置

通过交互式命令配置对接 vLLM 模型，支持 DeepSeek 等主流大模型：

启动配置向导


openclaw config

配置流程分步说明

  1. 基础网关确认：系统自动识别现有网关配置（local 模式、18789 端口、lan 绑定）

  2. 选择配置模块：选择 Model 进入模型配置

  3. 模型提供商选择：选择 vLLM

  4. vLLM 基础配置：

    • vLLM base URL：https://api.deepseek.com/v1（DeepSeek 官方 API 地址）

    • vLLM API key：sk-978944fc9f5542dXXXX0c95fe5c31（替换为你的实际 API 密钥）

    • vLLM model：deepseek-reasoner（指定使用的模型名称）

  5. 模型选择确认：确认选中的模型（默认 1 项），系统自动更新配置文件并生成备份

  6. 完成配置：选择 Continue 结束配置，系统输出访问信息

配置完成输出


◇  Control UI ─────────────────────────────────────────────────────────────────╮
│                                                                              │
│  Web UI: http://172.21.0.2:18789/                                            │
│  Gateway WS: ws://172.21.0.2:18789                                           │
│  Gateway: not detected (gateway url override requires explicit credentials)  │
│  Docs: https://docs.openclaw.ai/web/control-ui                               │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────╯
│
└  Configure complete.

以下是使用方式

node@a0b8fbc25ea3:/app$ openclaw config

🦞 OpenClaw 2026.3.9 (unknown) — Greetings, Professor Falken

▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
                  🦞 OPENCLAW 🦞

┌  OpenClaw configure
│
◇  Existing config detected ─╮
│                            │
│  gateway.mode: local       │
│  gateway.port: 18789       │
│  gateway.bind: lan         │
│                            │
├────────────────────────────╯
│
◇  Where will the Gateway run?
│  Local (this machine)
│
◇  Select sections to configure
│  Model
│
◇  Model/auth provider
│  vLLM
│
◇  vLLM base URL
│  https://api.deepseek.com/v1
│
◇  vLLM API key
│  sk-978944fc9f5542dXXXX0c95fe5c31
│
◇  vLLM model
│  deepseek-reasoner
│
◇  Model configured ────────────────────────────╮
│                                               │
│  Default model set to vllm/deepseek-reasoner  │
│                                               │
├───────────────────────────────────────────────╯
│
◇  Models in /model picker (multi-select)
│  1 items selected
Config overwrite: /home/node/.openclaw/openclaw.json (sha256 1b8ad3b3e9d958cd4c37bd553e2400548f24979a165121b796bca26d07c937d3 -> 3ec37d9d0490b1d47eca9b75df98677590cd059f49c6eb729b205e6eb24400c1, backup=/home/node/.openclaw/openclaw.json.bak)
Updated ~/.openclaw/openclaw.json
│
◇  Select sections to configure
│  Continue
│
◇  Control UI ─────────────────────────────────────────────────────────────────╮
│                                                                              │
│  Web UI: http://172.21.0.2:18789/                                            │
│  Gateway WS: ws://172.21.0.2:18789                                           │
│  Gateway: not detected (gateway url override requires explicit credentials)  │
│  Docs: https://docs.openclaw.ai/web/control-ui                               │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────╯
│
└  Configure complete.
# docker # 容器 # 运维
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

OpenClaw+GLM-4.7-Flash语音交互：对接Whisper实现语音控制

本文介绍了如何在星图GPU平台上自动化部署【ollama】GLM-4.7-Flash镜像，构建语音交互系统。该系统结合Whisper语音识别与GLM-4.7-Flash的指令理解能力，实现智能家居控制等场景的语音操作，提升日常任务执行效率。

avatar 龙虾开发者社区

学生党福音：OpenClaw+nanobot搭建学习监督助手

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，构建智能学习监督助手。该方案利用轻量级模型实现网课进度跟踪、自动生成练习题和错题整理功能，特别适合学生群体通过QQ机器人实现移动端学习管理，显著提升学习效率。

avatar 龙虾开发者社区

OpenClaw创意工坊：用nanobot镜像生成技术海报文案

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，快速生成技术海报文案。该镜像基于Qwen3-4B模型，能将复杂技术术语转化为通俗表达，适用于技术活动宣传、社交媒体推广等场景，显著提升内容创作效率。

avatar 龙虾开发者社区