2026-01-27 · 实战
32
实战 · 2026-01-27

Clawdbot 指令速查表:3分钟从入门到精通,别再说 CLI 太复杂

TL;DR

Clawdbot 最近在 AI Agent 圈子大火,但 90% 的人卡在"不知道怎么用"。本文提供完整的 50+ 指令速查表,按使用场景分类,附中文说明和实战示例。收藏这一篇,3分钟内你就能:

适合人群:想用 Clawdbot 但被 CLI 劝退的所有人。


为什么需要这张速查表?

痛点 1:官方文档太散,找不到想要的命令

你想让 Clawdbot 定时发消息,搜了半天文档,发现要看懂 gatewaycronchannels 三个章节才能拼出完整流程。

痛点 2:记不住参数,每次都要 --help

clawdbot gateway installclawdbot gateway start 有什么区别?--featured-media 是必填还是可选?每次都要翻文档。

痛点 3:不知道"聊天命令"和"终端命令"的区别

/reset 是发给机器人的消息,clawdbot session list 是在终端运行的。新手经常搞混。

这张速查表解决的就是这三个问题:按场景分类、中文说明、一眼看懂。


完整指令速查表

🚀 初始化与配置(Setup)

指令
中文说明
使用场景

clawdbot setup
初始化配置文件
首次安装后运行,生成 ~/.clawdbot/clawdbot.json

clawdbot onboard
交互式配置向导
不想手动改 JSON,跟着提示一步步配置

clawdbot configure
重新进入配置向导
想改 API Key、代理、默认模型

clawdbot config get <path>
查看某个配置项
例:clawdbot config get agents.defaults.model

clawdbot config set <path> <val>
修改某个配置项
例:clawdbot config set logging.level "debug"

clawdbot doctor
自动检查环境问题
出错时先跑这个,加 --fix 自动修复

clawdbot update
更新到最新版本
支持 stable/beta/dev 频道

clawdbot uninstall
卸载 Clawdbot
包括后台服务一起删除

实战示例

# 首次安装后的标准流程
clawdbot setup
clawdbot onboard --flow quickstart
clawdbot doctor --fix  # 检查环境

💬 消息与对话(Messaging & Agent)

指令
中文说明
使用场景

clawdbot message send
手动发送消息
不触发 AI,直接通过 WhatsApp 发消息

clawdbot agent
在终端运行 AI 对话
测试 prompt,可选是否发到聊天频道

clawdbot agents list
列出所有 Agent 配置
查看你配置了几个不同的 AI 角色

clawdbot agents add <name>
添加新的 Agent
例:clawdbot agents add work_bot --model claude-3-opus

clawdbot session list
列出活跃会话
查看当前有哪些聊天在进行中

实战示例

# 在终端测试 AI 回复,不发到聊天
clawdbot agent --message "总结今天的科技新闻" --model "gpt-4"

# 配置一个专门用于工作的 Agent
clawdbot agents add work_assistant --model anthropic/claude-3-opus

🌐 网关与服务(Gateway & Service)

指令
中文说明
使用场景

clawdbot gateway run
前台启动网关
调试时用,能看到实时日志

clawdbot gateway start
启动后台服务
正式使用,需先 install

clawdbot gateway stop
停止后台服务
暂停 Clawdbot

clawdbot gateway status
查看网关状态
检查端口、连接数

clawdbot gateway install
安装为系统服务
macOS 用 launchd,Linux 用 systemd

clawdbot logs
实时查看日志
类似 tail -f

实战示例

# 标准部署流程
clawdbot gateway install  # 安装为系统服务
clawdbot gateway start    # 启动
clawdbot gateway status   # 确认运行中

🤖 模型管理(Models)

指令
中文说明
使用场景

clawdbot models list
列出所有可用模型
查看支持哪些模型

clawdbot models status
查看当前默认模型
确认用的是哪个模型

clawdbot models set <id>
设置默认模型
例:clawdbot models set anthropic/claude-3-5-sonnet

clawdbot models scan
扫描免费模型
自动找 OpenRouter 上的免费模型

clawdbot models aliases add
给模型加别名
例:clawdbot models aliases add gpt4o openai/gpt-4o

实战示例

# 切换到 Claude 3.5 Sonnet
clawdbot models set anthropic/claude-3-5-sonnet

# 给常用模型加个短别名
clawdbot models aliases add opus anthropic/claude-3-opus

📱 频道管理(Channels)

