OpenClaw本地部署指南 环境准备: 安装Node.js(推荐LTS版本)和Git 验证安装:node -v、npm -v、git --version 安装配置: 执行npm i -g openclaw安装 运行openclaw onboard配置 使用GitHub账号登录并验证 火山引擎订阅: 订阅Coding Plan套餐 配置baseUrl、apiKey和models参数 模型接入(以豆包为例): 修改agents参数中的model配置 配置模型供应商信息 更新认证配置 注:需要先订阅火山引擎服务

部署讲解B站视频

一、本地部署

官网:https://openclaw.ai/
github仓库:https://github.com/openclaw/openclaw
在这里插入图片描述
注意,因为Clawdbot改名,有些插件SDK安装的时候注意如果安装失败,注意要改成Openclaw

1.1 安装node.js

1、Node.js 官方下载地址:https://nodejs.org/zh-cn/download

在这里插入图片描述

官方地址:https://nodejs.org/zh-cn✅ 推荐下载 LTS 长期支持版(页面上显眼的那个版本,比如当前的 20.x 系列),稳定性强,适合开发 / 生产环境,页面会自动识别你的系统(Windows/Mac/Linux),直接点下载按钮就行。💡 补充:Node.js 安装包自带 npm(包管理器),不用单独下载。

勾选自动安装依赖工具
在这里插入图片描述
在这里插入图片描述

1.2、Git 官方下载地址

在这里插入图片描述

官方地址:https://git-scm.com/✅ 同样会自动识别系统,Windows 点「Download for Windows」,Mac/Linux 对应右侧的下载入口;Windows 建议选 64 位版本,安装时默认选项基本够用,新手不用改。

1.3、安装后快速验证(必做,确认是否装成功)

安装完成后,打开命令行(Windows 用 管理员的PowerShell,Mac/Linux 用终端),注意为了后续操作都能顺利安装,所有指令推荐用 管理员的PowerShell分别输入以下命令,能显示版本号就是安装成功:
验证 Node.js 和 npm:
node -v
npm -v
验证 Git
git --version

在这里插入图片描述

安装 Git 时,建议勾选「Add Git to PATH」(默认会勾),否则命令行识别不到 git 命令

#安装 Clawdbot
npm i -g openclaw
#配置 Clawdbot
openclaw onboard

在这里插入图片描述
在这里插入图片描述
用github账号登录通义千问
在这里插入图片描述

绑定邮箱验证通过
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
空格选中
在这里插入图片描述

二、订阅火山引擎Coding Plan

请大家点击豆包火山注册地址:https://t.vncps.com/5LOve
方舟 Coding Plan 支持 Doubao、GLM、DeepSeek、Kimi 等模型,工具不限,现在订阅折上9折,低至8.9元,订阅越多越划算!立即订阅:https://volcengine.com/L/2p_L1OTLQZw/ 邀请码:TVGNH4JT
在这里插入图片描述

访问火山方舟 Coding Plan 新用户特惠活动,按需订阅套餐。套餐介绍参见套餐概览https://www.volcengine.com/docs/82379/1925114?lang=zh
在这里插入图片描述

在开通管理页面https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=subscribe选择或切换目标模型,无需在工具中额外变更模型配置。
在这里插入图片描述

在 Coding Plan 场景下,查看和修改配置的入口和上述一致,其中需要修改的核心配置信息如下:

baseUrl:https://ark.cn-beijing.volces.com/api/coding/v3
apiKey:获取API Key(链接:https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)
models:ark-code-latest

MoltBot 支持快速接入火山方舟上的豆包, DeepSeek, GLM, Kimi等模型。
如果不订阅是无法和豆包对话啦!

三、openclaw配置豆包模型

下面以豆包1.8模型为例,讲解接入流程。(如果是想接入 deepseek、glm 等其他模型,替换成方舟官网上对应的 base_url、model 即可)

1、修改主要模型配置

在 agents 参数下,找到 model 和 models,改为您要接入的模型名称

"model": {
"primary": "doubao/doubao-seed-1-8-251228"
},
"models": {
"doubao/doubao-seed-1-8-251228": { "alias": "doubao" }
}

2、配置模型供应商

在 models 参数下,修改您要接入的 base_url 以及 API KEY(可在方舟 API 接入中找到)。

"models": {
  "providers": {
    "doubao": {
      "baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
      "apiKey": "YOUR_API_KEY",
      "api": "openai-completions"
    }
  }
}

3、修改认证配置

在 auth 参数下,修改认证配置

"auth": {
  "profiles": {
    "doubao:default": { "provider": "doubao", "mode": "api_key" }
  }
}

完整代码如下:

