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 机器人凭证
访问 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 } } } }