OpenClaw 部署实战：Coding Plan 配置与飞书机器人接入

环境准备与安装

系统要求

• 操作系统：Windows 10 / 11 x64
• 内存：至少 8GB（推荐 16GB）
• Node.js：v22.0 或更高版本

先检查本地环境是否就绪：

node --version

如果未安装或版本低于 22，建议直接去 Node.js 官网下载 v22+ LTS 版本。

一键安装（推荐）

在 PowerShell 中执行以下命令，脚本会自动处理 Node.js 依赖及 OpenClaw 基础配置：

iwr -UseBasicParsing https://openclaw.ai/install.ps1 | iex

手动安装

若脚本不可用，可通过 npm 全局安装：

npm config set registry https://registry.npmmirror.com
npm i -g openclaw

初始化向导

安装完成后运行 openclaw onboard 进入配置向导。按提示操作即可：

1. 安全警告选择 Yes。
2. 模型提供商选 Skip（后续通过 Coding Plan 单独配）。
3. 通讯渠道选 Skip for now（稍后接飞书）。
4. 技能初始化选 Yes。
5. Gateway 配置选 QuickStart（默认端口 18789）。

验证安装成功：

openclaw --version
openclaw status

看到版本号且 Gateway 状态正常即表示完成。

配置 Coding Plan 模型

Coding Plan 是专为 AI 编程场景设计的固定月费订阅套餐，相比按量计费更稳定、无欠费风险，且支持国内直连和多模型切换。这里提供三个主流平台选项，可任选其一或多选备用。

阿里百炼 Coding Plan

获取凭证

访问阿里云百炼 Coding Plan 页面，订阅 Lite 或 Pro 版后获取专属凭证：

• API Key：格式为 sk-sp-xxxxx（注意这是专用 Key，与通用按量 Key 不互通）
• Base URL：https://coding.dashscope.aliyuncs.com/v1

配置方式

Web UI 配置（推荐） 运行 openclaw dashboard，在浏览器中进入 Config → All Settings → RAW，粘贴如下 JSON（替换 Key）：

{
  "models": {
    "providers": {
      "bailian": {
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "YOUR_CODING_PLAN_API_KEY",
        "api": "openai-completions",
        "models": [
          {"id": "qwen3.5-plus", "name": "Qwen3.5 Plus", "reasoning": false},
          {"id": "qwen3-coder-plus", "name": "Qwen3 Coder Plus", "reasoning": false}
        ]
      }
    },
    "agents": {
      "defaults": {
        "model": {"primary": "bailian/qwen3.5-plus"}
      }
    }
  }
}

⚠️ 注意：必须设置 "reasoning": false，否则部分模型可能返回空内容。

命令行配置

openclaw config set 'models.providers.bailian' --json '{"baseUrl":"https://coding.dashscope.aliyuncs.com/v1","apiKey":"YOUR_CODING_PLAN_API_KEY","api":"openai-completions","models":[{"id":"qwen3.5-plus","name":"Qwen3.5 Plus","reasoning":false}]}'
openclaw models set bailian/qwen3.5-plus

火山引擎 Coding Plan

获取凭证

访问火山引擎方舟 Coding Plan 订阅套餐，获取凭证：

• API Key：方舟 Coding Plan API Key
• Base URL：https://ark.cn-beijing.volces.com/api/coding/v3

配置示例

{
  "models": {
    "providers": {
      "volcengine": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
        "apiKey": "YOUR_ARK_API_KEY",
        "api": "openai-completions",
        "models": [
          {"id": "ark-code-latest", "name": "Ark Code Latest"},
          {"id": "doubao-seed-2.0-code", "name": "Doubao-Seed-2.0-Code"}
        ]
      }
    },
    "agents": {
      "defaults": {
        "model": {"primary": "volcengine/ark-code-latest"}
      }
    }
  }
}

智谱 GLM Coding Plan

获取凭证

访问智谱开放平台创建 API Key，Base URL 根据版本选择：

• 国内版：https://open.bigmodel.cn/api/paas/v4
• 国际版：https://api.z.ai/api/paas/v4

⚠️ 请勿使用 Flash/FlashX 等模型以免产生额外费用。

配置示例

{
  "models": {
    "providers": {
      "glm": {
        "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
        "apiKey": "YOUR_GLM_API_KEY",
        "api": "openai-completions",
        "models": [
          {"id": "GLM-5", "name": "GLM 5"},
          {"id": "GLM-4.7", "name": "GLM 4.7"}
        ]
      }
    },
    "agents": {
      "defaults": {
        "model": {"primary": "glm/GLM-5"}
      }
    }
  }
}

CC Switch 可视化管理

CC Switch 是基于 Rust + Tauri 构建的桌面应用，能统一管理 Claude Code、OpenClaw 等工具的模型和供应商，强烈推荐配合使用。

安装与配置

1. 从 GitHub Releases 下载 Windows 安装包并运行。
2. 启动后切换到 OpenClaw 选项卡，点击右侧橙色 + 按钮添加 Provider。
3. 填写供应商信息（如阿里百炼的 Base URL 和 API Key），点击 Enable。
4. CC Switch 会自动将配置写入 OpenClaw，随后重启网关生效：

   openclaw gateway restart
   

切换与代理

• 模型切换：在主界面或系统托盘菜单直接点击目标供应商。
• Proxy 模式：点击 Proxy 按钮启动本地代理（默认监听 127.0.0.1:15721），支持自动故障转移和请求日志记录。

接入飞书机器人

此步骤可选，接入后可通过飞书向 OpenClaw 下发指令，无需打开终端。

创建飞书应用

1. 登录 飞书开放平台，创建企业自建应用。
2. 保存 App ID 和 App Secret。
3. 左侧导航栏添加 机器人 能力。
4. 权限管理中添加必要权限（如 im:message, im:chat 等）。

配置 OpenClaw

交互式配置（推荐）

openclaw channels add

按提示选择 Feishu/Lark，输入 App Secret 和 App ID，域名选 China，策略选 Pairing。

手动配置 在 openclaw.json 中添加：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxx",
          "appSecret": "你的 AppSecret",
          "botName": "OpenClaw 助手"
        }
      }
    }
  }
}

事件订阅与发布

1. 回到飞书应用后台，事件与回调 中选择 长连接接收事件（WebSocket）。
2. 添加事件 im.message.receive_v1。
3. 提交版本发布，待管理员审批通过后上线。

测试

重启网关并查看日志确认连接：

openclaw gateway restart
openclaw logs --follow

在飞书中发送消息，收到配对码后在终端批准：

openclaw pairing approve feishu <CODE>

常见问题排查

Q1：报错 401 Unauthorized 检查 API Key 是否为 Coding Plan 专属 Key（以 sk-sp- 开头），并确认 Base URL 正确。

Q2：模型回复内容为空 确保配置中设置了 "reasoning": false。

Q3：切换供应商后无反应 CC Switch 切换后需重启网关：openclaw gateway restart。

Q4：工具功能失效 当前默认 profile 为 messaging（纯聊天），需切换为完整模式：

openclaw config set tools.profile full
openclaw gateway restart

Q5：飞书消息收不到 确认事件订阅已选长连接模式，应用已发布上线，且 Gateway 正在运行。

推荐配置组合

目标	推荐搭配
性价比优先	阿里百炼 Coding Plan + qwen3.5-plus
算力稳定优先	火山引擎 Coding Plan + Kimi-K2.5
编程能力优先	智谱 GLM Coding Plan + GLM-5