Openclaw一鍵本地部署接入豆包的詳細步驟
OpenClaw本地部署指南
環(huán)境準備: 安裝Node.js(推薦LTS版本)和Git
驗證安裝:node -v、npm -v、git --version
安裝配置: 執(zhí)行npm i -g openclaw安裝 運行openclaw onboard配置 使用GitHub賬號登錄并驗證
火山引擎訂閱: 訂閱Coding Plan套餐 配置baseUrl、apiKey和models參數(shù)
模型接入(以豆包為例): 修改agents參數(shù)中的model配置 配置模型供應(yīng)商信息 更新認證配置
注:需要先訂閱火山引擎服務(wù)
一、本地部署
官網(wǎng):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 系列),穩(wěn)定性強,適合開發(fā) / 生產(chǎn)環(huán)境,頁面會自動識別你的系統(tǒng)(Windows/Mac/Linux),直接點下載按鈕就行。?? 補充:Node.js 安裝包自帶 npm(包管理器),不用單獨下載。
勾選自動安裝依賴工具


1.2、Git 官方下載地址

官方地址:https://git-scm.com/? 同樣會自動識別系統(tǒng),Windows 點「Download for Windows」,Mac/Linux 對應(yīng)右側(cè)的下載入口;Windows 建議選 64 位版本,安裝時默認選項基本夠用,新手不用改。
1.3、安裝后快速驗證(必做,確認是否裝成功)
安裝完成后,打開命令行(Windows 用 管理員的PowerShell,Mac/Linux 用終端),注意為了后續(xù)操作都能順利安裝,所有指令推薦用 管理員的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 等模型,工具不限,現(xiàn)在訂閱折上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 等其他模型,替換成方舟官網(wǎng)上對應(yīng)的 base_url、model 即可)
1、修改主要模型配置
在 agents 參數(shù)下,找到 model 和 models,改為您要接入的模型名稱
"model": {
"primary": "doubao/doubao-seed-1-8-251228"
},
"models": {
"doubao/doubao-seed-1-8-251228": { "alias": "doubao" }
}2、配置模型供應(yīng)商
在 models 參數(shù)下,修改您要接入的 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 參數(shù)下,修改認證配置
"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

第三步:保存配置并重啟服務(wù)
在 Openclaw配置界面完成修改后,先單擊 Save,保存完成后單擊 Update。

值得注意是,Openclaw提供了強大的個性化 AI Agent 體驗,但用戶需注意安全與隱私風險。
4、重啟
后臺啟動 openclaw gateway restart
前臺啟動, 方便試試查看日志 openclaw gateway --port 18789 --verbose
CLI 配置向?qū)?/p>
openclaw onboard # 選擇 QQ Bot 進行交互式配置
由于工具可訪問設(shè)備所有數(shù)據(jù)、數(shù)字賬戶并通過多端口聯(lián)網(wǎng),存在一定安全隱患。建議在專用設(shè)備而非含敏感信息的設(shè)備上部署 Openclaw,定期檢查并調(diào)整權(quán)限設(shè)置,并為火山方舟模型 API 密鑰設(shè)置訪問限制。
qq配置
項目地址:https://github.com/sliverp/qqbot
This content is only supported in a Feishu Docs
鏈接:https://pan.quark.cn/s/4efca7b4413f
安裝
在插件目錄下執(zhí)行:
git clone https://github.com/sliverp/qqbot.git && cd qqbot openclaw plugins install . # 這一步會有點久,需要安裝一些依賴。稍微耐心等待一下,尤其是小內(nèi)存機器
配置
7. 獲取 QQ 機器人憑證
- 訪問 QQ 開放平臺
- 創(chuàng)建機器人應(yīng)用
- 獲取 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
}
}
}
}
以上就是Openclaw一鍵本地部署接入豆包的詳細步驟的詳細內(nèi)容,更多關(guān)于Openclaw本地部署接入豆包的資料請關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
文章主要介紹了如何使用OpenClaw將AI助手“小龍蝦”本地化,使其同時接入豆包和OpenAI兩大AI模型,實現(xiàn)“本地運行,云端智能”的混合玩法,感興趣的朋友跟隨小編一起看看吧2026-03-05