指令
中文说明
使用场景

clawdbot channels list
列出已配置的频道
查看 WhatsApp/Telegram 状态

clawdbot channels login
登录频道
例:WhatsApp 扫码登录

clawdbot pairing list
查看配对请求
有人想私聊机器人,需要你批准

clawdbot pairing approve
批准配对请求
允许某个用户与机器人对话

实战示例

# 连接 WhatsApp
clawdbot channels login --channel whatsapp  # 扫码登录

# 批准某个用户的私聊请求
clawdbot pairing list whatsapp  # 查看待批准列表
clawdbot pairing approve whatsapp ABC123  # 批准

🛠️ 工具与自动化(Tools & Automation)

指令
中文说明
使用场景

clawdbot browser start
启动受控浏览器
让 AI 控制浏览器

clawdbot browser open <url>
打开指定网页
例:clawdbot browser open https://google.com

clawdbot cron list
列出定时任务
查看有哪些定时消息

clawdbot cron add
添加定时任务
例:每天早上 9 点发简报

clawdbot memory search
搜索长记忆
在 AI 的记忆库中搜索

clawdbot skills list
列出已安装技能
查看 AI 有哪些能力

实战示例

# 每天早上 9 点发送新闻简报
clawdbot cron add --message "总结今天的科技新闻" --cron "0 9 * * *"

# 在 AI 记忆中搜索"项目计划"
clawdbot memory search "项目计划"

🎛️ 其他实用命令(Misc)

指令
中文说明
使用场景

clawdbot tui
启动终端聊天界面
直接在终端和 AI 对话

clawdbot security audit
安全审计
检查配置是否暴露了敏感端口

clawdbot dashboard
打开 Web 控制面板
可视化管理


聊天中的 Slash 命令(发给机器人的消息)

这些命令不是在终端运行的,而是直接发送给 Clawdbot 的消息。

命令
中文说明
使用场景

/status
查看机器人状态
查看当前模型、资源使用情况

/reset
重置会话上下文
让 AI 忘记之前的对话

/model
查看/切换模型
临时换个模型试试

/help
获取帮助
查看可用命令

/reasoning on/off
开关思维链显示
想看 AI 的思考过程时打开

/config
快速修改配置
仅限所有者,例:/config set verbose true

注意:这些命令需要在 ~/.clawdbot/clawdbot.json 中配置 commands.text: true 才能使用。


3 个最常用的场景速查

场景 1:首次安装并连接 WhatsApp

clawdbot setup
clawdbot onboard --flow quickstart
clawdbot channels login --channel whatsapp  # 扫码
clawdbot gateway install
clawdbot gateway start

场景 2:每天早上 9 点自动发新闻简报

clawdbot cron add \
  --message "总结今天的科技新闻,3条即可" \
  --cron "0 9 * * *"

场景 3:切换模型并重置对话

在聊天中发送:

/model anthropic/claude-3-opus
/reset

为什么 Clawdbot 值得学?

1. 它是"AI Agent 的 Linux"

就像 Linux 是服务器的标配,Clawdbot 正在成为 AI Agent 的基础设施。掌握它的 CLI,就像掌握了 systemctlcronssh 一样重要。

2. 它让 AI 从"聊天工具"变成"自动化系统"

不再是"你问我答",而是:
- 定时任务(每天早上发简报)
- 浏览器自动化(AI 帮你填表单)
- 多频道管理(WhatsApp + Telegram 统一管理)

3. 它是开源的,可以魔改

不喜欢某个功能?改源码。想加个新 Skill?写个 Python 脚本。


下一步:从速查到精通

  1. 收藏这张速查表:遇到问题先 Ctrl+F 搜索
  2. 跑一遍"场景 1":把 WhatsApp 连上,发第一条消息
  3. 配置一个定时任务:让 AI 每天给你发天气预报
  4. 读官方文档的高级部分:Memory、Skills、Browser Automation

总结

Clawdbot 的学习曲线不陡,只是命令太多。这张速查表按使用场景分类,让你:
- 3分钟找到想要的命令
- 看示例直接复制粘贴
- 区分"终端命令"和"聊天命令"

如果你觉得有用,分享给同样被 CLI 劝退的朋友。

最后一个建议:把这张表打印出来,贴在显示器旁边。用不了一周,你就能闭着眼睛敲 clawdbot gateway status 了。

目录 最新
← 左侧翻上一屏 · 右侧翻下一屏 · 中间唤出菜单