Clawdbot完整配置指南：从安装到Claude Code中转-来自github

简介

Clawdbot（现已更名为Moltbot）是一个开源的本地AI助手，支持通过消息应用（Telegram、WhatsApp、Discord等）或Web UI与AI模型交互。它采用本地优先架构，确保您的数据完全私密。

核心特点

🦞 完全开源 – 数据本地存储，无需担心隐私泄露
💬 多平台支持 – Telegram、WhatsApp、Discord、Slack等主流消息应用
🌐 Web控制面板 – 直观的浏览器界面，轻松管理AI助手
🔧 高度可定制 – 支持自定义AI模型和API端点
⚡ 持续运行 – 24/7在线，随时响应您的需求

系统要求

必需条件

项目	要求
操作系统	macOS / Linux / Windows (推荐WSL2)
Node.js	22.0.0 或更高版本
包管理器	pnpm（推荐）或 npm

可选条件

Xcode（仅macOS，如需构建原生应用）
消息平台账号（Telegram Bot Token、Discord Bot等）
Claude Max/Pro订阅（用于setup-token认证）

安装步骤

1. 升级Node.js版本

Clawdbot要求Node.js 22+，推荐使用nvm管理版本：

# 安装Node.js 22
nvm install 22

# 设置为默认版本
nvm use 22
nvm alias default 22

# 验证版本
node --version  # 应显示 v22.x.x

2. 选择安装方式

方式一：npm安装（推荐）

npm install -g moltbot@latest

方式二：从源码安装（开发人员）

# 克隆仓库
git clone https://github.com/moltbot/moltbot.git
cd moltbot

# 安装依赖
pnpm install

# 构建项目
pnpm build

# 链接CLI
npm link

3. 初始化配置

运行配置向导开始设置：

moltbot onboard

配置向导会引导您完成以下步骤：

步骤1：安全确认

◇ Security ───────────────────────────────────────────────────────╮
│ Moltbot agents can run commands, read/write files, and act       │
│ through any tools you enable.                                   │
│ Please read: https://molt.bot/docs/security                     │
├──────────────────────────────────────────────────────────────────╯

◇ I understand this is powerful and inherently risky. Continue?
│ Yes

步骤2：选择AI后端

◇ Model/auth provider
│ Anthropic (推荐Claude系列)

步骤3：认证方式选择

setup-token – Claude Max/Pro订阅用户（推荐）
API Key – API按量付费用户
Claude Code CLI – 已配置Claude Code的用户

步骤4：生成setup-token（Claude Max用户）

在另一个终端运行：

claude setup-token

复制生成的token，粘贴到配置向导中。

步骤5：配置消息平台（可选）

支持Telegram、WhatsApp、Discord等平台。

步骤6：完成配置

◇ Control UI ─────────────────────────────────────────────────────╮
│ Web UI: http://127.0.0.1:18789/                                 │
│ Web UI (with token): http://127.0.0.1:18789/?token=your-token   │
│ Gateway WS: ws://127.0.0.1:18789                                │
├──────────────────────────────────────────────────────────────────╯

└ Onboarding complete.

配置Claude Code API中转

1. 获取API凭证

推荐的中转服务：

MaynorAI发卡网（链接2）- 提供稳定的Claude Code中转服务
MaynorAPIPro（链接5）- 按量付费，灵活实惠

获取以下信息：

API Base URL: https://code.claude-opus.top/api
API Key: cr_xxxxxxxxxxxxx

2. 修改配置文件

重要提示：Clawdbot不支持通过环境变量设置自定义API端点，必须通过配置文件配置。

步骤1：备份配置文件

cp ~/.clawdbot/moltbot.json ~/.clawdbot/moltbot.json.bak

步骤2：编辑配置文件

nano ~/.clawdbot/moltbot.json

步骤3：添加models配置

{
  "models": {
    "providers": {
      "anthropic": {
        "baseUrl": "https://code.claude-opus.top/api",
        "apiKey": "cr_你的API密钥",
        "api": "anthropic-messages",
        "models": []
      }
    }
  }
}

