【Openclaw一键本地部署接入豆包】
OpenClaw本地部署指南 环境准备: 安装Node.js(推荐LTS版本)和Git 验证安装:node -v、npm -v、git --version 安装配置: 执行npm i -g openclaw安装 运行openclaw onboard配置 使用GitHub账号登录并验证 火山引擎订阅: 订阅Coding Plan套餐 配置baseUrl、apiKey和models参数 模型接入(以豆
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配置 配置模型供应商信息 更新认证配置 注:需要先订阅火山引擎服务
一、本地部署
官网: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 机器人凭证
- 访问 QQ 开放平台
- 创建机器人应用
- 获取 AppID 和 AppSecret(ClientSecret)
- Token 格式为 AppID:AppSecret,例如 102146862:Xjv7JVhu7KXkxANbp3HVjxCRgvAPeuAQ
- 添加配置
方式一:交互式配置
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
}
}
}
}
参考博客:
更多推荐

所有评论(0)