OpenClaw

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. 推荐怎么安装？ 对大多数新手，官方推荐路线很明确： ...

很多人刚把 OpenClaw 跑起来的时候，关注点都在“能不能用”。等真正开始高频使用，第二个问题马上就会冒出来： 怎么省 token，怎么省钱。 这不是抠门，而是现实。尤其你一旦开始接 Telegram、开多 agent、装 skills、做网页搜索，模型调用频率会明显上升。OpenClaw 本身很强，但强也意味着你更需要会做分层配置。 我自己的核心思路就一句话： 别让最贵的模型去干最便宜的活。 OpenClaw 在这方面其实挺有优势，因为它不是只绑定一个模型。它本来就是一个面向多 provider、多 agent、多工具协作的框架。只要你思路理顺，完全可以把“不同任务交给不同模型”这件事做得很自然。 一、先接受一个现实：不是所有问题都需要最强模型 有些任务，真的不值得上旗舰模型。 比如： 把一句话润色一下 提取一个列表 总结 200 字短文本 改一个标题 判断这是不是待办事项 这些任务对推理深度要求不高，用便宜模型通常就够。 真正该上强模型的，通常是： 多步骤复杂推理 长上下文整合 需要谨慎判断的写作或方案设计 多 agent 最终汇总 高风险内容审核 这一点，和 OpenClaw 的官方 sub-agents 文档思路也是一致的：重任务和重复任务，子 agent 可以用更便宜的模型，主 agent 保持更高质量的模型。 二、OpenClaw 为什么天然适合做模型分层 1）它有多 provider 思路 OpenClaw 的插件体系里，官方列出的模型 provider 很多，包括 OpenAI、Anthropic、Google、OpenRouter、Mistral 等等。也就是说，从架构上它就不是单模型思维。 2）它有多 agent 思路 你完全可以让： 主 agent：用强模型 子 agent：用便宜模型 某些特殊任务：临时覆盖模型 这种分层在 OpenClaw 里很顺，不是硬拗出来的。 3）skills 和工具也会影响 token 官方 skills 文档专门提到 skills 列表本身就会有 token 影响。换句话说，省 token 不只是“换便宜模型”，还包括： ...

很多人第一次听到“多 agent 协作”，脑子里会自动出现一种很玄乎的画面：几个 AI 在后台自己讨论、自己分工、自己交付，好像一个数字公司一样。 OpenClaw 这套东西，确实支持往这个方向走，但我想先泼一盆冷水：多 agent 不是越多越高级，也不是一上来就该开。 单 agent 足够的时候，别为了炫技硬拆。因为一旦进入多 agent，意味着更多会话、更多上下文、更多 token 开销，还有更多排错成本。 但反过来说，如果你的任务本来就天然适合分工，比如： 一个负责搜资料 一个负责写初稿 一个负责校对 那 OpenClaw 的多 agent 机制就非常有价值。 官方文档里，至少已经明确了几层能力：Sub-agents、按 agent 划分的工作区、以及更进一步的 agent-to-agent / 多 agent 协作路线**。这不是概念 PPT，而是实打实能用来拆任务的。** 一、先搞懂最核心的结构 你可以先把 OpenClaw 的多 agent 理解成三层： 1）主 agent 主 agent 就是对外接消息的那个“总控”。 它负责： 接收用户请求 判断这个任务要不要拆 决定交给谁做 最后汇总结果返回给你 2）子 agent（Sub-agent） 子 agent 是主 agent 临时拉起来的后台执行者。官方文档明确说，它们会在独立 session 里运行，任务结束后再把结果 announce 回来。 这点非常关键：独立 session = 相对独立的上下文。这样做的好处是，一个子任务不会把主会话弄得越来越臃肿。 3）更深一层的嵌套 OpenClaw 默认子 agent 不能再继续无限生孩子，默认 maxSpawnDepth: 1。如果你主动把配置调到 2，就能支持“主 agent → 协调型子 agent → 工作者子 agent”这种模式。 ...

