TL;DR
Clawdbot 最近在 AI Agent 圈子大火,但 90% 的人卡在"不知道怎么用"。本文提供完整的 50+ 指令速查表,按使用场景分类,附中文说明和实战示例。收藏这一篇,3分钟内你就能:
- ✅ 配置好 Clawdbot 并连上 WhatsApp/Telegram
- ✅ 让 AI 定时给你发早报
- ✅ 用浏览器自动化完成重复任务
- ✅ 在聊天中切换模型、重置上下文
适合人群:想用 Clawdbot 但被 CLI 劝退的所有人。
为什么需要这张速查表?
痛点 1:官方文档太散,找不到想要的命令
你想让 Clawdbot 定时发消息,搜了半天文档,发现要看懂 gateway、cron、channels 三个章节才能拼出完整流程。
痛点 2:记不住参数,每次都要 --help
clawdbot gateway install 和 clawdbot 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,就像掌握了 systemctl、cron、ssh 一样重要。
2. 它让 AI 从"聊天工具"变成"自动化系统"
不再是"你问我答",而是:
- 定时任务(每天早上发简报)
- 浏览器自动化(AI 帮你填表单)
- 多频道管理(WhatsApp + Telegram 统一管理)
3. 它是开源的,可以魔改
不喜欢某个功能?改源码。想加个新 Skill?写个 Python 脚本。
下一步:从速查到精通
- 收藏这张速查表:遇到问题先 Ctrl+F 搜索
- 跑一遍"场景 1":把 WhatsApp 连上,发第一条消息
- 配置一个定时任务:让 AI 每天给你发天气预报
- 读官方文档的高级部分:Memory、Skills、Browser Automation
总结
Clawdbot 的学习曲线不陡,只是命令太多。这张速查表按使用场景分类,让你:
- 3分钟找到想要的命令
- 看示例直接复制粘贴
- 区分"终端命令"和"聊天命令"
如果你觉得有用,分享给同样被 CLI 劝退的朋友。
最后一个建议:把这张表打印出来,贴在显示器旁边。用不了一周,你就能闭着眼睛敲 clawdbot gateway status 了。