Openclaw一键本地部署接入豆包的详细步骤

目录

• 一、本地部署
• 1.1 安装node.js
• 1.2、Git 官方下载地址
• 1.3、安装后快速验证（必做，确认是否装成功）
• 二、订阅火山引擎Coding Plan
• 三、openclaw配置豆包模型
• 1、修改主要模型配置
• 2、配置模型供应商
• 3、修改认证配置
• 4、重启
• qq配置

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、Node.js 官方下载地址：https://nodejs.org/zh-cn/download

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

勾选自动安装依赖工具

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

安装完成后，打开命令行（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账号登录通义千问

绑定邮箱验证通过

空格选中

请大家点击豆包火山注册地址：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等模型。
如果不订阅是无法和豆包对话啦！

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

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

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

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

在 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 体验，但用户需注意安全与隐私风险。

后台启动
openclaw gateway restart

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

CLI 配置向导

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

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

项目地址：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
      }
    }
  }
}

以上就是Openclaw一键本地部署接入豆包的详细步骤的详细内容，更多关于Openclaw本地部署接入豆包的资料请关注风君子博客其它相关文章！