如果说 OpenClaw 部署完成只是“把大脑装好了”，那接入 Telegram，才算真正把这个大脑装进你每天都会用的入口里。 我现在越来越喜欢这种用法：白天在电脑上开 Dashboard 调试，出门之后直接在 Telegram 里给 AI 发消息。查天气、记提醒、整理任务、问点资料，全部都能在手机上完成。对个人用户来说，这种体验比单纯守着网页聊天实用太多了。 而且 Telegram 这条线，也是 OpenClaw 官方文档里明确标注为生产可用的 Bot API 通道，DM 和群组都支持，默认用长轮询，配置门槛不高。 这篇就讲怎么把它接起来。 一、为什么先接 Telegram 我建议新手第一条外部通道就选 Telegram，原因很简单： 不需要复杂审核 只要一个 Bot Token 就能开始 手机上随时能发消息给你的助手 官方文档完整，排错路径也清楚 OpenClaw 官方 Getting Started 里也提到，想从手机上最快速聊天，Telegram 是最容易上手的一条线路。 二、先去 Telegram 里创建机器人 打开 Telegram，搜索 @BotFather。注意一定要确认账号就是官方那个 @BotFather，别加错。 然后按顺序操作： 发送 /newbot 给机器人起一个展示名 给机器人起一个唯一用户名，通常以 bot 结尾 保存它返回给你的 Bot Token 这个 Token 很重要，相当于机器人密码。别随手贴到公开群里，也别直接发给别人。 截图建议 这里最适合放两张图： BotFather 创建完成后返回 Token 的页面 你搜索到自己 bot 账号的页面 很多读者看到这两张图，理解速度会快很多。 三、在 OpenClaw 里配置 Telegram 根据官方 Telegram 文档，Telegram 不走那种 channels login 的交互式登录，而是直接在配置里放 botToken，然后启动 Gateway。 ...

很多人第一次接触 OpenClaw，会先被“AI agent”“Gateway”“多通道”这些词吓到。其实真上手之后你会发现，它并不是那种必须先读三天文档、再折腾半天 Docker 才能跑起来的项目。按照官方现在的安装路线，普通用户在一台干净的 Linux 服务器上，确实可以很快把它跑起来。 这篇文章我就按纯小白视角来写：从买服务器开始，到 OpenClaw 成功启动、打开控制面板、发出第一条消息为止。你不需要预先懂多 agent，也不需要先配置一堆花里胡哨的插件。先跑起来，才是第一步。 一、先准备什么 最基本只要三样： 一台 Linux 服务器 一个模型 API Key 一台你能打开浏览器的电脑 根据 OpenClaw 官方 Getting Started 文档，目前推荐环境是 Node 24，Node 22.14+ 也可以。官方安装脚本会尽量帮你处理依赖，这对新手很友好。 服务器方面，我建议直接买最普通的 Ubuntu 24.04 机器就行。别一上来追求高配置。OpenClaw 自己并不吃显卡，它更像一个“AI 助手调度器”，真正烧钱的是你后面接的模型。 如果你只是自己用，2 核 4G、带公网 IP 的小机器就够起步了。 二、买完服务器后先做这几步 登录服务器后，先更新系统： sudo apt update && sudo apt upgrade -y 然后确认系统没问题： uname -a lsb_release -a 如果你是刚买的云服务器，建议顺手做两件事： 设置一个普通用户，别长期用 root 在控制台安全组里先只放行 SSH 和你后面要访问的端口 不过如果你只是想先体验，直接用 root 也不是不行，先把流程走通再说。 三、安装 OpenClaw 官方目前最省事的安装方式，是直接用安装脚本： curl -fsSL https://openclaw.ai/install.sh | bash 这一条命令的好处是简单。对新手来说，不需要你自己先研究 npm、全局路径、服务管理这些细节。 ...