2026年Clawdbot (OpenClaw) 完整使用指南

Clawdbot (OpenClaw) 完整使用指南Clawdbot 现更名为 OpenClaw 是一个本地运行的 AI 网关工具 让 AI 助手真正能在本地工作 并接入常用聊天平台 Telegram WhatsApp iMessage 等 系统要求 安装 卸载 基础配置 模型配置 插件管理 Skills 聊天平台接入 使用方式 手机访问 常用命令速查 故障排查 项目 要求 操作系统 macOS 15 x Linux

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



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


  • 系统要求
  • 安装
  • 卸载
  • 基础配置
  • 模型配置
  • 插件管理 (Skills)
  • 聊天平台接入
  • 使用方式
  • 手机访问
  • 常用命令速查
  • 故障排查

项目 要求 操作系统 macOS 15.x+ / Linux (Ubuntu 推荐) Node.js 22.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 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 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 
状态 符号 说明 Ready ✓ 插件可用 Missing ✗ 缺少依赖或 API Key
# 启用 clawdbot skills enable 
         
    
            
            # 禁用 clawdbot skills 
            disable 
             
             
           
Skill 功能 nano-pdf PDF 文件处理 summarize 内容总结 web-search 网络搜索
# 列出所有 Hooks clawdbot hooks list # 启用/禁用 clawdbot hooks enable 
         
    
           
             clawdbot hooks 
            disable 
             
             
           

推荐启用:

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

  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 按提示操作。


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










小讯
上一篇 2026-04-23 21:04
下一篇 2026-04-23 21:02

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/276278.html