折腾OpenClaw两周,我把常用命令踩了一遍

折腾OpenClaw两周，我把常用命令踩了一遍

wuhiufan

上个月我想把OpenClaw接到飞书群，让AI直接在群里干活。

文档翻了半天，命令参数一堆，试了十几次都停在”通道连接中”。后来才发现是--token参数位置写错了——要放在channels add后面，不是放在最后。

就这么一个小问题，我花了两个晚上。

于是我把这两周用下来的常用命令，按”我踩过的坑”重新整理了一遍。不是官方文档的复刻，是我自己用过、踩过、验证过的版本。

第一部分：我怎么部署的（踩坑记录）

我的部署路

我一开始想走云端版，试了半天发现网络不通（公司防火墙）。后来改成本地部署，流程是这样的：

第一步：安装

npm install -g openclaw

装完验证：

openclaw --version

我踩的坑：npm镜像没换，下载卡了20分钟。先换源：
bash npm config set registry https://registry.npmmirror.com

第二步：初始化

openclaw onboard

会问你几个问题：
– 默认模型选哪个？（我选了deepseek，便宜）
– API Key填哪个平台的？（我填了DeepSeek的key）
– 要不要装成系统服务？（我选了”是”，开机自启）

我踩的坑：这里填错API Key之后，后面openclaw doctor会报错，但报错信息不明确，只说”gateway timeout”。要回头重新onboard才能改。

第三步：检查健康状态（每次改完配置必做）

openclaw doctor

输出正常是这样：

✓ Gateway is running
✓ Model qwen-max is accessible
✓ Plugin feishu is installed

如果有✗，先试openclaw doctor --fix，让它自动修。修不好再Google。

第二部分：我每天都在用的命令

基础操作（我80%的时间只用到这几个）

命令	我用来干什么	我踩过的坑
`openclaw tui`	打开聊天界面，最常用	第一次用会让你选模型，选错之后要`openclaw models set`重新选
`openclaw dashboard`	打开网页控制台，查看会话历史	浏览器会自动打开，如果没反应，手动访问 `http://localhost:18789`
`openclaw restart`	改完配置后重启	必须做——改了`openclaw.json`之后不重启不会生效
`openclaw stop`	暂时关掉	关掉之后`tui`会连不上，要记得重启

模型管理（我切换最频繁的场景）

我有两个使用场景：
– 写代码 → 用deepseek-coder，便宜且专业
– 写方案/报告 → 用qwen-max，中文理解好

切换命令：

openclaw models set qwen-max

查看当前用的哪个：

openclaw models list

我踩的坑：list显示的模型名，和set时填的名字有时候不一样。比如list里显示bailian/qwen-max-2025-01-20，但set时要填qwen-max。不确定就两个都试一下。

登录认证（如果要换API提供商）：

openclaw models auth login --provider qwen-portal

第三部分：我把飞书打通了（最坑的部分）

为什么我要接飞书

我们团队沟通在飞书，我想让AI直接在群里回消息，不用切换到别的工具。

我的接入步骤（踩了5次才成功）

第1步：添加通道

openclaw channels add

会问你通道类型，选feishu。

我踩的坑：这里选完之后会让你填App ID和App Secret，要先去飞书开放平台创建应用，拿到这两个值再回来填。我是反过来做的——先填了空值，后面报错找不到原因。

第2步：填Token（最坑）

正确写法：

openclaw channels add --channel feishu --token YOUR_BOT_TOKEN

我踩的坑：我把--token写在命令最后面，像这样：
bash openclaw channels add --channel feishu YOUR_BOT_TOKEN # ❌ 错
正确写法是--token紧接着参数值，且放在channels add后面。

第3步：验证通道状态

openclaw channels status

正常输出：

feishu: connected (2 groups)

如果显示disconnected，先检查机器人有没有被踢出群，再检查Token是否过期。

第四部分：我怎么管理插件的

我装的插件

feishu — 飞书对接（必装）
qwen-portal-auth — 通义千问登录认证（我选的模型提供商）
code-review — 代码审查（偶尔用）

查看已装的：

openclaw plugins list

装新插件：

