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

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

2026-03-28 55
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 很多新手初次使用 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
目录
相关文章
LucianaiB
|
7天前
|
人工智能 JSON 机器人
让龙虾成为你的“公众号分身” | 阿里云服务器玩Openclaw
本文带你零成本玩转OpenClaw：学生认证白嫖6个月阿里云服务器，手把手配置飞书机器人、接入免费/高性价比AI模型（NVIDIA/通义），并打造微信公众号“全自动分身”——实时抓热榜、AI选题拆解、一键发布草稿，5分钟完成热点→文章全流程！
LucianaiB
10945 83
让龙虾成为你的“公众号分身” | 阿里云服务器玩Openclaw
JavaPub
|
7天前
|
人工智能 IDE API
2026年国内 Codex 安装教程和使用教程：GPT-5.4 完整指南
Codex已进化为AI编程智能体，不仅能补全代码，更能理解项目、自动重构、执行任务。本文详解国内安装、GPT-5.4接入、cc-switch中转配置及实战开发流程，助你从零掌握“描述需求→AI实现”的新一代工程范式。（239字）
JavaPub
4181 129
阿里云安全_
|
2天前
|
人工智能 Kubernetes 供应链
深度解析：LiteLLM 供应链投毒事件——TeamPCP 三阶段后门全链路分析
阿里云云安全中心和云防火墙已在第一时间上线相关检测与拦截策略!
阿里云安全_
1398 5
阿里云安全_
|
3天前
|
人工智能 自然语言处理 供应链
【最新】阿里云ClawHub Skill扫描：3万个AI Agent技能中的安全度量
阿里云扫描3万+AI Skill，发现AI检测引擎可识别80%+威胁，远高于传统引擎。
阿里云安全_
1293 3
ClawdbotMoltbot
|
13天前
|
人工智能 JavaScript API
解放双手！OpenClaw Agent Browser全攻略（阿里云+本地部署+免费API+网页自动化场景落地）
“让AI聊聊天、写代码不难，难的是让它自己打开网页、填表单、查数据”——2026年，无数OpenClaw用户被这个痛点困扰。参考文章直击核心：当AI只能“纸上谈兵”，无法实际操控浏览器，就永远成不了真正的“数字员工”。而Agent Browser技能的出现，彻底打破了这一壁垒——它给OpenClaw装上“上网的手和眼睛”，让AI能像真人一样打开网页、点击按钮、填写表单、提取数据，24小时不间断完成网页自动化任务。
ClawdbotMoltbot
2744 6
OpenClaw
|
6天前
|
人工智能 机器人 API
从零搭建OpenClaw多智能体系统：部署、API配置+飞书多机器人管理手册
在团队协作场景中，单一AI智能体往往难以满足多部门、多场景的差异化需求——研发团队需要代码专家，运营团队需要内容策划助手，客服团队需要高效问答机器人，若所有需求都由同一个智能体承接，不仅会导致响应质量下降，还可能出现记忆混乱、权限失控等问题。2026年，OpenClaw（曾用名Clawdbot）的多Agent架构完美解决了这一痛点，通过“多飞书机器人账号+多独立Agent+路由绑定”的配置，可实现不同机器人对应专属AI大脑，各司其职、精准响应。
OpenClaw
1423 1

热门文章

最新文章

  • 1
    阿里巴巴如何远程办公！这些工具都能帮你
  • 2
    Kubernetes Meetup深秋成都行 Ghostcloud精灵云获好评如云
  • 3
    MySQL 小心使用 replace into
  • 4
    厉害了，蚂蚁金服！创造了中国自己的数据库OceanBase
  • 5
    阿里云服务器价格表2023，云服务产品价格对比
  • 6
    Spring - @Service、@Repository注解（service类、dao类）（实现类 & 接口类）
  • 7
    移除指定目录的文件
  • 8
    Tomcat的设置2——设置虚拟子目录和欢迎页
  • 9
    hdu 1711 Number Sequence
  • 10
    在Delphi程序中使用正则表达式
  • 1
    OpenClaw多Agent协作系统实操：本地+阿里云部署与千问/Coding Plan API配置全指南
    78
  • 2
    Web4实体赋能关键一步！OmniPact成OTC价值枢纽
    53
  • 3
    阿里云+本地全平台部署OpenClaw｜iMessage集成+大模型千问/Coding Plan API+避坑指南
    65
  • 4
    OpenClaw搭建金融投研Agent：接入QVeris一键接入万级数据源+阿里云/本地部署与模型配置教程
    119
  • 5
    阿里云+本地全平台部署OpenClaw｜iMessage集成+千问/Coding Plan API+避坑指南
    52
  • 6
    OpenClaw(Clawdbot)本地+阿里云部署实操：知识库搭建与大模型API对接全流程
    108
  • 7
    阿里云+本地三系统部署 OpenClaw 及精准参数调优手册：千问/Coding Plan模型对接教程
    65
  • 8
    零基础保姆级｜阿里云计算巢+MacOS/Linux/Windows11部署OpenClaw 技能集成+大模型配置全流程
    115
  • 9
    【分层架构】Spring MVC三层架构 / DDD领域驱动四层架构 / 微服务分布式架构（DAO/Mapper/Repository/Service/Controller/Manager）
    44
  • 10
    【数据载体POJO】POJO / DO / PO / DTO / VO / BO / Query / Entity / TO 全方位对比分析
    45

    • 相关电子书

    更多
  • 低代码开发师（初级）实战教程
  • 冬季实战营第三期：MySQL数据库进阶实战
  • 阿里巴巴DevOps 最佳实践手册
    • 下一篇
    狂揽7.5k星！这款开源API网关彻底解放开发者：一键聚合GPT-4、Suno、Midjourney，还能在线充值！