🦞 OpenClaw 汉化版 · 完整踩坑与解决手册 @qingchencloud/openclaw-zh · 2026.3

❌ 无效尝试 反复 doctor --fix、重装 node_modules、手动改权限未发布版本。

✅ 最终有效方案

• 删除旧插件目录：Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw\extensions\feishu-openclaw-plugin"
• 编辑 openclaw.json，删除 installs 中的 "feishu": {...} 整个条目。
• 飞书后台 → 权限管理 → 批量开通 im:message, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:message:send_as_bot → 创建新版本并发布。
• 事件订阅 → 改为“长连接”，添加 im.message.receive_v1 事件 → 再次发布版本。
• 私聊机器人获取配对码，用 openclaw pairing approve feishu <配对码> 批准。

❌ 无效尝试 反复开关长连接、重新安装插件、修改配置文件未清理残留。

✅ 最终有效方案 同“升级后飞书无响应”方案，确保旧插件清理 + 权限发布 + 长连接配置。配对命令：openclaw pairing approve feishu <配对码>。

❌ 无效尝试 重装服务、修改计划任务权限、设置环境变量、用 nssm 注册服务均因中文路径失败。

✅ 最终有效方案

• 使用目录联接 (junction) 将 C:\Users\张硕\.openclaw 指向 D:\openclaw（无中文路径）。
• 放弃计划任务，改用 VBS + PowerShell 隐藏窗口启动：
  

  CreateObject("Wscript.Shell").Run "powershell -WindowStyle Hidden -ExecutionPolicy Bypass -File D:\openclaw\Start-OpenClaw.ps1", 0, False

• Start-OpenClaw.ps1 内容：openclaw gateway run
• 将 VBS 放入启动文件夹 (shell:startup)，开机自启无窗口。

❌ 无效尝试 设置 OPENAI_BASE_URL 环境变量、修改 auth-profiles.json、尝试 provider: "local" 均失败。

✅ 最终有效方案 升级到 @qingchencloud/openclaw-zh (2026.3.13+)，原生支持 ollama。配置：

"memorySearch": {
  "provider": "ollama",
  "ollama": {
    "baseUrl": "http://127.0.0.1:11434",
    "model": "nomic-embed-text"
  }
}

❌ 无效尝试 尝试 @_ou_xxx、XML 格式、广播模式均无效。

✅ 最终有效方案 主模型通过 exec 工具直接调用其他 Agent：

openclaw agent --agent coder --message "任务描述"

在主模型 AGENTS.md 中说明使用方式，并在群内回复“我将安排程序员处理”，后台执行命令。

❌ 无效尝试 反复重启网关、改 bind 模式、检查 token、重装软件。

✅ 最终有效方案 关闭 Tailscale Serve 后再运行 CLI。Serve 作为代理会干扰 CLI 直连，关闭后 CLI 立即恢复正常。

❌ 无效尝试 直接用 http://电脑TailscaleIP:18789 访问，Safari 报“不安全”，WebSocket 被拒；换用 Chrome 等第三方浏览器同样被系统级拦截。

✅ 最终有效方案 使用 Tailscale Serve 提供 HTTPS 代理：tailscale serve --https=8777 http://127.0.0.1:18789，手机访问 https://电脑名.ts.net:8777。证书警告点“高级”→“继续”。

❌ 无效尝试 反复修改 allowedOrigins、添加 trustedProxies、临时关闭认证、刷新页面均无效。

✅ 最终有效方案 必须先通过 CLI 批准设备：

1. 关闭 Tailscale Serve（否则 CLI 连不上）。
2. 运行 openclaw devices list → 看到待批准设备 → openclaw devices approve <ID>。
3. 重新开启 Tailscale Serve。
4. 手机再次访问 HTTPS 地址，直接弹出 token 输入框（不再 pairing required）。
5. 输入网关 token 进入 ClawApp。

❌ 无效尝试 尝试 tailscale serve --bg 或修改端口，均无法让 CLI 同时连接。

✅ 最终有效方案 牢记铁律：批准设备时关闭 Serve，批准后再打开 Serve。这是打通手机访问的关键步骤。

❌ 无效尝试 单独改 loopback 导致手机无法访问；allowedOrigins 只写 IP 不写域名；忘记加 trustedProxies 导致代理头不被信任。

✅ 最终正确配置

{
  "gateway": {
    "bind": "lan",                // 必须监听所有接口，Serve 才能代理
    "port": 18789,
    "auth": { "mode": "token", "token": "你的令牌" },
    "controlUi": { "allowedOrigins": ["*"] },   // 避免跨域，Tailscale 网络内安全
    "trustedProxies": ["127.0.0.1", "::1", "100.64.0.0/10"]  // 信任 Tailscale 代理头
  }
}

电脑本地访问：http://127.0.0.1:18789；手机远程访问：https://电脑名.ts.net:8777。

1️⃣ 网关配置（openclaw.json 按上述最终配置）

2️⃣ 启动脚本（VBS 无窗口，开机自启）

CreateObject("Wscript.Shell").Run "powershell -WindowStyle Hidden -ExecutionPolicy Bypass -File D:\openclaw\Start-OpenClaw.ps1", 0, False
CreateObject("Wscript.Shell").Run "tailscale serve --https=8777 http://127.0.0.1:18789", 0, False

Start-OpenClaw.ps1 内容：openclaw gateway run

3️⃣ 首次配对（一次性）

1. 关闭 Tailscale Serve（停止窗口或运行 tailscale serve --https=8777 off）。
2. 在电脑运行 openclaw devices list → 看到待批准设备 → openclaw devices approve <ID>。
3. 重新开启 Tailscale Serve。
4. 手机访问 https://你的电脑名.ts.net:8777 → 输入网关 token → 进入 ClawApp。

4️⃣ 日常使用：手机直接访问 HTTPS 地址（浏览器记住 token），电脑启动后自动运行 Serve 和网关。