Clawdbot(现更名为 OpenClaw)是一个本地运行的 AI 网关工具,让 AI 助手真正能在本地工作,并接入常用聊天平台(Telegram、WhatsApp、iMessage 等)。
- 系统要求
- 安装
- 卸载
- 基础配置
- 模型配置
- 插件管理 (Skills)
- 聊天平台接入
- 使用方式
- 手机访问
- 常用命令速查
- 故障排查
# macOS 安装 Node.js brew install node@22
curl -fsSL https://clawd.bot/install.sh | bash
- 风险确认 → 选择
Yes - Onboarding 模式 → 选择
QuickStart - 模型选择 → 选择 OpenAI / Qwen / Claude 等
- 授权 → 复制链接到浏览器完成授权
- 聊天频道 → 选择 Telegram / WhatsApp 等(可跳过)
- Skills 配置 → 选择需要的技能(可跳过)
- Hooks 启用 → 按需启用(可跳过)
安装脚本自动完成:
- ✅ 安装 CLI 工具
- ✅ 创建
~/.clawdbot目录 - ✅ 注册 Gateway LaunchAgent
- ✅ 初始化默认 Agent 和 Session
clawdbot uninstall
~/.clawdbot/ ├── clawdbot.json # 主配置文件 ├── config.json # 扩展配置 └── ...
clawdbot quickstart # 或 clawdbot onboard
编辑配置文件添加 API Key:
vim ~/.clawdbot/config.json
可配置的 API Keys:
GOOGLE_PLACES_API_KEYGEMINI_API_KEYOPENAI_API_KEYOPENAI_WHISPER_API_KEY
clawdbot models list
clawdbot models set anthropic/claude-opus-4-5
如需使用第三方 API 中转(降低成本或解决网络问题):
# 设置 API Base URL clawdbot config set api.baseUrl https://your-api-provider.com/v1 # 设置 API Key clawdbot config set api.key 你的API密钥 # 重启生效 clawdbot gateway restart
# 安装 Claude Code npm install -g @anthropic-ai/claude-code # 配置环境变量 export ANTHROPIC_AUTH_TOKEN="你的Token" export ANTHROPIC_BASE_URL="https://api.anthropic.com" # 或中转地址 # 验证 claude "Hello, this is a test"
Skills 是 Clawdbot 的能力模块,让 AI 具备特定功能,如文件处理、搜索、系统控制等。
clawdbot skills list
# 启用 clawdbot skills enable
# 禁用 clawdbot skills
disable
# 列出所有 Hooks clawdbot hooks list # 启用/禁用 clawdbot hooks enable
clawdbot hooks
disable
推荐启用:
session-memory- 会话记忆功能command-logger- 命令历史记录
- 创建 Bot
- 打开 Telegram,搜索
@BotFather - 输入
/newbot,按提示创建机器人 - 获取 HTTP API Key
- 打开 Telegram,搜索
- 配置 Clawdbot
clawdbot channels login输入 Telegram HTTP API Key
- 配对机器人
- 在 Telegram 中向你的 Bot 发送
/start - 获取配对码
XXXXXXX - 在终端执行:
clawdbot pairing approve telegram XXXXXXX - 在 Telegram 中向你的 Bot 发送
支持的聊天平台:
- iMessage
- Signal
- Discord
- Slack
配置方式类似,通过 clawdbot channels login 按提示操作。
clawdbot tui
适合快速测试和命令行操作。
默认地址:
http://127.0.0.1:18789/
带 Token 直接登录:
# 获取 Token cat ~/.clawdbot/clawdbot.json | jq -r '.gateway.auth.token'
http://127.0.0.1:18789/?token=
配对完成后,直接在 Telegram/WhatsApp 等平台与 Bot 对话。
让手机/iPad 通过局域网访问 Clawdbot。
# 1. 开启局域网访问 clawdbot config set gateway.bind lan # 2. 允许 HTTP 访问 clawdbot config set gateway.controlUi.allowInsecureAuth true # 3. 重启 Gateway clawdbot gateway restart
# 查看 Mac IP ifconfig | grep "inet " | grep -v 127.0.0.1 # 获取 Token cat ~/.clawdbot/clawdbot.json | jq -r '.gateway.auth.token'
访问地址格式:
http://192.168.x.x:18789/?token=你的Token
iOS:Safari 打开 → 分享按钮 → 添加到主屏幕
Android:Chrome 打开 → 菜单 → 添加到主屏幕
⚠️ 注意:仅在家庭/办公室 WiFi 使用,不要在公共 WiFi 启用。
# 查看状态 clawdbot status # 查看日志 clawdbot logs --follow # Gateway 控制 clawdbot gateway probe # 探测 clawdbot gateway stop # 停止 clawdbot gateway restart # 重启 clawdbot gateway run # 前台运行(调试用)
# 加载服务 launchctl load ~/Library/LaunchAgents/com.clawdbot.gateway.plist # 卸载服务 launchctl unload ~/Library/LaunchAgents/com.clawdbot.gateway.plist
clawdbot config set
# 设置配置 clawdbot quickstart
# 重新初始化 clawdbot onboard
# 引导配置
clawdbot models list # 查看模型 clawdbot models set
# 设置模型 clawdbot skills list
# 查看技能 clawdbot skills
enable
# 启用技能
clawdbot channels login # 登录频道 clawdbot channels status # 频道状态 clawdbot pairing approve
# 配对
# 1. 查看状态和日志 clawdbot status clawdbot logs --follow # 2. 重新加载 LaunchAgent launchctl unload ~/Library/LaunchAgents/com.clawdbot.gateway.plist launchctl load ~/Library/LaunchAgents/com.clawdbot.gateway.plist # 3. 前台运行查看详细错误 clawdbot gateway run
原因:缺少依赖或 API Key
解决:
clawdbot skills list # 查看具体原因 clawdbot quickstart # 重新配置 API Key
常见原因:
- 防火墙阻止出站 HTTPS(端口 443)
- DNS 解析失败
- VPS 屏蔽 Telegram IP
解决:在 /etc/hosts 添加 Telegram 服务器 IP
如提示 clawdbot: command not found,退出终端重新进入即可。
Gateway not running Gateway 未启动 重新 load LaunchAgent
Connection refused 端口被占用 检查端口,重启服务
Network / 429 API 配置错误 检查 API Key 和环境变量
- 官方文档: docs.clawd.bot/
- GitHub: github.com/clawdbot
文档版本: v2.0
最后更新: 2026-02-03
适用系统: macOS 15.x+ / Linux
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/276278.html