{
  "meta": {
    "lastTouchedVersion": "2026.2.2-3",
    "lastTouchedAt": "2026-02-04T12:03:52.781Z"
  },
  "wizard": {
    "lastRunAt": "2026-02-04T10:39:28.285Z",
    "lastRunVersion": "2026.2.2-3",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "diagnostics": {
    "otel": {
      "enabled": true
    }
  },
  "auth": {
    "profiles": {
      "qwen-portal:default": {
        "provider": "qwen-portal",
        "mode": "oauth"
      },
      "doubao:second": {
        "provider": "doubao",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "providers": {
      "doubao": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
        "apiKey": "api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "doubao-seed-1-8-251228",
            "name": "doubao-seed-1-8-251228",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      },
      "qwen-portal": {
        "baseUrl": "https://portal.qwen.ai/v1",
        "apiKey": "qwen-oauth",
        "api": "openai-completions",
        "models": [
          {
            "id": "coder-model",
            "name": "Qwen Coder",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          },
          {
            "id": "vision-model",
            "name": "Qwen Vision",
            "reasoning": false,
            "input": [
              "text",
              "image"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "doubao/ark-code-latest"
      },
      "models": {
        "qwen-portal/coder-model": {
          "alias": "qwen"
        },
        "qwen-portal/vision-model": {},
        "doubao/ark-code-latest": {
          "alias": "doubao"
        }
      },
      "workspace": "C:\\Users\\Billy\\.openclaw\\workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "845740b070feb247659fb403eb49952e713a14e87fca82f2"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "skills": {
    "entries": {
      "qqbot-cron": {
        "enabled": true
      }
    }
  },
  "plugins": {
    "entries": {
      "qwen-portal-auth": {
        "enabled": true
      }
    }
  }
}

只需要修改api-key,

        "apiKey": "api-key",

火山apikey获取位置:https://console.volcengine.com/ark/region:ark+cn-beijing/apikey?apikey=%7B%7D

在这里插入图片描述

👉 第三步:保存配置并重启服务

在 Openclaw配置界面完成修改后,先单击 Save,保存完成后单击 Update。

在这里插入图片描述

值得注意是,Openclaw提供了强大的个性化 AI Agent 体验,但用户需注意安全与隐私风险。

4、重启

后台启动
openclaw gateway restart
前台启动, 方便试试查看日志
openclaw gateway --port 18789 --verbose

CLI 配置向导

openclaw onboard
# 选择 QQ Bot 进行交互式配置

由于工具可访问设备所有数据、数字账户并通过多端口联网,存在一定安全隐患。建议在专用设备而非含敏感信息的设备上部署 Openclaw,定期检查并调整权限设置,并为火山方舟模型 API 密钥设置访问限制。

qq配置

项目地址:https://github.com/sliverp/qqbot
This content is only supported in a Feishu Docs

链接:https://pan.quark.cn/s/4efca7b4413f
安装
在插件目录下执行:

git clone https://github.com/sliverp/qqbot.git && cd qqbot
openclaw plugins install . # 这一步会有点久,需要安装一些依赖。稍微耐心等待一下,尤其是小内存机器

配置
7. 获取 QQ 机器人凭证

  1. 访问 QQ 开放平台
  2. 创建机器人应用
  3. 获取 AppID 和 AppSecret(ClientSecret)
  4. Token 格式为 AppID:AppSecret,例如 102146862:Xjv7JVhu7KXkxANbp3HVjxCRgvAPeuAQ
  5. 添加配置
方式一:交互式配置
openclaw channels add
# 选择 qqbot,按提示输入 Token
方式二:命令行配置
openclaw channels add --channel qqbot --token "AppID:AppSecret"

在这里插入图片描述

{
  "meta": {
    "lastTouchedVersion": "2026.2.2-3",
    "lastTouchedAt": "2026-02-04T13:02:41.055Z"
  },
  "wizard": {
    "lastRunAt": "2026-02-04T10:39:28.285Z",
    "lastRunVersion": "2026.2.2-3",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "diagnostics": {
    "otel": {
      "enabled": true
    }
  },
  "auth": {
    "profiles": {
      "qwen-portal:default": {
        "provider": "qwen-portal",
        "mode": "oauth"
      },
      "doubao:second": {
        "provider": "doubao",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "providers": {
      "doubao": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
        "apiKey": "ef0be8f7-c33c-4b86-a8a1-70b03aa11bd5",
        "api": "openai-completions",
        "models": [
          {
            "id": "doubao-seed-1-8-251228",
            "name": "doubao-seed-1-8-251228",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      },
      "qwen-portal": {
        "baseUrl": "https://portal.qwen.ai/v1",
        "apiKey": "qwen-oauth",
        "api": "openai-completions",
        "models": [
          {
            "id": "coder-model",
            "name": "Qwen Coder",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          },
          {
            "id": "vision-model",
            "name": "Qwen Vision",
            "reasoning": false,
            "input": [
              "text",
              "image"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "doubao/ark-code-latest"
      },
      "models": {
        "qwen-portal/coder-model": {
          "alias": "qwen"
        },
        "qwen-portal/vision-model": {},
        "doubao/ark-code-latest": {
          "alias": "doubao"
        }
      },
      "workspace": "C:\\Users\\Billy\\.openclaw\\workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "channels": {
    "qqbot": {
      "enabled": true,
      "appId": "102837579",
      "clientSecret": "L4nXH2nZL8vjXLAzpfWNF7zslfZUPLHE"
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "845740b070feb247659fb403eb49952e713a14e87fca82f2"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "skills": {
    "entries": {
      "qqbot-cron": {
        "enabled": true
      }
    }
  },
  "plugins": {
    "entries": {
      "qwen-portal-auth": {
        "enabled": true
      },
      "qqbot": {
        "enabled": true
      }
    }
  }
}

参考博客:

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