FAQ

OpenClaw 真正折腾人的阶段，往往不是安装，而是"明明已经跑起来了，但就是不正常"。比如 Gateway 服务在、消息不回;Telegram 连上了、群里却装死;Skills 明放进去了,就是不加载;Token 一晚上烧得飞快;升级之后又突然冒出 pairing required。 这篇专门写给已经在用 OpenClaw 的人。内容基于官方排障文档、官方 FAQ、GitHub Issues 和社区讨论里反复出现的真实故障场景整理,尽量给你一套能直接照着走的排查顺序。 先记住一个总排查顺序 别一出问题就重装。官方文档给的排查梯子其实很实用,优先跑这几步: openclaw status openclaw gateway status openclaw logs --follow openclaw doctor openclaw channels status --probe 很多问题走到第 3 步就已经能定位了。 1. Gateway 起不来,先看什么? 先看 openclaw gateway status。 如果不是 Runtime: running,重点看三类问题: 配置不对 端口冲突 服务和 CLI 用的不是同一份配置 官方文档明确提到,常见报错包括: Gateway start blocked: set gateway.mode=local refusing to bind gateway ... without auth another gateway instance is already listening EADDRINUSE 结论很简单:别一上来删目录,先确认模式、绑定、认证和端口。 2. EADDRINUSE 是什么情况? 就是端口被占了。 这类问题在 GitHub Issues 里很常见,既可能是旧 Gateway 没退干净,也可能是浏览器 relay、插件子进程、Windows 重启残留进程把端口占住了。社区里甚至有人是旧的 clawdbot-gateway.service 还在跑,和新服务抢同一个端口。 排法: ...

很多人是看了演示视频，觉得 OpenClaw 很强，就直接上 VPS、接 Telegram、装技能、开多 Agent。结果第一天就踩坑：端口占用、模型没配好、远程控制台连不上、Token 花得比想象快，最后怀疑是不是自己姿势不对。 这篇就是给“还没装”的人看的。问题都不是我凭空编的，而是结合 OpenClaw 官方 FAQ、官方排障文档、GitHub Issues 和社区讨论里反复出现的真实疑问整理出来的。你先把这 20 个问题看完，再决定怎么装，能少走很多弯路。 1. OpenClaw 到底适合谁？ 适合愿意自己配环境、自己管服务的人。不适合想“点一下就永远不用管”的纯托管型用户。 OpenClaw 的强项是：可自托管、能接多渠道、支持工具、技能、记忆、多 Agent 和节点扩展。但代价也很明显：你得理解 Gateway、模型配置、渠道权限、配对和基本排障逻辑。 2. 我需要什么机器配置？ 起步要求并不高。官方 FAQ 明确提到，个人使用场景下，Gateway 轻量，512MB 到 1GB 内存、1 核、约 500MB 磁盘就能跑，树莓派 4 也可以。 但实际建议是：至少 1C2G。原因很简单，除了 OpenClaw，本机通常还会跑日志、反向代理、监控、浏览器或别的工具。2GB 内存更稳，不容易一更新就卡死。 3. 一定要买 VPS 吗？ 不一定。 你有三种常见路线： 本地电脑长期开机 树莓派/迷你主机常驻 云服务器/VPS 如果你主要是自己私用、偶尔调试，本地或树莓派就够了。要稳定在线、想随时远程访问，VPS 更省心。很多人踩坑，不是 OpenClaw 本身难，而是先上了太便宜太弱的机器，后面渠道、代理、浏览器都堆上去后开始不稳。 4. Node 版本有要求吗？ 有，而且别忽略。 官方 FAQ 写得很清楚：Node >= 22。pnpm 推荐，Bun 不推荐拿来跑 Gateway。社区里“装完起不来”“命令能跑服务不稳”这类问题，最常见前置原因之一就是运行时版本不对。 5. 推荐怎么安装？ 对大多数新手，官方推荐路线很明确： ...