AI 助理
文档备案控制台
开发者社区 安全 文章 正文

Openclaw.json文件终极配置指南：Gateway稳定启动+阿里云/本地部署+千问/Coding Plan全配置

2026-03-28 1397
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 很多新手初次使用 OpenClaw（Clawdbot），90% 都会卡在同一个地方：**openclaw.json 配置写错导致 Gateway 起不来**。字段太多、层级太深、格式敏感、未知字段直接拒绝启动，让人无从下手。

一、前言

很多新手初次使用 OpenClaw（Clawdbot），90% 都会卡在同一个地方：openclaw.json 配置写错导致 Gateway 起不来。字段太多、层级太深、格式敏感、未知字段直接拒绝启动，让人无从下手。
OpenClaw1.png

本文严格保留核心配置逻辑、结构、字段含义与最佳实践，同时完整加入：

  • 2026 阿里云轻量服务器零基础部署
  • Windows11 / MacOS / Linux 本地一键部署
  • 阿里云千问大模型 API 完整配置
  • 免费大模型 Coding Plan API 配置
  • 可直接复制的配置模板 + 命令
  • 新手最常见报错与一键修复方案

全文新手照着抄就能让 Gateway 稳稳启动。阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。
OpenClaw部署教程图1.png

二、先搞懂：openclaw.json 到底是什么

文件位置：~/.openclaw/openclaw.json
格式：JSON5（支持注释、 trailing comma 尾逗号）
特点：极其严格，多一个未知字段、少一个引号、层级错一层，Gateway 直接启动失败。

它一共管理 8 大核心模块：

  1. channels：接入哪些平台（Discord/Slack/WhatsApp/Telegram/飞书）
  2. agents：你有几个智能体、用什么模型、工作区在哪
  3. models：模型提供商、API Key、模型列表
  4. gateway：端口、鉴权、热重载策略
  5. cron：定时任务
  6. bindings：消息路由（哪个渠道发给哪个 Agent）
  7. env：环境变量与密钥
  8. skills/plugins：技能与插件开关

下面直接给可落地、可直接复制的最简稳定版配置。

三、完整版 openclaw.json 稳定模板（直接复制使用）

{
   
  "gateway": {
   
    "port": 18789,
    "auth": {
   
      "mode": "token",
      "token": "your-gateway-token"
    },
    "reload": {
   
      "mode": "hybrid"
    }
  },
  "agents": {
   
    "defaults": {
   
      "model": {
   
        "primary": "bailian/qwen3-max"
      },
      "maxConcurrent": 20
    },
    "list": [
      {
   
        "id": "default-agent",
        "workspace": "~/.openclaw/workspace/default",
        "identity": {
   
          "name": "AI助手",
          "emoji": "🤖"
        }
      }
    ]
  },
  "models": {
   
    "mode": "merge",
    "providers": {
   
      "bailian": {
   
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "sk-你的阿里云千问APIKey",
        "models": [
          {
   
            "id": "qwen3-max",
            "contextWindow": 8192,
            "maxTokens": 2048
          }
        ]
      },
      "coding-plan": {
   
        "baseUrl": "https://api.codingplan.ai/v1",
        "apiKey": "你的CodingPlan免费APIKey",
        "models": [
          {
   
            "id": "coding-free",
            "contextWindow": 4096,
            "maxTokens": 1024
          }
        ]
      }
    }
  },
  "channels": {
   
    "discord": {
   
      "enabled": false,
      "token": "",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist"
    },
    "slack": {
   
      "enabled": false,
      "botToken": "",
      "appToken": "",
      "dmPolicy": "pairing"
    },
    "whatsapp": {
   
      "enabled": false,
      "dmPolicy": "pairing",
      "allowFrom": [],
      "groups": {
   
        "*": {
   
          "requireMention": true
        }
      }
    }
  },
  "bindings": [
    {
   
      "agentId": "default-agent",
      "match": {
   
        "channel": "*"
      }
    }
  ],
  "cron": [],
  "env": {
   
    "vars": {
   }
  }
}

四、八大模块逐行看懂（新手必学）

1. gateway：网关入口

"gateway": {
   
  "port": 18789,
  "auth": {
    "mode": "token", "token": "自定义密码" },
  "reload": {
    "mode": "hybrid" }
}
  • port：默认 18789，必须放行防火墙
  • auth：面板访问鉴权
  • reload：hybrid 最稳定（安全配置热重载，关键配置自动重启）

