1. 刚装完 OpenClaw 就懵了命令到底该敲哪一条OpenClaw圈内叫“大龙虾”是一个把大模型能力接到聊天渠道里的网关型工具它能让你在飞书、QQ-Bot 这类日常聊天窗口里直接和模型对话也能挂上 skills 做自动化。适合谁适合刚在云服务器或本地虚拟机里跑起来、但面对一堆openclaw xxx命令不知道从哪下手的新手。我自己第一次装完盯着终端里那串提示最想问的就是网关到底起没起模型换哪个渠道为啥不回消息这篇不铺开讲原理只解决一件事把日常 90% 会用到的命令和配置项一次摸透。核心检索词就三个——OpenClaw 命令、model 配置、channels 排查。你跟着敲一遍网页打不开、发消息没反应、报 401 这类问题基本能自己定位。先说清楚 OpenClaw 的运行模型不然后面命令会记混。它分两层一层是网关服务gateway常驻后台负责收发消息、调模型另一层是安装向导onboard负责初始化配置。你改完模型或渠道必须重启网关才生效这是新手最容易漏的一步。很多人改完配置发现没变化就是因为网关还在跑旧配置。命令的记忆逻辑可以这样分onboard管初始化gateway管服务生命周期config管单项配置status/logs管排查dashboard管看界面。把这五组记住剩下的都是参数问题。下面从最该先跑的一条命令开始。2. 前置准备TaoToken 接入与网关服务状态确认在折腾 model 和 channels 之前得先有一个能用的模型接入点。OpenClaw 本身不产模型它需要你填一个兼容 OpenAI 协议的 Base URL 和 API Key。我实测下来用 TaoToken 这类聚合接入比较省事一个 Key 能切多个模型省得每个模型单独申请。TaoToken 的 API 地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 Base URL 填。API Key 在控制台的 API Keys 页面生成路径是https://taotoken.net/console/api-keys。生成后复制那串sk-开头的字符串只显示一次丢了就重新建一个。这里有个关键点OpenClaw 里填的 Base URL 要带上/v1后缀才能被 OpenAI 兼容客户端识别也就是https://taotoken.net/api/v1。很多人只填到/api结果请求 404还以为是 Key 错了。这个坑我踩过记一下。模型 ID 怎么选TaoToken 的模型列表在文档里能查到常用的对话模型直接填对应 ID 即可。如果你不确定填哪个可以先在模型对话页面测一下确认这个模型能正常回话再写进 OpenClaw 配置。模型对话入口是https://taotoken.net/models选一个模型发句话能回就说明 Key 和模型都对。前置准备做完回到 OpenClaw。第一次运行建议带--install-daemon参数把网关装成后台服务openclaw onboard --install-daemon这条命令会走完整初始化流程包括填 Base URL、API Key、选模型、配渠道。如果你之前配错了想重来直接再跑一次openclaw onboard它会覆盖旧配置。装完之后用下面这条确认服务状态openclaw status输出里重点看 Gateway 那一项。显示running或reachable才算正常显示unreachable就是网关没起来后面所有渠道都不会回消息。这一步是排查的起点别跳过。3. 可复制配置model 切换与 channels 状态查看配置这块OpenClaw 提供了两种方式交互式菜单和直接改配置文件。新手推荐先用交互式改错了能重来。交互式配置入口openclaw config进去之后是菜单能单独调 model、channels、skills不用全量重置。换模型就选 model 那一项把新的模型 ID 填进去。改完记得重启网关否则不生效openclaw gateway restart如果你习惯直接改文件OpenClaw 的配置目录在~/.openclaw主配置文件通常是~/.openclaw/config.json或~/.openclaw/config.toml取决于你的版本。下面给一份 JSON 结构的配置片段字段名以你本地实际文件为准路径和原文保持一致{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api/v1, apiKey: sk-你的Key, modelId: 你的模型ID }, channels: { feishu: { enabled: true, appId: cli_xxx, appSecret: xxx }, qqbot: { enabled: false } } }三个必填项对齐一下Base URL 填https://taotoken.net/api/v1API Key 填控制台生成的sk-串Model ID 填你在模型对话里验证过的那个。这三件套缺一不可任何一项错了都会导致请求失败。channels 状态怎么查除了openclaw status还可以看日志里渠道的注册情况openclaw logs --follow日志里会打印每个渠道的启动状态。飞书渠道如果 appId 或 appSecret 填错日志里会有明确的认证失败提示。QQ-Bot 类似token 不对会直接报错。看到渠道显示registered或connected才算通。改完配置后完整的生效流程是改文件 →openclaw gateway restart→openclaw status确认 → 发条测试消息。这四步走完配置才算真正落地。4. 验证请求从日志到成功回复的完整链路配置填完不代表能用得验证。验证分三层网关层、模型层、渠道层。网关层先确认服务在跑openclaw statusGateway 显示 running 就过了。如果显示 unreachable先openclaw gateway start还不行就看日志。模型层验证最直接的方式是看日志里有没有成功的模型调用记录。发一条测试消息后执行openclaw logs --follow正常的话你会看到类似model request success或返回了 choices 的记录。如果看到401或authentication failed就是 API Key 问题看到reading choices相关报错通常是返回体结构不对多半是 Base URL 少了/v1或者模型 ID 填错导致返回了错误页而不是标准 JSON。渠道层验证飞书的话在群里 一下机器人QQ-Bot 在频道里发条消息。机器人回复了就说明全链路通了。没回复就回到日志看消息有没有进来、模型有没有被调用、回复有没有发出去三段定位。一个完整的成功日志大概长这样字段名因版本而异[gateway] channel feishu registered [gateway] message received from user xxx [model] request to https://taotoken.net/api/v1/chat/completions [model] response 200, choices: 1 [gateway] reply sent to feishu看到这五行说明从收到消息到回复发出全通了。任何一行缺失问题就卡在那一段。如果你想让模型能力更强、做长期编码或 Agent 任务可以考虑 Coding Plan入口是https://taotoken.net/coding-plan。日常对话用普通 API Key 就够了不用一上来就上套餐。5. 常见报错排查401、local proxy failed、reading choices这一节按真实报错来对每个都给出定位路径。401 Unauthorized。日志里出现401或invalid api key九成是 Key 问题。检查三处Key 有没有复制完整sk-后面那串别漏字符、Key 有没有过期或被删、Base URL 和 Key 是不是配套的。注意部分模型的 API 调用 Key 和订阅 Key 是分开的别填错。改完 Key 后必须openclaw gateway restart。local proxy failed。这个报错通常出现在网关尝试连外部服务时。先确认服务器能不能正常访问https://taotoken.net/api用 curl 测一下curl -I https://taotoken.net/api/v1/models返回 200 或 401 都说明网络通返回超时就是网络层问题。如果服务器本身网络受限检查 DNS 和出站规则。这个报错和 Key 无关别去改 Key。reading choices 相关报错。典型信息是cannot read property choices of undefined或unexpected response。这说明请求发出去了但返回的不是标准 OpenAI 格式。最常见原因是 Base URL 少了/v1请求打到了错误路径返回了 HTML 而不是 JSON。把 Base URL 改成https://taotoken.net/api/v1再重启。第二个原因是模型 ID 填错服务端返回了错误对象同样没有 choices 字段。OAuth 相关报错。如果你在配飞书或 QQ-Bot 时看到 OAuth 失败检查 appId、appSecret、回调地址三样。飞书渠道的回调地址必须和开放平台后台填的一致差一个斜杠都会失败。QQ-Bot 的 token 同理。网关重启后配置没生效。这是操作顺序问题。改配置文件后光保存不够必须openclaw gateway restart。如果你用的是openclaw config交互菜单退出菜单时它会提示是否重启选是。手动改文件的自己敲重启命令。服务起不来端口被占。openclaw gateway前台启动时报端口占用说明后台已经有一个实例在跑。先openclaw gateway stop再启动。日常推荐用后台模式别用前台。排查的通用心法先openclaw status看网关再openclaw logs --follow看实时日志红字就是错误。看不懂的报错直接复制去问模型把上下文一起贴进去定位会快很多。6. 把命令用顺日常维护与接入文档命令记不住没关系OpenClaw 每个子命令都带帮助openclaw dashboard --help openclaw config --help任何指令后面加-h或--help都能查用法。日常维护就三条定期openclaw update升版本改配置后openclaw gateway restart出问题openclaw logs --follow。这三条覆盖了大部分场景。云服务器上没有图形界面打开仪表盘要加参数openclaw dashboard --no-open它会输出一个带 token 的地址你复制到本地浏览器打开就行。本地有图形界面的直接openclaw dashboard会自动唤起浏览器。如果你要接飞书或 QQ-Bot接入文档里有完整的 appId、appSecret、回调配置步骤入口是https://taotoken.net/doc。文档里对每个渠道的字段都有说明照着填比猜快。API Key 管理和生成在https://taotoken.net/console/api-keysKey 丢了或要换模型都在这里操作。最后给一个日常排障的固定动作序列照着敲就行openclaw status openclaw logs --follow openclaw gateway restart openclaw status第一条看网关活没活第二条看实时错误第三条重启让配置生效第四条确认恢复。四步走完90% 的日常问题都能定位或解决。剩下的疑难杂症把日志贴到模型对话里让它帮你读比干瞪眼强。