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 了。






AI周刊:大模型、智能体与产业动态追踪
程序员数学扫盲课
冲浪推荐:AI工具与技术精选导航
Claude Code 全体系指南:AI 编程智能体实战
最新评论
这篇文章写得太实用了!按照步骤一步步来,真的能从小白搭建起一个仿小红书的小程序。Cursor的AI补全功能确实大大提高了开发效率,感谢分享!
对比得很清晰。个人觉得如果只是日常聊天和简单任务,Claude 4.5的性价比更高;但如果是复杂的编程任务,GPT-5.2还是更稳定一些。希望能看到更多关于具体使用场景的对比。
开源项目的安全确实容易被忽视。这个案例提醒我们,即使是小功能也要做好权限校验。建议作者可以补充一下修复后的代码实现,让读者更清楚如何防范此类问题。
这个案例太典型了。配置错误导致的故障往往最难排查,因为看起来一切都正常。我们在生产环境也遇到过类似问题,后来引入了配置审查机制才好转。建议大家都重视配置管理!
很棒的漏洞分析!这种小号入侵的问题确实很容易被忽略。建议项目方可以增加一些风控规则,比如检测同一IP的多次注册行为。感谢分享这个案例!
FreeBSD的jail机制确实很强大,能把服务隔离得很干净。不过配置起来确实有点复杂,这篇文章把步骤写得很详细,准备按照教程试试!
实测下来确实如文章所说,规划能力有提升但偶尔会抽风。天气卡片那个案例很有意思,说明模型在理解上下文时还是会踩坑。希望后续版本能更稳定一些。
论文筛选真的是科研人员的痛点,每天arxiv上那么多新论文,手动看根本看不过来。这个工具如果能准确筛选出相关论文,能节省不少时间。感谢开源!