2. agents：智能体定义

"agents": {
   
  "defaults": {
   
    "model": {
    "primary": "bailian/qwen3-max" }
  },
  "list": [{
    "id": "default-agent", "workspace": "~/.openclaw/workspace/default" }]
}
  • id：唯一标识，用于路由绑定
  • workspace：每个 Agent 独立目录，互不污染

3. models：模型提供商（最关键）

支持同时配置阿里云千问 + 免费 Coding Plan，自动兜底。

4. channels：消息渠道

每个平台统一策略：

  • dmPolicy：pairing（需管理员同意）最安全
  • groupPolicy：allowlist（仅白名单群可用）
  • requireMention：必须@才回复，防骚扰

5. bindings：路由规则

把所有渠道消息都交给 default-agent：

{
   
  "agentId": "default-agent",
  "match": {
    "channel": "*" }
}

6. cron：定时任务

示例：每天早上 10 点执行任务

{
   
  "id": "daily-report",
  "enabled": true,
  "schedule": "0 10 * * *",
  "payload": {
   
    "kind": "systemEvent",
    "text": "生成今日工作简报"
  }
}

7. env：环境变量

存放 API Key、第三方 Token，更安全。

8. skills/plugins：技能开关

统一在面板启用，无需手动写 JSON。

五、2026 阿里云轻量服务器部署 OpenClaw（零基础 10 分钟）

步骤 1：购买实例

  1. 阿里云控制台 → 轻量应用服务器
  2. 镜像：应用镜像 → OpenClaw 2026 稳定版
  3. 地域：中国香港 / 新加坡
  4. 配置：2核2GB、40GB、5Mbps
  5. 设置 root 密码，记录公网IP

阿里云用户零基础部署 OpenClaw 喂饭级步骤流程

第一步：点击打开访问阿里云OpenClaw一键部署专题页面。
openclaw666.png
OpenClaw2.png
OpenClaw02.png
OpenClaw03.png
OpenClaw04.png

第二步：打开选择阿里云轻量应用服务器，配置参考如下：

  • 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
  • 实例：内存必须2GiB及以上。
  • 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
  • 时长：根据自己的需求及预算选择。

轻量应用服务器OpenClaw镜像.png
bailian1.png
bailian2.png

第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

阿里云百炼密钥管理图.png

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
阿里云百炼密钥管理图2.png

  • 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
  • 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
  • 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
  • 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！
CodingPlan.png

  • 购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
    image.png
  • 回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
    image.png
  • 在服务器概览页面单击应用详情页签，进入服务器详情页面。
    image.png
  • 端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
    image.png
  • 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
    image.png
  • 获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。
    image.png
    image.png

步骤 2：放行 18789 端口

firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
firewall-cmd --list-ports | grep 18789

步骤 3：初始化 OpenClaw

docker exec -it openclaw bash
openclaw init --full
openclaw --version
exit

docker update --restart=always openclaw
docker restart openclaw

步骤 4：访问面板

http://你的公网IP:18789

六、Windows11 / MacOS / Linux 本地部署

Windows11（管理员 PowerShell）

Set-ExecutionPolicy Bypass -Scope Process -Force
iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw onboard --install-daemon
openclaw gateway start

MacOS

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install docker node
open /Applications/Docker.app

docker pull openclaw/openclaw:2026.3.26
mkdir -p ~/OpenClaw/{
   config,workspace,skills}

docker run -d \
--name openclaw \
--restart always \
-p 18789:18789 \
-v ~/OpenClaw/config:/app/config \
-v ~/OpenClaw/workspace:/app/workspace \
-v ~/OpenClaw/skills:/app/skills \
openclaw/openclaw:2026.3.26

Linux（Ubuntu/Debian）

sudo apt update
curl -fsSL https://get.docker.com | bash
sudo systemctl enable docker && sudo systemctl start docker

sudo mkdir -p /opt/openclaw/{
   config,workspace,skills}
sudo chmod -R 777 /opt/openclaw

sudo docker run -d \
--name openclaw \
--restart always \
-p 18789:18789 \
-v /opt/openclaw/config:/app/config \
-v /opt/openclaw/workspace:/app/workspace \
-v /opt/openclaw/skills:/app/skills \
openclaw/openclaw:2026.3.26

七、阿里云千问大模型 API 配置

1. 获取 API Key

访问登录阿里云百炼大模型服务平台 → 密钥管理 → 创建 API Key

