Clawdbot (OpenClaw) 完整使用指南

卡尔特斯
0 阅读5分钟

Clawdbot（现更名为 OpenClaw）是一个本地运行的 AI 网关工具，让 AI 助手真正能在本地工作，并接入常用聊天平台（Telegram、WhatsApp、iMessage 等）。

📋 目录

💻 系统要求

项目要求
操作系统macOS 15.x+ / Linux (Ubuntu 推荐)
Node.js22.x+
包管理器npm / pnpm
# macOS 安装 Node.js
brew install node@22

🚀 安装

一键安装（推荐）

curl -fsSL https://clawd.bot/install.sh | bash

安装过程交互

  1. 风险确认 → 选择 Yes
  2. Onboarding 模式 → 选择 QuickStart
  3. 模型选择 → 选择 OpenAI / Qwen / Claude 等
  4. 授权 → 复制链接到浏览器完成授权
  5. 聊天频道 → 选择 Telegram / WhatsApp 等（可跳过）
  6. Skills 配置 → 选择需要的技能（可跳过）
  7. Hooks 启用 → 按需启用（可跳过）

安装脚本自动完成：

  • ✅ 安装 CLI 工具
  • ✅ 创建 ~/.clawdbot 目录
  • ✅ 注册 Gateway LaunchAgent
  • ✅ 初始化默认 Agent 和 Session

🗑️ 卸载

clawdbot uninstall

⚙️ 基础配置

配置文件位置

~/.clawdbot/
├── clawdbot.json    # 主配置文件
├── config.json      # 扩展配置
└── ...

重新初始化配置

clawdbot quickstart
# 或
clawdbot onboard

API Keys 配置

编辑配置文件添加 API Key：

vim ~/.clawdbot/config.json

可配置的 API Keys：

  • GOOGLE_PLACES_API_KEY
  • GEMINI_API_KEY
  • OPENAI_API_KEY
  • OPENAI_WHISPER_API_KEY

🤖 模型配置

查看可用模型

clawdbot models list

设置模型

clawdbot models set anthropic/claude-opus-4-5

第三方 API 中转配置

如需使用第三方 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 配置（可选）

# 安装 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)

Skills 是什么？

Skills 是 Clawdbot 的能力模块，让 AI 具备特定功能，如文件处理、搜索、系统控制等。

查看 Skills 状态

clawdbot skills list
状态符号说明
Ready✓插件可用
Missing✗缺少依赖或 API Key

启用/禁用 Skill

# 启用
clawdbot skills enable <skill-name>

# 禁用
clawdbot skills disable <skill-name>

常用 Skills

Skill功能
nano-pdfPDF 文件处理
summarize内容总结
web-search网络搜索

Hooks 管理

# 列出所有 Hooks
clawdbot hooks list

# 启用/禁用
clawdbot hooks enable <name>
clawdbot hooks disable <name>

推荐启用：

  • session-memory - 会话记忆功能
  • command-logger - 命令历史记录

💬 聊天平台接入

Telegram 配置

  1. 创建 Bot

    • 打开 Telegram，搜索 @BotFather
    • 输入 /newbot，按提示创建机器人
    • 获取 HTTP API Key

  2. 配置 Clawdbot

    clawdbot channels login

    输入 Telegram HTTP API Key

  3. 配对机器人

    • 在 Telegram 中向你的 Bot 发送 /start
    • 获取配对码 XXXXXXX
    • 在终端执行：
    clawdbot pairing approve telegram XXXXXXX

其他平台

支持的聊天平台：

  • WhatsApp
  • iMessage
  • Signal
  • Discord
  • Slack

配置方式类似，通过 clawdbot channels login 按提示操作。

🖥️ 使用方式

方式一：TUI（终端界面）

clawdbot tui

适合快速测试和命令行操作。

方式二：Web UI（浏览器界面）

默认地址：

http://127.0.0.1:18789/

带 Token 直接登录：

# 获取 Token
cat ~/.clawdbot/clawdbot.json | jq -r '.gateway.auth.token'

http://127.0.0.1:18789/?token=<YOUR_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       # 前台运行（调试用）

LaunchAgent 操作

# 加载服务
launchctl load ~/Library/LaunchAgents/com.clawdbot.gateway.plist

# 卸载服务
launchctl unload ~/Library/LaunchAgents/com.clawdbot.gateway.plist

配置管理

clawdbot config set <key> <value>    # 设置配置
clawdbot quickstart                   # 重新初始化
clawdbot onboard                      # 引导配置

模型与技能

clawdbot models list                  # 查看模型
clawdbot models set <model>           # 设置模型
clawdbot skills list                  # 查看技能
clawdbot skills enable <name>         # 启用技能

频道管理

clawdbot channels login               # 登录频道
clawdbot channels status              # 频道状态
clawdbot pairing approve <platform> <code>  # 配对

🔧 故障排查

Gateway 无法启动

# 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

Skills 显示 Missing

原因：缺少依赖或 API Key

解决：

clawdbot skills list     # 查看具体原因
clawdbot quickstart      # 重新配置 API Key

Telegram 连接失败

常见原因：

  • 防火墙阻止出站 HTTPS（端口 443）
  • DNS 解析失败
  • VPS 屏蔽 Telegram IP

解决：在 /etc/hosts 添加 Telegram 服务器 IP

命令找不到

如提示 clawdbot: command not found，退出终端重新进入即可。

常见错误

错误原因解决
Gateway not runningGateway 未启动重新 load LaunchAgent
Connection refused端口被占用检查端口，重启服务
Network / 429API 配置错误检查 API Key 和环境变量

📚 参考资源

文档版本: v2.0
最后更新: 2026-02-03
适用系统: macOS 15.x+ / Linux

avatar
文章
阅读
粉丝