1. 为什么要在 Ubuntu 上用微信遥控 OpenClawOpenClaw 是一个能在本机执行命令、读写文件、跑自动化脚本的智能体框架而微信几乎是我们每天打开次数最多的 App。把这两者接起来等于给电脑装了一个随身遥控器你在外面发一句「帮我看看服务器内存」家里的 Ubuntu 机器就真的去执行free -h并把结果回给你。整个过程不需要你写一行业务代码核心工作只有两件——把 OpenClaw 跑起来把微信入口和模型鉴权打通。这篇教程聚焦 Ubuntu 环境用 npm 全局安装 OpenClaw再通过 ClawBot 插件把微信变成消息入口最后用 TaoToken 的统一 Key 和 API 通道解决 ClawBot 与模型服务之间的鉴权配置问题。适合谁有台常开的 Ubuntu 机器云主机或家里的小主机都行、会用终端敲命令、想让微信直接指挥电脑干活的同学。全程零代码配置骨架我会直接给你可复制的config.toml和settings.json照着填就能跑。需要提前说清楚一个概念OpenClaw 本身不生产模型能力它是个「调度中枢」真正干活的是背后的大模型。所以链路是「微信 → ClawBot 桥接 → OpenClaw → 模型 API」。这条链路里最容易翻车的就是最后一跳的鉴权也就是模型服务认不认你的 Key。下面我会把这一跳单独拆开讲。2. 前置准备Ubuntu 环境与 TaoToken 统一 Key2.1 基础环境检查先确认你的 Ubuntu 版本和 Node 环境。OpenClaw 走 npm 分发Node 版本太低会在安装阶段就报错。我实测下来 Node 20 LTS 最稳。# 查看系统版本 lsb_release -a # 查看 Node 与 npm 版本建议 Node 20 node -v npm -v如果 Node 版本低于 18先升级。用 nvm 管理最省心curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 20 nvm use 202.2 全局安装 OpenClawnpm install -g openclawlatest # 验证安装 openclaw --version看到版本号输出就说明装好了。如果提示command not found多半是 npm 全局 bin 目录没进 PATH执行npm config get prefix看看路径再把它加到~/.bashrc里。2.3 为什么用 TaoToken 统一 KeyClawBot 桥接层和 OpenClaw 主进程都要访问模型服务如果各自配一套 Key改起来很痛苦。TaoToken 提供统一的 API 通道一个 Key 就能覆盖对话、编码等多种模型调用场景配置时只需要维护一处鉴权信息。对小白来说最大的好处是不用去研究各家模型服务商的鉴权差异填一个地址加一个 Key 就完事。先去控制台把 Key 建出来地址是 https://taotoken.net/api-keys 登录后新建一个 Key 并复制保存。API 基础地址统一用 https://taotoken.net/api 注意这个地址后面不加任何多余路径OpenClaw 会自己拼接。注意Key 只在创建时完整显示一次务必先存到安全的地方。不要把它提交到 Git 仓库也不要在截图里露出。3. 可复制配置config.toml 与 settings.json 骨架OpenClaw 的配置分两层主进程读config.tomlClawBot 桥接插件读settings.json。两个文件都要指向 TaoToken 的通道这样鉴权才一致。3.1 主进程 config.toml配置文件默认放在~/.openclaw/config.toml没有就手动建mkdir -p ~/.openclaw nano ~/.openclaw/config.toml把下面这份骨架粘进去把api_key换成你自己的# OpenClaw 主配置 [server] host 127.0.0.1 port 8787 [model] # 统一走 TaoToken 通道 provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model claude-sonnet-4-20250514 timeout 120 [agent] # 允许执行本地命令微信指令会走这里 allow_shell true work_dir /home/你的用户名 max_steps 15 [log] level info file /home/你的用户名/.openclaw/openclaw.log几个参数说明一下。base_url必须是https://taotoken.net/api不要自己加/v1之类的后缀兼容层会处理。allow_shell打开后微信发来的指令才能落到终端执行如果你只想让它读文件可以设成 false。max_steps控制单次任务最多执行多少步防止一个指令触发无限循环。3.2 ClawBot 桥接 settings.json桥接插件单独读自己的配置路径在~/.openclaw/plugins/weixin/settings.jsonmkdir -p ~/.openclaw/plugins/weixin nano ~/.openclaw/plugins/weixin/settings.json内容如下{ bridge: { enabled: true, listen_port: 8790, openclaw_endpoint: http://127.0.0.1:8787 }, auth: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514 }, wechat: { bot_name: ClawBot, reply_timeout: 90, allow_groups: false } }这里auth段和主配置保持一致都用同一个 TaoToken Key。openclaw_endpoint指向主进程的 8787 端口桥接层收到微信消息后转发给它。allow_groups建议先设 false只允许私聊避免群里误触发。提示两个文件里的 Key 必须相同否则会出现「主进程能跑、微信没反应」的诡异现象这是最常见的鉴权不一致问题。4. 部署 ClawBot 桥接并验证消息回环4.1 安装微信桥接套件配置写好后用官方 CLI 一键安装并初始化桥接套件npx -y tencent-weixin/openclaw-weixin-clilatest install这条命令会自动拉取桥接依赖、读取你刚才写的settings.json并注册到 OpenClaw 的插件目录。执行完看到plugin registered: weixin就对了。4.2 启动 OpenClaw 主进程openclaw start前台启动方便看日志。确认输出里有server listening on 127.0.0.1:8787和plugin weixin loaded。如果插件没加载检查settings.json的 JSON 格式多一个逗号都会导致解析失败。4.3 扫码绑定微信桥接启动后终端会输出一个字符二维码。打开微信依次进入「我 → 设置 → 插件」找到 ClawBot 卡片红色龙虾图标点进去按提示扫描终端二维码手机端确认授权。成功标志有两个终端显示Successfully bound to WeChat: 你的昵称同时微信通讯录里出现一个叫 ClawBot 的联系人。4.4 验证请求发第一条远程指令在微信 ClawBot 对话框里发送你好请告诉我当前系统的运行内存占用情况。正常情况下几秒后你会收到类似这样的回复当前内存总 15.6 GiB已用 4.2 GiB可用 11.4 GiB占用约 27%。这说明「微信 → 桥接 → OpenClaw → TaoToken 通道 → 模型 → 回传」整条链路通了。如果想让验证更直观可以再发一条「在 /tmp 下创建一个 test.txt 并写入 hello」然后去 Ubuntu 上cat /tmp/test.txt确认文件真的生成了。5. 本篇常见错排查清单接入过程里报错基本集中在鉴权和端口两类下面按现象给排查动作。5.1 微信发消息没反应先看主进程日志~/.openclaw/openclaw.log。如果日志里出现401 Unauthorized或invalid api key说明 TaoToken Key 填错了或者两个配置文件不一致。核对config.toml和settings.json里的api_key是否完全相同注意别把首尾空格带进去。如果日志里根本没有收到请求那是桥接层没转发成功。检查settings.json里的openclaw_endpoint是不是http://127.0.0.1:8787以及主进程是否真的在监听这个端口ss -tlnp | grep 87875.2 报错 model not found这是模型名写错了。model字段要填 TaoToken 通道支持的模型标识别自己编。如果拿不准先去模型对话页面确认可用模型列表地址是 https://taotoken.net/models 把页面上显示的模型名原样填进配置。5.3 桥接插件加载失败现象是启动时提示plugin weixin not found。多半是settings.json格式错误。用下面这条命令校验 JSONpython3 -m json.tool ~/.openclaw/plugins/weixin/settings.json能正常输出格式化内容就说明格式没问题报错就按提示的行号去改。5.4 指令执行超时微信侧等了很久没回复日志里显示timeout。把config.toml里的timeout从 120 调大到 180同时把max_steps降到 10 以内。复杂任务拆成几条简单指令发比一条长指令更稳。5.5 端口被占用启动报address already in use说明 8787 或 8790 被别的进程占了。查一下是谁lsof -i :8787要么杀掉占用进程要么把配置里的端口改成 8887、8890 这类不冲突的。6. 长期编码与 Agent 场景的通道选择如果你只是偶尔用微信查个内存、建个文件上面这套配置就够了。但如果你打算把 OpenClaw 当成长期的编码助手或自动化 Agent频繁跑多步任务那按量计费的通道在成本上不太划算。这种场景更适合用 Coding Plan 这类包月方案配合 OpenClaw 的 Agent 模式跑长任务不用担心每一步都产生调用费用。配置方式不变还是同一个 API 地址只是把 Key 换成 Coding Plan 对应的凭证。切换后config.toml和settings.json里的base_url保持https://taotoken.net/api不动只改api_key即可。想了解具体方案可以去 https://taotoken.net/coding-plan 看说明。最后留一个我踩过的坑改完配置一定要重启 OpenClaw 主进程桥接插件不会热加载settings.json。很多人改完 Key 发现没生效就是因为只重启了桥接没重启主进程。养成「改配置 →openclaw stop→openclaw start」的习惯能省掉一大半莫名其妙的排查时间。