2. 命令行一键配置

docker exec -it openclaw bash
openclaw config set models.providers.bailian.baseUrl https://dashscope.aliyuncs.com/compatible-mode/v1
openclaw config set models.providers.bailian.apiKey sk-你的密钥
openclaw config set models.default.model bailian/qwen3-max
openclaw gateway restart

八、免费大模型 Coding Plan API 配置

docker exec -it openclaw bash
nano /app/config/model.config.yaml

写入：

coding-plan:
  enable: true
  model: coding-free
  api_key: 你的免费API Key
  baseUrl: https://api.codingplan.ai/v1
  timeout: 30

重启：

openclaw gateway restart

九、最常用启动、检查、修复命令

# 检查配置是否合法（最关键）
openclaw doctor

# 自动修复配置错误
openclaw doctor --fix

# 查看网关状态
openclaw gateway status

# 重启网关
openclaw gateway restart

# 实时看日志（排查报错）
openclaw logs --follow

# 查看模型连接是否正常
openclaw model test

# 查看渠道连接状态
openclaw channels status

十、新手高频报错 10 种 100% 解决

1. Gateway 启动失败

原因：JSON 格式错 / 未知字段 / 层级错误
解决

openclaw doctor --fix

2. 模型调用失败

原因：apiKey 错 / baseUrl 错 / 无额度
解决：核对 Key，重启网关

3. 渠道@机器人无反应

原因：dmPolicy/groupPolicy 拦截 / 未配对 / 未重启
解决

openclaw pairing approve 渠道名 配对码
openclaw gateway restart

4. 无法访问面板 http://IP:18789

原因：端口没放行 / 容器没运行
解决

firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
docker start openclaw

5. 配置改了不生效

原因：没重启网关
解决

openclaw gateway restart

6. 多 Agent 消息路由不对

原因：bindings 匹配错误
解决：用 channel: * 绑定默认 Agent

7. 技能装了不能用

原因：没启用 / 没重载
解决

openclaw skills enable --all
openclaw skills reload

8. 定时任务不执行

原因：cron 表达式错误 / 未启用
解决：开启 enabled: true，检查时间语法

9. 提示“权限不足”

原因：目录权限 / 容器用户问题
解决

sudo chmod -R 777 ~/.openclaw

10. 重启后配置丢失

原因：未挂载数据卷 / 未设置自启
解决

docker update --restart=always openclaw

十一、避坑终极原则（新手背下来）

  1. 先 doctor 再启动，改完配置必测试
  2. unknown field 直接删，不要乱加字段
  3. 渠道先关闭再改，改完再开启
  4. 模型优先填千问，Coding Plan 做备用
  5. workspace 分开，多 Agent 互不干扰
  6. 端口 18789 必须放行
  7. 密钥不要泄露，尽量放在 env 或环境变量

十二、总结

这篇是真正能让你从零直接跑通 OpenClaw的终极配置手册：

  • 一份稳定 openclaw.json 模板直接复制
  • 阿里云 + 本地三平台一键部署
  • 千问 + 免费 Coding Plan 双模型配置
  • 10 大高频报错一键修复
  • 所有命令可直接粘贴使用

只要按照本文配置，你的 OpenClaw Gateway 一定能稳稳启动，不再因为配置问题卡住。