openclaw plugins install feishu

我踩的坑：install完不会立即生效，要openclaw restart。我第一次不知道，在群里@机器人没反应，以为是配置错了，其实是没重启。

禁用插件（调试时有用）：

openclaw plugins disable code-review

第五部分：我怎么用技能的

什么是Skill（我的理解）

Skill就是”专家角色包”。比如我装了code-review这个Skill之后，AI审查代码时会按照预先设定的审查标准（安全性/性能/可读性）来提意见，不是泛泛而谈。

查看已装的Skill：

openclaw skills list

装新Skill（从ClawHub）：

clawhub install code-review

我踩的坑：Skill有依赖关系。比如code-review依赖git-diff这个底层工具，没装的话会报错。安装时看清楚依赖提示。

第六部分：日志排查（我最常用的排错流程）

我的排错三步法

第1步：看健康状态

openclaw doctor

如果不通过，先--fix自动修。

第2步：看最近日志

openclaw logs

会显示最近20条日志，包括错误信息。

第3步：看网关详情

openclaw status --deep

会显示网关连接状态、模型可达性、插件加载情况。

我的经验：90%的问题在doctor这步就能发现。logs主要用来排查”为什么回答了奇怪内容”这类逻辑问题（可能是模型选错了）。

第七部分：我每天怎么省Token的

问题：上下文太长，Token烧钱

我有一个项目聊了一周，上下文积累了几万字，每次对话都要烧几千个Token。

我的解决方法

方法1：压缩上下文

/compact

在聊天窗口里输入这个命令，AI会把历史对话压缩成摘要，后续对话按摘要理解上下文，Token消耗大幅下降。

方法2：开新会话

/new

彻底清空上下文，从零开始。适合”上一个任务和下一个任务完全无关”的场景。

我踩的坑：/new之后，之前对话里建立的”记忆”（就是AI对你项目的了解）会丢失。要重新介绍项目背景，或者把关键背景写进USER.md。

第八部分：我怎么远程控制OpenClaw的

场景：我在外面，想让家里的电脑上的OpenClaw跑任务

在家里的电脑上（被控端）：

openclaw pairing approve

会生成一个配对码，比如ABC123。

在我的笔记本上（控制端）：

openclaw agent --message "帮我整理本周的会议记录" --pairing-code ABC123

任务会在家里的电脑上跑，结果发回到我的笔记本。

我踩的坑：配对码5分钟过期。生成之后要尽快在控制端输入，不然要重新生成。

第九部分：配置文件我改了什么

我的配置文件位置

Windows：C:\Users\你的用户名\.openclaw\openclaw.json
macOS/Linux：~/.openclaw/openclaw.json

我改过的关键配置项

{
  "defaultModel": "qwen-max",
  "autoApprove": false,
  "logLevel": "info"
}

defaultModel：默认模型，改成你最常用的那个
autoApprove：false表示每次执行操作前征求你同意，true表示全自动（我建议先false，用熟了再改）
logLevel："info"够用了，调试时才改成"debug"

我踩的坑：改完配置文件必须openclaw restart，不然不生效。我有过好几次改完不重启，然后困惑”为什么配置没反映”。

第十部分：我怎么更新版本的

更新命令

openclaw update

会更新到最新稳定版。

如果想先用测试版（新功能早体验，但可能不稳定）：

openclaw update --channel beta

我踩的坑：更新之后插件可能需要重新编译。如果更新后openclaw doctor报插件加载失败，先openclaw plugins doctor看一下，然后openclaw restart。

我的急救流程（照这个顺序做）

openclaw doctor — 先全面检查
openclaw logs — 再看具体错误
openclaw status — 最后看运行状态
openclaw restart — 上面三步都没解决就重启
openclaw doctor --fix — 还不行就让系统自动修

90%的问题在前3步就能定位。

最后

这篇文章不是官方文档的复刻，是我自己折腾两周的记录。

如果你也想用OpenClaw接飞书/钉钉/Discord，或者在命令行里直接让AI帮你写代码，先从openclaw onboard开始，遇到问题按我的”急救流程”排查。

少踩坑，多让AI干活。