1. 为什么要在本地跑 OpenClaw而不是直接买服务器OpenClaw 是一个开源的 AI 自动化助理平台能接钉钉、接大模型、跑定时任务、处理群消息适合想把自己工作流里重复动作交给 AI 的人。2026 年 4 月这个时间点很多人第一反应是去云上开一台轻量服务器但如果你只是想先跑通、先验证模型能不能用、先看看钉钉机器人回不回消息本地搭建其实更快——不用等实例创建不用配安全组不用纠结地域4 分钟能跑起来。我自己的做法是本地先跑通确认 OpenClaw 的 config.toml 写对了、百炼 API Key 能调通、钉钉通知能收到再决定要不要搬到云上做 7×24 常驻。这样踩坑成本最低因为本地出问题你能直接看日志、改配置、重启不用远程连终端。这篇就按这个思路写本地部署 OpenClaw接阿里云百炼的 API Key配钉钉通知最后给启动验证和常见报错排查。全程命令可复制零代码基础也能跟。适合谁想快速验证 OpenClaw 能力的开发者、想把钉钉群接上 AI 助理但还没决定上不上云的人、以及被云服务器地域和端口问题卡过的人。2. 前置准备百炼 API Key 和本地环境2.1 拿到百炼 API KeyOpenClaw 本身不带模型它需要你给它一个能调用的模型接口。阿里云百炼提供兼容 OpenAI 协议的接口OpenClaw 可以直接用。去阿里云百炼控制台进「密钥管理」创建一个 API Key格式是sk-xxxx。复制下来后面填进 config.toml。注意别带空格和换行这是后面报错最多的地方。如果你打算长期跑编码类任务可以看下百炼的 Coding Plan按次计费比按 token 更适合高频调用场景。入口在百炼控制台的订阅区具体价格以控制台为准我不在这里编数字。2.2 本地环境要求本地跑 OpenClaw 对机器要求不高但有两条硬线Node.js 22 及以上。OpenClaw 2026 版依赖 Node 22 的某些特性低版本会启动失败。内存至少 2GiB 可用。低于这个数网关服务起来后会 OOM。检查命令node -v # 期望输出 v22.x.x 或更高 free -h # Linux 看 available 列macOS 用 vm_stat如果 Node 版本不够用 nvm 装一个nvm install 22 nvm use 222.3 关于 TaoToken 的接入位置OpenClaw 的模型层支持自定义 baseUrl所以你可以把模型请求指向 TaoToken 的兼容接口再由它转发到百炼。这样做的好处是本地配置里只维护一个 key换模型不用改 OpenClaw 的代码。TaoToken 的 API 地址是https://taotoken.net/api接入文档在https://taotoken.net/doc。API Key 在控制台生成https://taotoken.net/console密钥管理页在https://taotoken.net/api-keys。如果你更想直接用百炼原生接口也可以config.toml 里把 baseUrl 换成百炼的兼容地址即可。两种方式下面都会给。3. 可复制的 config.toml 骨架OpenClaw 的配置文件默认在~/.openclaw/config.toml。如果目录不存在先建mkdir -p ~/.openclaw cd ~/.openclaw然后创建 config.toml。下面这份是完整骨架你只需要替换三个地方API Key、钉钉凭证、模型名。# ~/.openclaw/config.toml [gateway] port 18789 host 127.0.0.1 log_level info [models] default bailian/qwen3-max-2026 [models.providers.bailian] baseUrl https://dashscope.aliyuncs.com/compatible-mode/v1 apiKey sk-你的百炼APIKey models [ { id qwen3-max-2026, maxTokens 65536 }, { id qwen3.5-plus, maxTokens 8192 } ] # 如果走 TaoToken 转发用下面这段替换上面的 bailian 段 # [models.providers.taotoken] # baseUrl https://taotoken.net/api # apiKey 你的TaoTokenKey # models [ # { id qwen3-max-2026, maxTokens 65536 } # ] [channels.dingtalk] enabled true clientId 你的钉钉ClientID clientSecret 你的钉钉ClientSecret prefix ! [skills] autoLoad true几个关键点说明gateway.host本地跑就写127.0.0.1别写0.0.0.0否则同网络下别人能访问你的面板。等你确认要对外再改。models.default的格式是provider/modelIdprovider 名要和下面[models.providers.xxx]的段名一致。写错了会报provider not found。channels.dingtalk.prefix是触发前缀默认!。如果你钉钉群里已经有别的机器人用!改成$或/避免冲突。钉钉的 Client ID 和 Client Secret 在钉钉开放平台创建应用后在「凭证与基础信息」里拿。权限至少要开这三个Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg。少一个机器人就发不出消息。4. 启动、验证与成功结果4.1 安装与启动如果你还没装 OpenClawnpm install -g openclaw然后启动网关openclaw gateway start --daemon--daemon是后台运行本地验证阶段也可以不加直接前台跑方便看日志。前台跑的话另开一个终端做验证。检查状态openclaw gateway status期望输出里有active (running)。如果是failed跳到第 5 节排查。4.2 验证模型调用先测模型通不通openclaw model test这个命令会用 config.toml 里的 default 模型发一条测试请求。成功的话会返回模型回复内容。如果报401或invalid api key检查 apiKey 有没有多余空格。再测网关本身curl http://127.0.0.1:18789/health返回{status:ok}就说明网关活着。4.3 生成访问 Token 并打开面板openclaw token generate复制输出的 Token浏览器打开http://127.0.0.1:18789?token你的Token进去后发一条「帮我总结 OpenClaw 本地部署步骤」能正常回复就说明模型链路通了。4.4 验证钉钉通知在钉钉群里添加你创建的机器人发送!你好机器人回复即接入成功。如果没反应先看openclaw logs -f里有没有钉钉相关的错误。5. 本篇常见报错排查5.1 启动报EADDRINUSE: address already in use :18789端口被占了。查一下谁在用lsof -i :18789如果是上次没退干净的 OpenClaw 进程杀掉kill -9 PID或者改 config.toml 里的gateway.port换个端口。5.2 模型报provider not foundmodels.default里的 provider 名和[models.providers.xxx]段名不一致。比如你写default bailian/qwen3-max-2026那下面必须是[models.providers.bailian]不能写成[models.providers.aliyun]。5.3 模型报401 Unauthorized三种可能API Key 复制时带了空格或换行Key 被禁用或欠费baseUrl 写错。先手动重新粘贴一次 Key确认没有首尾空白。百炼的兼容地址是https://dashscope.aliyuncs.com/compatible-mode/v1注意结尾的/v1不能少。5.4 钉钉机器人不回复按顺序查权限是否开全。去钉钉开放平台「权限管理」确认Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg三个都在。凭证是否正确。Client ID 和 Client Secret 重新复制一次注意别把 Secret 里的特殊字符漏掉。配置改完是否重启。改 config.toml 后必须openclaw gateway restart不重启不生效。前缀是否冲突。群里如果已经有!开头的机器人把你的 prefix 改成$。5.5 日志里出现dingtalk stream connect failed这是钉钉长连接没建起来。通常是网络问题或凭证错误。先确认 Client ID/Secret 对再看本机能不能访问钉钉开放平台的接口。如果本地网络有限制换到能正常访问的环境再试。5.6 内存不足导致服务被杀openclaw logs -f里如果看到Killed或out of memory说明内存不够。本地跑至少留 2GiB 可用内存。关掉一些占内存的程序或者把models里的大模型换成小一点的。6. 接下来怎么走本地跑通之后你手里应该有一个能对话、能接钉钉的 OpenClaw 实例。下一步通常是两个方向一是把它搬到云上做常驻二是接更多技能。搬云上的话重点注意地域和端口放行本地这套 config.toml 可以直接带过去改一下gateway.host就行。接技能的话OpenClaw 有 ClawHub 生态常用的一键装npm install -g clawhub-cli clawhub install search clawhub install document-parser clawhub install summarize openclaw gateway restart如果你在配 API Key 或接钉钉时卡住可以直接看 TaoToken 的接入文档https://taotoken.net/doc里面有兼容接口的完整参数说明。密钥管理在https://taotoken.net/api-keys控制台在https://taotoken.net/console。想先验证模型对话效果用https://taotoken.net/models试一条请求最快。长期跑编码和 Agent 任务的话Coding Plan 的入口在https://taotoken.net/coding-plan按次计费比按 token 更适合高频场景。本地这套配置我用了两周最常改的就是models.default那一行——换模型只动一个字段不用碰其他配置。这个设计比很多同类工具省心建议你也保持这个习惯别把模型名硬编码到技能脚本里。