文章标签：
API
数据安全/隐私保护
Linux
网络安全
安全
ClawdbotMoltbot
目录
相关文章
小鲸云
|
11天前
|
监控 安全 Linux
告别失联：OpenClaw 阿里云/本地部署与网关维护、免费大模型配置手册
OpenClaw的Gateway网关是整个系统的通信核心、会话中枢、任务调度中心与安全入口，一旦网关异常，所有聊天渠道、技能调用、模型交互都会中断。本文以稳定运行为目标，完整说明Gateway工作机制、全平台部署流程、阿里云百炼Coding Plan免费大模型API配置、网关守护与日志监控方案、常见故障一站式排查，所有内容均为实操可落地命令，无复杂术语，适合零基础用户长期稳定使用。
小鲸云
440 3
ClawdbotMoltbot
|
8天前
|
人工智能 Linux API
阿里云轻量服务器秒级部署OpenClaw｜大模型千问Qwen3-Max/Coding Plan API配置+避坑指南
2026年，OpenClaw（原Clawdbot）凭借轻量化部署、全平台兼容与大模型深度集成能力，成为个人与团队搭建专属AI自动化代理的首选工具。依托阿里云轻量服务器的秒级部署能力，搭配千问Qwen3-Max的强推理性能或Coding Plan免费API的低成本优势，可快速实现“云端稳定运行、本地灵活调试、多端指令交互”的AI服务闭环。本文基于2026年OpenClaw最新稳定版（v2026.3.28），完整覆盖**阿里云轻量服务器秒级部署、本地MacOS/Linux/Windows11部署、千问Qwen3-Max API配置、Coding Plan免费API配置、核心避坑指南、常见问题解答*
ClawdbotMoltbot
363 6
小龙虾AI
|
11天前
|
人工智能 安全 Linux
零门槛教程｜OpenClaw 阿里云/本地部署+千问/Coding Plan API配置全指南
2026年，开源AI智能体领域迎来现象级产品——OpenClaw（曾用名Clawdbot，因Logo酷似小龙虾被网友亲切称为“小龙虾”）。这款以“Local-First”为核心特色的AI框架，彻底打破传统AI“只说不做”的局限，能通过自然语言指令自主规划任务、调用工具、执行实际操作，涵盖文件管理、邮件收发、日程规划、代码生成、跨平台协同等全场景，真正实现“指令输入→AI规划→工具调用→任务落地”的闭环，成为个人与轻量团队提升效率的核心装备。
小龙虾AI
746 8
ClawdbotMoltbot
|
8天前
|
人工智能 机器人 API
一个人活成一支队伍：OpenClaw多智能体配置+飞书对接+大模型接入优化完整手册
OpenClaw的核心价值在于打破单一AI的能力局限，通过多Agent架构构建分工明确的数字员工团队，让每个智能体专注特定任务，协同完成复杂流程。本文基于2026年最新稳定版，遵循“环境准备→角色规划→核心配置→系统分配→通讯对接→启动调试”6大步骤，详细拆解数字员工团队搭建全流程，同时提供阿里云及本地多系统部署方案、阿里云百炼免费大模型配置，所有命令可直接复制执行，助力用户从零打造高效协同的AI团队。
ClawdbotMoltbot
725 4

热门文章

最新文章

  • 1
    DNS查询工具简介
  • 2
    Tomcat 7优化配置参数
  • 3
    《Cloud Native 》云原生技术汇总
  • 4
    Spring Boot 学习研究笔记(十七) -Spring boot JPA的复杂查询
  • 5
    单片机基础知识整理
  • 6
    手写redux方法以及数组reduce方法
  • 7
    以优质氘代产品为刃，劈开生物原材料市场壁垒
  • 8
    canvas-渐变文字
  • 9
    日本设计的七个原则
  • 10
    struts2学习笔记--总结获取servletAPI的几种方式
  • 1
    零基础零门槛！OpenClaw阿里云无影云电脑一键部署、iMessage对接与大模型千问Qwen3.6-Plus配置实战手册
    58
  • 2
    阿里云轻量服务器部署OpenClaw图文教程：飞书集成+千问Qwen3.6-Plus配置+新手避坑指南
    63
  • 3
    Claude Code、Codex接管开发流程，测试工程师下一步该做什么？
    102
  • 4
    阿里云ECS云服务器部署 OpenClaw 图文攻略｜LINE集成+千问Qwen3.6-Plus配置+新手避坑指南
    48
  • 5
    别再无效刷题了！2026校招笔试高频考点权重排序（附大厂内部评分标准）
    47
  • 6
    阿里云计算巢部署 OpenClaw 图文攻略：微信小程序集成+千问Qwen3.6-Plus配置+新手避坑指南
    47
  • 7
    零基础保姆级图文教程：阿里云计算巢OpenClaw部署、微信小程序接入与千问大模型API配置及避坑指南
    64
  • 8
    “养龙虾”全攻略｜OpenClaw(龙虾AI)阿里云轻量服务器零基础部署+QQ等四大IM集成+千问API配置指南
    59
  • 9
    分布式事务解决方案Seata之AT事务
    50
  • 10
    基于 YOLO的咖啡果实成熟度检测系统~Python+YOLO算法+模型训练+目标检测+2026原创
    43

    • 相关电子书

    更多
  • 低代码开发师（初级）实战教程
  • 冬季实战营第三期：MySQL数据库进阶实战
  • 阿里巴巴DevOps 最佳实践手册
    • 下一篇
    PHP：将本地文件上传到阿里云OSS存储