完整配置示例：

{
  "meta": {
    "lastTouchedVersion": "2026.1.25",
    "lastTouchedAt": "2026-01-27T01:05:21.233Z"
  },
  "models": {
    "providers": {
      "anthropic": {
        "baseUrl": "https://code.claude-opus.top/api",
        "apiKey": "cr_你的API密钥",
        "api": "anthropic-messages",
        "models": []
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-5"
      },
      "workspace": "/Users/你的用户名/clawd",
      "maxConcurrent": 4
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "你的gateway_token"
    }
  }
}

3. 重启Gateway服务

moltbot gateway restart

验证和测试

1. 检查Gateway状态

moltbot channels status

2. 访问Web UI

打开浏览器访问：http://127.0.0.1:18789/?token=你的token

3. 发送测试消息

在Web UI中输入测试消息，确认AI正常回复。

常见踩坑点

❌ 踩坑1：环境变量配置无效

错误做法：尝试通过ANTHROPIC_BASE_URL环境变量设置

正确做法：必须使用配置文件的models.providers部分

❌ 踩坑2：缺少必需字段

错误配置：缺少models字段

正确配置：必须包含所有四个字段：baseUrl、apiKey、api、models

❌ 踩坑3：Node.js版本过低

解决方案：使用nvm安装Node.js 22+

❌ 踩坑4：忘记重启Gateway

重要：每次修改配置后必须重启Gateway

安全配置建议

1. 基础安全设置

{
  "gateway": {
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "强密码"
    }
  },
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

2. 文件权限保护

chmod 700 ~/.clawdbot
chmod 600 ~/.clawdbot/moltbot.json

常用命令速查

Gateway管理

moltbot gateway start      # 启动
moltbot gateway stop       # 停止  
moltbot gateway restart    # 重启
moltbot gateway status     # 状态

配置管理

moltbot config get         # 查看配置
moltbot config set         # 设置配置
moltbot doctor             # 诊断修复

会话管理

moltbot sessions list      # 列出会话
moltbot sessions reset     # 重置会话
moltbot messages send      # 发送消息

高级功能

多Agent路由

配置不同的AI助手处理不同场景：

{
  "agents": {
    "list": [
      {
        "id": "work",
        "model": "anthropic/claude-opus-4-5",
        "workspace": "~/clawd-work"
      },
      {
        "id": "personal", 
        "model": "anthropic/claude-sonnet-4-5",
        "workspace": "~/clawd-personal"
      }
    ]
  }
}

技能扩展

通过ClawdHub安装社区技能：

moltbot skills install <skill-name>

故障排除

查看日志

# 实时查看Gateway日志
tail -f ~/.clawdbot/logs/gateway.log

# 查看错误日志
tail -f ~/.clawdbot/logs/gateway.err.log

# 详细调试日志
tail -f /tmp/moltbot/moltbot-$(date +%Y-%m-%d).log

常见错误解决

Gateway连接失败：

# 检查端口占用
lsof -i :18789

# 重启服务
moltbot gateway restart

API调用失败：

# 测试API端点
curl -s https://code.claude-opus.top/api/v1/messages \
  -H "x-api-key: 你的API密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-5","max_tokens":100,"messages":[{"role":"user","content":"hi"}]}'

总结

通过本指南，您应该已经成功搭建了功能完整的Clawdbot AI助手。关键要点：

正确配置API中转 – 使用配置文件而非环境变量
安全保障 – 配置适当的访问控制和文件权限
持续监控 – 定期检查日志和系统状态
及时更新 – 保持软件版本最新

Clawdbot作为一个强大的本地AI助手，能够极大提升您的工作效率。随着使用的深入，您可以探索更多高级功能如多Agent协作、自定义技能开发等。

祝使用愉快！🦞

*教程版本：v2.1 (2026-01-29)

更新内容：基于Moltbot最新文档优化，增强安全配置部分

适用版本：Moltbot 2026.1.25+*

文章来源-https://github.com/xianyu110/clawbot

Click to rate this post!

[Total: 0 Average: 0]