首页 > OpenClaw > 最新文章

【Openclaw一键本地部署接入豆包】

CSDN博客 2026-05-04 09:21:20 人看过

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      }    }  } }

第一步需要替换你自己工作空间的位置:

"workspace": "C:\\Users\\Billy\\.openclaw\\workspace",

第二步需要修改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      }    }  } }

版权声明:倡导尊重与保护知识产权。未经许可,任何人不得复制、转载、或以其他方式使用本站《原创》内容,违者将追究其法律责任。本站文章内容,部分图片来源于网络,如有侵权,请联系我们修改或者删除处理。

编辑推荐

热门文章