VS Code + Clawdbot 完整配置指南：打造你的 AI 编程助手

前言

在上一篇文章中，我介绍了使用 Clawdbot 来辅助博客写作。今天我将详细分享如何从零开始配置 Clawdbot，让它成为你的 AI 编程助手。

什么是 Clawdbot？

Clawdbot 是一个开源的 AI 助手框架，它可以：

• 集成多种 AI 模型（Claude、GPT、DeepSeek 等）
• 通过飞书、Slack 等渠道远程控制
• 在 VS Code 中直接使用
• 执行文件操作、代码生成等自动化任务

安装步骤

1. 安装 Node.js

首先确保你的系统安装了 Node.js 22 或更高版本：

# macOS 使用 Homebrew
brew install node

# 检查版本
node -v  # 应该显示 v22.x.x 或更高

2. 安装 Clawdbot

使用 npm 全局安装：

npm install -g clawdbot

安装完成后验证：

clawdbot --version
# 应该显示类似 2026.1.24-3

3. 初始化配置

运行初始化向导：

clawdbot init

这会在 ~/.clawdbot/ 目录下创建配置文件。

配置 AI 模型

方案一：使用 GitHub Copilot（推荐）

如果你订阅了 GitHub Copilot Pro（$40/月），可以直接使用其中的高级模型：

# 授权 GitHub Copilot
clawdbot auth github-copilot

按提示完成设备授权流程后，编辑 ~/.clawdbot/clawdbot.json，添加模型配置：

{
  "models": {
    "providers": {
      "github-copilot": {
        "api": "github-copilot",
        "models": [
          {
            "id": "claude-opus-4",
            "name": "Claude Opus 4",
            "reasoning": true,
            "contextWindow": 200000,
            "maxTokens": 32000
          },
          {
            "id": "claude-sonnet-4",
            "name": "Claude Sonnet 4",
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "gpt-4o",
            "name": "GPT-4o",
            "contextWindow": 128000,
            "maxTokens": 16384
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "github-copilot/claude-opus-4",
        "fallbacks": [
          "github-copilot/claude-sonnet-4",
          "github-copilot/gpt-4o"
        ]
      }
    }
  }
}

方案二：使用 OpenRouter

如果没有 Copilot 订阅，可以使用 OpenRouter：

clawdbot auth openrouter
# 输入你的 OpenRouter API Key

方案三：使用 Moonshot（国内可用）

对于国内用户，Moonshot 是个不错的选择：

clawdbot auth moonshot
# 输入 Moonshot API Key

注意：Moonshot 的 API 域名是 api.moonshot.cn，不是 api.moonshot.ai！

启动 Gateway 服务

配置完成后，启动 Clawdbot gateway：

# 作为后台服务安装
clawdbot gateway install

# 启动服务
clawdbot gateway start

# 检查状态
clawdbot status

配置飞书渠道（可选）

如果想通过飞书远程控制 Clawdbot：

1. 安装飞书插件

clawdbot plugins install @m1heng-clawd/feishu

2. 创建飞书应用

1. 访问 飞书开放平台
2. 创建企业自建应用
3. 添加「机器人」能力
4. 获取 App ID 和 App Secret

3. 配置飞书连接

编辑 ~/.clawdbot/clawdbot.json：

{
  "channels": {
    "feishu": {
      "appId": "你的 App ID",
      "appSecret": "你的 App Secret",
      "enabled": true,
      "connectionMode": "websocket",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist"
    }
  }
}

重启 gateway 后，就可以在飞书中与机器人对话了！

常见问题

Q: 模型调用失败？

检查以下几点：

1. API Key 是否正确配置
2. 网络是否能访问对应的 API 服务
3. 账户余额是否充足

Q: Gateway 无法启动？

尝试：

# 停止现有进程
pkill -f clawdbot

# 重新启动
clawdbot gateway start

Q: 飞书收不到消息？

确保：

1. 飞书应用已添加「消息与群组」权限
2. 已开启 WebSocket 长连接模式
3. 机器人已被添加到目标群组或已与用户建立联系

我的完整配置

最后分享一下我目前使用的完整配置要点：

• 主模型：GitHub Copilot 的 Claude Opus 4
• 备选模型：Claude Sonnet 4 → GPT-4o → DeepSeek V3 → Moonshot
• 消息渠道：飞书 WebSocket 长连接
• 启用技能：github、weather、coding-agent、summarize 等

这套配置既保证了回答质量，又有多层容错，实测体验非常不错。

---

希望这篇教程对你有帮助！如果有任何问题，欢迎在评论区留言讨论。

下一篇预告：我会分享更多 Clawdbot 的高级用法和自定义技能开发。