1. 为什么要在本地跑 OpenClaw 加千问大模型OpenClaw 是一个可以本地部署的 AI Agent 框架能通过自然语言指令完成文件管理、信息检索、内容处理、流程自动化等实际操作并且支持 Skills 插件扩展。它依赖 Node.js 运行数据优先存储在本地对隐私和可控性要求高的开发者来说比较友好。适合谁想在个人电脑上跑通 AI Agent、又不想把数据全交给云端的人。千问大模型Qwen通过阿里云百炼平台提供 API 调用模型能力覆盖对话、推理、代码生成等场景。把 OpenClaw 和千问接起来你就能在本地用一个统一的 Agent 界面调度千问的能力同时保留 Skills 扩展的灵活性。但实际部署时会遇到几个问题Node.js 版本不对导致安装失败、API Key 配置路径写错、模型调用返回空、端口被占用访问不了 Web 控制台。这篇就按本地环境Windows 11 / macOS / Linux走一遍完整流程从环境准备到启动验证再到常见报错排查每一步都给可复制的命令和配置。另外如果你后续要接多个模型或者做统一通道管理可以用 TaoToken 来统一配置 API 入口省得每个模型都改一遍配置文件。下面会给出 OpenClaw 的 config.toml 骨架和 TaoToken 的接入方式。2. 部署前环境准备与 TaoToken 前置说明2.1 Node.js 环境检查OpenClaw 要求 Node.js 22.x 及以上版本。先检查当前版本node -v npm -v如果输出版本号且 node 版本 ≥ 22说明环境可用。如果提示command not found或版本过低需要先安装或升级。Windows 11 可以用 winget 安装winget install OpenJS.NodeJS --version 22.0.0macOS 用 Homebrewbrew install nodeLinuxUbuntu/Debian可以用 n 管理版本sudo apt update sudo apt install -y curl git sudo npm install -g n sudo n stable安装完成后重新打开终端再执行node -v确认版本。2.2 npm 镜像配置国内网络环境下npm 默认源可能拉取较慢建议切换镜像npm config set registry https://registry.npmmirror.com2.3 TaoToken 统一通道前置TaoToken 的作用是提供一个统一的 API 入口方便你在 OpenClaw 里切换不同模型而不需要反复改 base_url 和 key。如果你只接千问一个模型可以跳过这步直接用百炼的 API Key如果后续要接多个模型或者做统一管理建议先注册并拿到 API Key。官网地址https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址https://taotoken.net/api注册后在控制台创建 API Key后面配置 config.toml 时会用到。API Keys 管理页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite注意TaoToken 是统一 API 通道不是替代 OpenClaw 或编辑器的工具。它的作用是让你在 OpenClaw 里通过一个 base_url 和 key 调用多个模型。3. OpenClaw 安装与千问模型配置3.1 安装 OpenClaw全局安装npm install -g openclaw安装完成后验证openclaw --version如果提示openclaw: command not found先确认 npm 全局路径是否在 PATH 里或者重新执行安装命令后关闭终端再打开。3.2 初始化配置执行初始化命令openclaw onboard按提示完成同意协议选择快速启动模型配置可以先跳过后面手动写 config.toml启用需要的通道初始化完成后会生成配置目录macOS/Linux~/.openclaw/WindowsC:\Users\用户名\.openclaw\3.3 获取阿里云百炼 API Key千问大模型通过阿里云百炼平台提供 API。登录百炼控制台进入密钥管理页面创建 API Key。创建后复制保存后面配置要用。如果你用 TaoToken 统一通道则不需要单独拿百炼的 Key直接用 TaoToken 的 API Key 和 base_url 即可。3.4 config.toml 骨架OpenClaw 支持 config.toml 格式的配置文件。在~/.openclaw/目录下创建或编辑config.toml[gateway] host 127.0.0.1 port 18789 [model] type openai api_key 你的TaoToken_API_Key base_url https://taotoken.net/api model_name qwen-plus max_tokens 2048 temperature 0.7 timeout 60 reasoning false如果你直接用阿里云百炼的 API Key配置改成[model] type aliyun-bailian api_key 你的百炼API_Key model_name qwen-plus max_tokens 2048 temperature 0.7 timeout 60 reasoning false参数说明参数作用建议值type模型接口类型openai 或 aliyun-bailianapi_keyAPI 密钥从对应平台获取base_urlAPI 入口地址TaoToken 用 https://taotoken.net/apimodel_name模型名称qwen-plus / qwen-turbomax_tokens单次最大生成 token2048temperature生成随机性0.7timeout请求超时秒数60reasoning是否启用推理模式false注意model_name 要填平台支持的模型标识填错会导致调用失败。千问系列常用 qwen-plus、qwen-turbo、qwen-max。3.5 启动网关服务配置写好后启动openclaw gateway start查看状态openclaw gateway status如果要在本地访问 Web 控制台浏览器打开http://127.0.0.1:187894. 验证请求与成功结果4.1 检查服务状态启动后先确认网关在运行openclaw gateway status正常输出会显示 running 状态和监听端口。4.2 查看日志如果启动异常看日志openclaw logs --follow日志里会显示模型配置加载情况、API 请求状态、错误信息。4.3 发一条测试指令打开 Web 控制台http://127.0.0.1:18789在对话框输入你好请用一句话介绍你自己如果配置正确千问模型会返回响应。如果返回为空检查 config.toml 里reasoning是否设为 false然后重启服务openclaw gateway restart4.4 用 curl 直接验证 API 通道如果你想单独验证 TaoToken 通道是否通可以用 curlcurl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的API_Key \ -H Content-Type: application/json \ -d { model: qwen-plus, messages: [{role: user, content: 你好}], max_tokens: 100 }如果返回 JSON 里有 choices 字段和内容说明通道正常。如果返回 401检查 API Key返回 404检查 base_url 和路径。4.5 模型对话入口如果你想直接在 TaoToken 的模型对话页面测试千问可以访问https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite5. 本篇常见报错排查5.1 openclaw: command not found原因npm 全局安装路径不在 PATH或者安装没成功。处理npm install -g openclaw然后关闭终端重新打开再执行openclaw --version。如果还不行检查 npm 全局路径npm config get prefix把输出的路径加到系统 PATH 里。5.2 服务启动后自动关闭原因内存不足或配置错误。处理本地机器关闭占用资源大的程序服务器建议内存 ≥ 2GB。查看日志定位openclaw logs5.3 无法访问 Web 控制台检查顺序服务是否启动openclaw gateway status端口是否被占用# Linux/macOS lsof -i:18789 # Windows netstat -ano | findstr 18789如果端口被占用杀掉进程或改端口openclaw config set gateway.port 18790 openclaw gateway restart本地访问用http://127.0.0.1:18789不要用公网 IP。5.4 模型调用失败或权限不足检查API Key 是否正确复制有没有多余空格账号是否完成实名认证百炼平台需要调用额度是否充足model_name 是否填写正确base_url 是否和 key 对应TaoToken 的 key 配 TaoToken 的 base_url5.5 AI 回复为空在 config.toml 的 model 段加reasoning false然后重启openclaw gateway restart5.6 响应超时调整参数timeout 60 max_tokens 1024降低 max_tokens 可以减少单次生成时间增大 timeout 给模型更多响应时间。5.7 配置文件写入权限不足Linux/macOS 下如果提示权限不足sudo chown -R $USER ~/.openclaw或者重新初始化openclaw onboard --reset5.8 Windows 执行策略禁止运行脚本以管理员身份打开 PowerShellSet-ExecutionPolicy RemoteSigned -Scope CurrentUser6. 长期编码与 Agent 场景的配置建议如果你打算把 OpenClaw 当作长期运行的编码助手或 Agent 来用有几个配置建议第一把 gateway 设为开机自启。Linux 下可以写进 rc.localecho /usr/bin/openclaw gateway start | sudo tee -a /etc/rc.local sudo chmod x /etc/rc.local第二如果你需要频繁调用模型做代码生成、Agent 任务编排可以关注 TaoToken 的 Coding Plan按次计费比按 token 计费更适合高频调用场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite第三Skills 扩展按需安装。常用技能npm install -g clawhub clawhub install tavily-search clawhub install summarize clawhub install agent-browser安装后重启网关加载openclaw gateway restart查看已安装技能openclaw skill list第四配置文件建议用 TaoToken 统一通道这样后续换模型只需要改 model_name不用动 base_url 和 key。接入文档参考https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite控制台地址https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite如果你用 Claude Code 或 Anthropic 风格的接口做 Agent 开发TaoToken 也提供对应的接入方式https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_anthropicutm_campaignrewrite整个流程走下来本地部署 OpenClaw 加千问模型的核心就是三步Node.js 环境准备好、config.toml 写对、gateway 启动后验证。报错集中在版本不对、key 配错、端口占用这三类按上面的排查顺序基本都能解决。