[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-xianyu110--clawbot":3,"tool-xianyu110--clawbot":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",147882,2,"2026-04-09T11:32:47",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":77,"owner_email":78,"owner_twitter":78,"owner_website":79,"owner_url":80,"languages":78,"stars":81,"forks":82,"last_commit_at":83,"license":78,"difficulty_score":32,"env_os":84,"env_gpu":85,"env_ram":85,"env_deps":86,"category_tags":91,"github_topics":92,"view_count":32,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":93,"updated_at":94,"faqs":95,"releases":125},5838,"xianyu110\u002Fclawbot","clawbot","Clawdbot完整配置指南：从安装到Claude Code中转","Clawdbot 是一款开源的本地 AI 助手，旨在让用户通过 Telegram、WhatsApp、Discord 等常用消息应用或网页界面，便捷地与 Claude 等大语言模型进行交互。它主要解决了用户在不同平台间切换繁琐以及担心云端数据隐私的问题，通过将数据存储在本地并支持自定义 API 端点，实现了安全、灵活的 AI 接入体验。\n\n这款工具特别适合希望将 AI 能力融入日常沟通流程的开发者、技术爱好者及注重隐私的普通用户。无论是想在工作群聊中直接调用代码辅助，还是希望通过手机随时与 AI 对话，Clawdbot 都能提供无缝支持。其独特的技术亮点在于强大的适配性：不仅支持多种消息平台的一键配置，还允许用户灵活选择认证方式（如复用 Claude Max 订阅额度），甚至能搭建多模型中转站，同时调度 GPT、Gemini 等不同后端。配合直观的 Web 控制面板和详细的中文部署指南，即使是非资深技术人员也能轻松完成从安装到实战的全流程配置，打造专属的个性化 AI 工作流。","# Clawdbot完整配置指南：从安装到Claude Code中转\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fxianyu110_clawbot_readme_840c29522040.png)\n\n## 目录\n\n- [简介](#简介)\n- [系统要求](#系统要求)\n- [安装步骤](#安装步骤)\n- [配置Claude Code API中转](#配置claude-code-api中转)\n- [验证和测试](#验证和测试)\n- [常见踩坑点](#常见踩坑点)\n- [常见问题FAQ](#常见问题faq)\n- [常用命令](#常用命令)\n\n---\n\n# 推荐新的部署教程，[从零开始打造你的AI工作助手：最全面的中文教程，涵盖安装、配置、实战案例和避坑指南！](https:\u002F\u002Fawesome.tryopenclaw.asia)\n\n## 简介\n\nClawdbot是一个开源的本地AI助手，支持通过消息应用（Telegram、WhatsApp、Discord等）或Web UI与AI模型交互。\n\n**核心特点：**\n- 🦞 完全开源，数据本地存储\n- 💬 支持多种消息平台\n- 🌐 提供Web控制面板\n- 🔧 可自定义AI模型和API端点\n\n---\n\n## 系统要求\n\n### 必需条件\n\n| 项目 | 要求 |\n|------|------|\n| 操作系统 | macOS \u002F Linux \u002F Windows |\n| Node.js | 22.0.0 或更高版本 |\n| 包管理器 | pnpm（推荐）或 npm |\n\n### 可选条件\n\n- Xcode（仅macOS，如需构建原生应用）\n- 消息平台账号（Telegram Bot Token、Discord Bot等）\n\n---\n\n## 安装步骤\n\n### 1. 升级Node.js版本\n\nClawdbot要求Node.js 22+，使用nvm管理版本：\n\n```bash\n# 安装Node.js 22\nnvm install 22\n\n# 设置为默认版本\nnvm use 22\nnvm alias default 22\n\n# 验证版本\nnode --version  # 应显示 v22.x.x\n```\n\n### 2. 选择安装方式\n\n**方式一：npm安装（推荐）**\n\n```bash\nnpm install -g clawdbot\n```\n\n**方式二：一键安装脚本**\n\n```bash\ncurl -fsSL https:\u002F\u002Fclawd.bot\u002Finstall.sh | bash\n```\n\n**方式三：从源码安装**\n\n```bash\n# 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002Fclawdbot\u002Fclawdbot.git\ncd clawdbot\n\n# 安装依赖\npnpm install\n\n# 构建\npnpm build\n\n# 链接CLI\nnpm link\n```\n\n### 3. 初始化配置\n\n安装完成后运行配置向导：\n\n```bash\nclawdbot onboard\n```\n\n**配置向导流程：**\n\n#### 步骤1：安全确认\n\n```\n◇  Security ───────────────────────────────────────────────────────╮\n│  Clawdbot agents can run commands, read\u002Fwrite files, and act     │\n│  through any tools you enable.                                   │\n│  Please read: https:\u002F\u002Fdocs.clawd.bot\u002Fsecurity                    │\n├──────────────────────────────────────────────────────────────────╯\n\n◇  I understand this is powerful and inherently risky. Continue?\n│  Yes\n```\n\n#### 步骤2：选择AI后端\n\n```\n◇  Model\u002Fauth provider\n│  Anthropic\n\n◆  Anthropic auth method\n│  ● Anthropic token (paste setup-token) ← 推荐Claude Max用户\n│  ○ Anthropic token (Claude Code CLI)\n│  ○ Anthropic API key\n```\n\n**认证方式对比：**\n\n| 认证方式 | 适用场景 | 优点 | 缺点 |\n|---------|---------|------|------|\n| setup-token | Claude Max\u002FPro订阅用户 | 无需额外付费 | 需要额外步骤生成token |\n| Claude Code CLI | 已配置Claude Code的用户 | 自动读取凭证 | 可能找不到凭证文件 |\n| API Key | API按量付费用户 | 最直接 | 需要独立付费 |\n\n#### 步骤3：生成setup-token（Claude Max用户）\n\n在另一个终端运行：\n\n```bash\nclaude setup-token\n```\n\n复制生成的token，粘贴到配置向导中：\n\n```\n◇  Paste Anthropic setup-token\n│  sk-ant-oat01-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx...\n\n◇  Token name (blank = default)\n│  default\n\n◇  Default model\n│  Keep current (default: anthropic\u002Fclaude-opus-4-5)\n```\n\n> **提示：** Claude Max订阅用户不需要单独购买API Key，使用setup-token即可复用订阅额度。\n\n#### 步骤4：配置消息平台（可选）\n\n```\n◇  Channel status ────────────────────────────╮\n│  Telegram: not configured                   │\n│  WhatsApp: not configured                   │\n│  Discord: not configured                    │\n│  ...共支持 12+ 平台                          │\n├─────────────────────────────────────────────╯\n\n◇  Select channel (QuickStart)\n│  Telegram (Bot API)\n```\n\n**获取Telegram Bot Token：**\n\n1. 在Telegram中搜索 @BotFather\n2. 发送 `\u002Fnewbot`\n3. 按提示输入Bot名称和用户名\n4. 复制Bot Token\n\n#### 步骤5：完成配置\n\n```\n◇  Telegram: ok (@YourBotName) (1416ms)\n   Agents: main (default)\n   Heartbeat interval: 1h (main)\n\n◇  Control UI ─────────────────────────────────────────────────────╮\n│  Web UI: http:\u002F\u002F127.0.0.1:18789\u002F                                 │\n│  Web UI (with token): http:\u002F\u002F127.0.0.1:18789\u002F?token=your-token   │\n│  Gateway WS: ws:\u002F\u002F127.0.0.1:18789                                │\n├──────────────────────────────────────────────────────────────────╯\n\n└  Onboarding complete.\n```\n\n#### 步骤6：配对验证（如使用Telegram）\n\n去Telegram给你的Bot发消息，会收到配对码：\n\n```\nClawdbot: access not configured.\n\nYour Telegram user id: 1234567890\nPairing code: ABC12345\n\nAsk the bot owner to approve with:\nclawdbot pairing approve telegram \u003Ccode>\n```\n\n在终端批准配对：\n\n```bash\nclawdbot pairing approve telegram ABC12345\n```\n\n---\n\n## 配置自定义中转站（多模型支持）\n\n### 方案一：配置多模型中转站（推荐）\n\n这个方案支持同时配置 GPT、Claude、Gemini 等多个模型。\n\n#### 1. 获取API凭证\n\n从中转服务获取：\n- **API Base URL**: `https:\u002F\u002Fapipro.maynor1024.live`\n- **API Key**: `sk-xxxxxxxxxxxxx`\n\n**推荐服务：**\n- 推荐中转API：https:\u002F\u002Fapipro.maynor1024.live\u002F\n- 购买链接：https:\u002F\u002Fmaynorai.tqfk.xyz\u002Fitem\u002F7\n\n#### 2. 修改主配置文件\n\n> **⚠️ 重要提示：** Clawdbot不支持通过环境变量`ANTHROPIC_BASE_URL`来设置自定义API端点。必须通过配置文件的`models.providers`来配置。\n\n**步骤1：备份配置文件**\n\n```bash\ncp ~\u002F.clawdbot\u002Fclawdbot.json ~\u002F.clawdbot\u002Fclawdbot.json.bak\n```\n\n**步骤2：编辑配置文件**\n\n```bash\nnano ~\u002F.clawdbot\u002Fclawdbot.json\n```\n\n在配置文件中添加多个 provider：\n\n```json\n{\n  \"models\": {\n    \"mode\": \"merge\",\n    \"providers\": {\n      \"api-proxy-gpt\": {\n        \"baseUrl\": \"https:\u002F\u002Fapipro.maynor1024.live\u002Fv1\",\n        \"api\": \"openai-completions\",\n        \"apiKey\": \"sk-你的API密钥\",\n        \"models\": [\n          {\n            \"id\": \"gpt-4o\",\n            \"name\": \"GPT-4o\",\n            \"reasoning\": false,\n            \"input\": [\"text\"],\n            \"cost\": {\n              \"input\": 0,\n              \"output\": 0,\n              \"cacheRead\": 0,\n              \"cacheWrite\": 0\n            },\n            \"contextWindow\": 128000,\n            \"maxTokens\": 8192\n          }\n        ]\n      },\n      \"api-proxy-claude\": {\n        \"baseUrl\": \"https:\u002F\u002Fapipro.maynor1024.live\",\n        \"api\": \"anthropic-messages\",\n        \"apiKey\": \"sk-你的API密钥\",\n        \"models\": [\n          {\n            \"id\": \"claude-sonnet-4-5-20250929\",\n            \"name\": \"Claude Sonnet 4.5\",\n            \"reasoning\": false,\n            \"input\": [\"text\"],\n            \"cost\": {\n              \"input\": 0,\n              \"output\": 0,\n              \"cacheRead\": 0,\n              \"cacheWrite\": 0\n            },\n            \"contextWindow\": 200000,\n            \"maxTokens\": 8192\n          }\n        ]\n      },\n      \"api-proxy-google\": {\n        \"baseUrl\": \"https:\u002F\u002Fapipro.maynor1024.live\u002Fv1beta\",\n        \"api\": \"google-generative-ai\",\n        \"apiKey\": \"sk-你的API密钥\",\n        \"models\": [\n          {\n            \"id\": \"gemini-3-pro-preview\",\n            \"name\": \"Gemini 3 Pro\",\n            \"reasoning\": false,\n            \"input\": [\"text\"],\n            \"cost\": {\n              \"input\": 0,\n              \"output\": 0,\n              \"cacheRead\": 0,\n              \"cacheWrite\": 0\n            },\n            \"contextWindow\": 2000000,\n            \"maxTokens\": 8192\n          }\n        ]\n      }\n    }\n  },\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"api-proxy-claude\u002Fclaude-sonnet-4-5-20250929\"\n      },\n      \"models\": {\n        \"api-proxy-gpt\u002Fgpt-4o\": {\n          \"alias\": \"GPT-4o\"\n        },\n        \"api-proxy-claude\u002Fclaude-sonnet-4-5-20250929\": {\n          \"alias\": \"Claude Sonnet 4.5\"\n        },\n        \"api-proxy-google\u002Fgemini-3-pro-preview\": {\n          \"alias\": \"Gemini 3 Pro\"\n        }\n      }\n    }\n  },\n  \"auth\": {\n    \"profiles\": {\n      \"api-proxy-gpt:default\": {\n        \"provider\": \"api-proxy-gpt\",\n        \"mode\": \"api_key\"\n      },\n      \"api-proxy-claude:default\": {\n        \"provider\": \"api-proxy-claude\",\n        \"mode\": \"api_key\"\n      },\n      \"api-proxy-google:default\": {\n        \"provider\": \"api-proxy-google\",\n        \"mode\": \"api_key\"\n      }\n    }\n  }\n}\n```\n\n**关键配置说明：**\n\n| 字段 | 说明 | 必需 |\n|------|------|------|\n| baseUrl | 自定义API端点 | ✅ |\n| apiKey | 你的API密钥 | ✅ |\n| api | API类型（openai-completions\u002Fanthropic-messages\u002Fgoogle-generative-ai） | ✅ |\n| models | 模型列表，必须包含此字段 | ✅ |\n\n**步骤3：配置鉴权文件**\n\n编辑 `~\u002F.clawdbot\u002Fagents\u002Fmain\u002Fagent\u002Fauth-profiles.json`：\n\n```bash\nnano ~\u002F.clawdbot\u002Fagents\u002Fmain\u002Fagent\u002Fauth-profiles.json\n```\n\n添加以下内容：\n\n```json\n{\n  \"version\": 1,\n  \"profiles\": {\n    \"api-proxy-gpt:default\": {\n      \"type\": \"api_key\",\n      \"provider\": \"api-proxy-gpt\",\n      \"key\": \"sk-你的API密钥\"\n    },\n    \"api-proxy-claude:default\": {\n      \"type\": \"api_key\",\n      \"provider\": \"api-proxy-claude\",\n      \"key\": \"sk-你的API密钥\"\n    },\n    \"api-proxy-google:default\": {\n      \"type\": \"api_key\",\n      \"provider\": \"api-proxy-google\",\n      \"key\": \"sk-你的API密钥\"\n    }\n  },\n  \"lastGood\": {\n    \"api-proxy-gpt\": \"api-proxy-gpt:default\",\n    \"api-proxy-claude\": \"api-proxy-claude:default\",\n    \"api-proxy-google\": \"api-proxy-google:default\"\n  }\n}\n```\n\n---\n\n### 方案二：配置 Claude Code 中转（需要 User-Agent）\n\n如果你使用的是需要 Claude Code User-Agent 验证的中转站：\n\n#### 1. 获取API凭证\n\n- **API Base URL**: `https:\u002F\u002Fcode.claude-opus.top\u002Fapi`\n- **API Key**: `cr_xxxxxxxxxxxxx`\n\n#### 2. 配置文件（带 User-Agent）\n\n```json\n{\n  \"models\": {\n    \"providers\": {\n      \"code-claude-opus\": {\n        \"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\",\n        \"apiKey\": \"cr_你的API密钥\",\n        \"auth\": \"api-key\",\n        \"api\": \"anthropic-messages\",\n        \"models\": [\n          {\n            \"id\": \"claude-opus-4-20250514\",\n            \"name\": \"Claude Opus 4\",\n            \"reasoning\": false,\n            \"input\": [\"text\"],\n            \"cost\": {\n              \"input\": 0,\n              \"output\": 0,\n              \"cacheRead\": 0,\n              \"cacheWrite\": 0\n            },\n            \"contextWindow\": 200000,\n            \"maxTokens\": 8192,\n            \"headers\": {\n              \"User-Agent\": \"Claude-Code\u002F1.0.0\"\n            }\n          }\n        ]\n      }\n    }\n  }\n}\n```\n\n**关键点：** 在 `models` 数组的每个模型中添加 `headers` 字段来设置自定义 User-Agent。\n\n**完整配置示例：**\n\n```json\n{\n  \"meta\": {\n    \"lastTouchedVersion\": \"2026.1.25\",\n    \"lastTouchedAt\": \"2026-01-27T01:05:21.233Z\"\n  },\n  \"models\": {\n    \"providers\": {\n      \"anthropic\": {\n        \"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\",\n        \"apiKey\": \"cr_你的API密钥\",\n        \"api\": \"anthropic-messages\",\n        \"models\": []\n      }\n    }\n  },\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"anthropic\u002Fclaude-sonnet-4-5\"\n      },\n      \"workspace\": \"\u002FUsers\u002F你的用户名\u002Fclawd\",\n      \"maxConcurrent\": 4\n    }\n  },\n  \"gateway\": {\n    \"port\": 18789,\n    \"mode\": \"local\",\n    \"bind\": \"loopback\",\n    \"auth\": {\n      \"mode\": \"token\",\n      \"token\": \"你的gateway_token\"\n    }\n  },\n  \"channels\": {\n    \"telegram\": {\n      \"enabled\": false\n    }\n  }\n}\n```\n\n#### 步骤4：验证配置格式\n\n```bash\n# 使用jq验证JSON格式\ncat ~\u002F.clawdbot\u002Fclawdbot.json | jq '.models'\n\n# 验证鉴权配置\ncat ~\u002F.clawdbot\u002Fagents\u002Fmain\u002Fagent\u002Fauth-profiles.json | jq '.'\n```\n\n### 3. 重启Gateway服务\n\n```bash\nclawdbot gateway restart\n```\n\n### 4. 验证配置生效\n\n```bash\n# 检查Gateway状态\nclawdbot channels status\n\n# 应该显示：\n# Gateway reachable.\n```\n\n---\n\n## 验证和测试\n\n### 1. 检查Gateway状态\n\n```bash\nclawdbot channels status\n```\n\n**正常输出：**\n```\nGateway reachable.\n- Telegram default: disabled, configured, stopped\n```\n\n### 2. 访问Web UI\n\n打开浏览器访问：\n\n```\nhttp:\u002F\u002F127.0.0.1:18789\u002F?token=你的token\n```\n\n**Web UI功能：**\n- 💬 Chat: 直接与AI对话\n- 📊 Overview: 查看系统状态\n- 🔌 Channels: 管理消息通道\n- ⚙️ Config: 修改配置\n\n### 3. 发送测试消息\n\n在Web UI的Chat界面：\n\n1. 输入消息：`Hello, can you hear me?`\n2. 点击Send按钮\n3. 等待AI回复\n\n**预期结果：**\n- 状态显示\"Health OK\"\n- 收到AI的回复消息\n- 右上角显示token使用情况\n\n### 4. 查看日志\n\n如果遇到问题，检查日志：\n\n```bash\n# Gateway主日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.log\n\n# 错误日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.err.log\n\n# 详细调试日志\ntail -f \u002Ftmp\u002Fclawdbot\u002Fclawdbot-$(date +%Y-%m-%d).log\n```\n\n---\n\n## 常见踩坑点\n\n### ❌ 踩坑1：环境变量配置无效\n\n**错误做法：**\n```bash\n# 在LaunchAgent中设置环境变量（无效！）\n\u003Ckey>ANTHROPIC_BASE_URL\u003C\u002Fkey>\n\u003Cstring>https:\u002F\u002Fcode.claude-opus.top\u002Fapi\u003C\u002Fstring>\n```\n\n**问题原因：** Clawdbot不支持通过`ANTHROPIC_BASE_URL`环境变量来设置自定义API端点。\n\n**✅ 正确做法：** 在`~\u002F.clawdbot\u002Fclawdbot.json`配置文件中添加：\n```json\n{\n  \"models\": {\n    \"providers\": {\n      \"anthropic\": {\n        \"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\",\n        \"apiKey\": \"cr_你的密钥\",\n        \"api\": \"anthropic-messages\",\n        \"models\": []\n      }\n    }\n  }\n}\n```\n\n### ❌ 踩坑2：缺少models字段\n\n**错误配置：**\n```json\n{\n  \"models\": {\n    \"providers\": {\n      \"anthropic\": {\n        \"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\",\n        \"apiKey\": \"cr_xxx\",\n        \"api\": \"anthropic-messages\"\n        \u002F\u002F 缺少models字段！\n      }\n    }\n  }\n}\n```\n\n**错误信息：**\n```\nInvalid config at ~\u002F.clawdbot\u002Fclawdbot.json:\n- models.providers.anthropic.models: Invalid input: expected array\n```\n\n**✅ 正确做法：** 必须包含`models`字段，即使是空数组：\n```json\n{\n  \"models\": {\n    \"providers\": {\n      \"anthropic\": {\n        \"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\",\n        \"apiKey\": \"cr_xxx\",\n        \"api\": \"anthropic-messages\",\n        \"models\": []  \u002F\u002F 必须有这一行！\n      }\n    }\n  }\n}\n```\n\n### ❌ 踩坑3：Telegram连接失败导致Gateway不稳定\n\n**症状：**\n- Gateway不断重启\n- 日志显示`TypeError: fetch failed`\n- Web UI无法连接\n\n**✅ 解决方案：** 临时禁用Telegram：\n```bash\nclawdbot config set channels.telegram.enabled false\nclawdbot gateway restart\n```\n\n### ❌ 踩坑4：Node.js版本过低\n\n**错误信息：**\n```\nclawdbot requires Node >=22.0.0.\nDetected: node 20.19.0\n```\n\n**✅ 解决方案：**\n```bash\nnvm install 22\nnvm use 22\nnvm alias default 22\nnode --version  # 应显示 v22.x.x\n```\n\n### ❌ 踩坑5：中转API需要特定User-Agent\n\n**症状：** API返回403错误，提示\"本服务仅限 Claude Code 官方客户端使用\"\n\n**问题原因：** 某些中转站要求特定的User-Agent header。\n\n**✅ 解决方案：** 在模型配置中添加`headers`字段：\n```json\n{\n  \"models\": {\n    \"providers\": {\n      \"code-claude-opus\": {\n        \"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\",\n        \"apiKey\": \"cr_你的密钥\",\n        \"api\": \"anthropic-messages\",\n        \"models\": [\n          {\n            \"id\": \"claude-opus-4-20250514\",\n            \"name\": \"Claude Opus 4\",\n            \"headers\": {\n              \"User-Agent\": \"Claude-Code\u002F1.0.0\"\n            },\n            \"contextWindow\": 200000,\n            \"maxTokens\": 8192\n          }\n        ]\n      }\n    }\n  }\n}\n```\n\n### ❌ 踩坑6：忘记重启Gateway\n\n**问题：** 修改配置后没有重启Gateway，配置不生效。\n\n**✅ 解决方案：**\n```bash\n# 每次修改配置后都要重启\nclawdbot gateway restart\n\n# 验证配置生效\nclawdbot channels status\n```\n\n---\n\n## 常见问题FAQ\n\n### Q1: Gateway无法连接\n\n**症状：** Web UI显示\"disconnected (1006): no reason\"\n\n**解决方案：**\n```bash\n# 1. 检查Gateway是否运行\nps aux | grep clawdbot-gateway\n\n# 2. 检查端口占用\nlsof -i :18789\n\n# 3. 检查配置文件是否有效\ncat ~\u002F.clawdbot\u002Fclawdbot.json | jq '.'\n\n# 4. 重启Gateway\nclawdbot gateway restart\n\n# 5. 查看错误日志\ntail -50 ~\u002F.clawdbot\u002Flogs\u002Fgateway.err.log\n```\n\n### Q2: API调用失败\n\n**症状：** 日志显示\"TypeError: fetch failed\"\n\n**解决方案：**\n```bash\n# 1. 测试API端点可访问性\ncurl -s https:\u002F\u002Fcode.claude-opus.top\u002Fapi\u002Fv1\u002Fmessages \\\n  -H \"x-api-key: 你的API密钥\" \\\n  -H \"anthropic-version: 2023-06-01\" \\\n  -H \"content-type: application\u002Fjson\" \\\n  -d '{\"model\":\"claude-sonnet-4-5\",\"max_tokens\":100,\"messages\":[{\"role\":\"user\",\"content\":\"hi\"}]}'\n\n# 2. 验证配置文件\ncat ~\u002F.clawdbot\u002Fclawdbot.json | jq '.models.providers.anthropic'\n\n# 3. 确保包含所有必需字段\n# - baseUrl\n# - apiKey\n# - api: \"anthropic-messages\"\n# - models: []\n\n# 4. 重启Gateway\nclawdbot gateway restart\n```\n\n### Q3: Assistant不回复消息\n\n**症状：**\n- Web UI发送消息后无响应\n- 日志显示请求完成但耗时很短（\u003C 1秒）\n- 没有错误信息\n\n**解决方案：**\n1. 确认使用配置文件方式（见\"配置Claude Code API中转\"章节）\n2. 检查配置文件格式正确\n3. 重启Gateway\n4. 在Web UI中发送测试消息\n\n### Q4: 如何查看详细日志？\n\n```bash\n# Gateway主日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.log\n\n# 错误日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.err.log\n\n# 详细调试日志（JSON格式）\ntail -f \u002Ftmp\u002Fclawdbot\u002Fclawdbot-$(date +%Y-%m-%d).log\n\n# 过滤错误信息\ntail -f \u002Ftmp\u002Fclawdbot\u002Fclawdbot-$(date +%Y-%m-%d).log | grep -i \"error\\|fail\"\n```\n\n### Q5: 如何完全重置配置？\n\n```bash\n# 1. 备份当前配置\ncp -r ~\u002F.clawdbot ~\u002F.clawdbot.backup\n\n# 2. 停止Gateway\nclawdbot gateway stop\n\n# 3. 删除配置\nrm -rf ~\u002F.clawdbot\n\n# 4. 重新运行配置向导\nclawdbot onboard\n```\n\n---\n\n## 常用命令\n\n### Gateway管理\n\n```bash\n# 查看状态\nclawdbot channels status\n\n# 深度检查\nclawdbot channels status --deep\n\n# 重启Gateway\nclawdbot gateway restart\n\n# 停止Gateway\nlaunchctl unload ~\u002FLibrary\u002FLaunchAgents\u002Fcom.clawdbot.gateway.plist\n\n# 启动Gateway\nlaunchctl bootstrap gui\u002F$(id -u) ~\u002FLibrary\u002FLaunchAgents\u002Fcom.clawdbot.gateway.plist\n```\n\n### 配置管理\n\n```bash\n# 交互式配置\nclawdbot configure\n\n# 配置特定部分\nclawdbot configure --section gateway\nclawdbot configure --section channels\nclawdbot configure --section model\n\n# 设置配置项\nclawdbot config set gateway.mode local\nclawdbot config set channels.telegram.enabled false\n\n# 查看配置\ncat ~\u002F.clawdbot\u002Fclawdbot.json\n```\n\n### 日志查看\n\n```bash\n# Gateway主日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.log\n\n# 错误日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.err.log\n\n# 详细日志（JSON格式）\ntail -f \u002Ftmp\u002Fclawdbot\u002Fclawdbot-$(date +%Y-%m-%d).log\n```\n\n### 诊断工具\n\n```bash\n# 运行诊断\nclawdbot doctor\n\n# 自动修复问题\nclawdbot doctor --fix\n\n# 安全审计\nclawdbot security audit --deep\n```\n\n### Web UI\n\n```bash\n# 打开Web UI（浏览器）\nclawdbot dashboard\n\n# 获取带token的URL（不打开浏览器）\nclawdbot dashboard --no-open\n```\n\n### TUI（终端界面）\n\n```bash\n# 启动TUI\nclawdbot tui\n\n# TUI快捷键\n# Ctrl+C: 退出\n# Enter: 发送消息\n# Shift+Enter: 换行\n```\n\n### 更新\n\n```bash\n# 从源码更新\ncd \u002Fpath\u002Fto\u002Fclawdbot\ngit pull --rebase\npnpm install\npnpm build\nclawdbot gateway restart\n\n# 从npm更新（全局安装）\nnpm install -g clawdbot@latest\n```\n\n---\n\n## 配置文件位置\n\n```\n~\u002F.clawdbot\u002F\n├── clawdbot.json              # 主配置文件\n├── credentials\u002F               # API凭证\n├── sessions\u002F                  # 会话数据\n├── logs\u002F                      # 日志文件\n│   ├── gateway.log           # Gateway主日志\n│   └── gateway.err.log       # 错误日志\n└── agents\u002F                    # Agent工作空间\n    └── main\u002F\n        └── sessions\u002F          # 会话存储\n\n~\u002FLibrary\u002FLaunchAgents\u002F        # macOS服务配置\n└── com.clawdbot.gateway.plist\n\n\u002Ftmp\u002Fclawdbot\u002F                 # 临时日志\n└── clawdbot-YYYY-MM-DD.log   # 详细调试日志\n```\n\n---\n\n## 安全建议\n\n### 1. 保护API Key\n\n- ❌ 不要将API Key提交到Git\n- ✅ 定期轮换API Key\n- ✅ 使用配置文件而非环境变量\n\n### 2. Gateway Token\n\n- ❌ 不要分享Web UI的token URL\n- ✅ 定期更换Gateway token\n\n### 3. 网络安全\n\n- ✅ Gateway默认只监听localhost\n- ✅ 如需远程访问，使用Tailscale或VPN\n- ❌ 不要直接暴露到公网\n\n### 4. 数据备份\n\n```bash\n# 备份配置和会话\ntar -czf clawdbot-backup-$(date +%Y%m%d).tar.gz ~\u002F.clawdbot\u002F\n```\n\n---\n\n## 参考资源\n\n- **官方文档**: https:\u002F\u002Fdocs.clawd.bot\u002F\n- **GitHub仓库**: https:\u002F\u002Fgithub.com\u002Fclawdbot\u002Fclawdbot\n- **官方网站**: https:\u002F\u002Fclawd.bot\u002F\n- **社区讨论**: GitHub Issues\n\n---\n\n## 总结\n\n通过本教程，你应该已经：\n\n✅ 成功安装Clawdbot  \n✅ 正确配置Claude Code API中转（通过配置文件）  \n✅ 启动Gateway服务  \n✅ 通过Web UI与AI对话  \n✅ 了解常用命令和故障排除  \n✅ 避开了所有常见踩坑点\n\n### 关键要点\n\n1. **API配置方式：** 必须使用配置文件`~\u002F.clawdbot\u002Fclawdbot.json`中的`models.providers`\n2. **必需字段：** `baseUrl`、`apiKey`、`api`、`models`四个字段缺一不可\n3. **配置后重启：** 每次修改配置后必须运行`clawdbot gateway restart`\n4. **Telegram问题：** 如遇连接问题，先禁用Telegram使用Web UI\n5. **Node.js版本：** 必须22.0.0或更高\n\n### 快速参考\n\n```bash\n# 查看状态\nclawdbot channels status\n\n# 重启Gateway\nclawdbot gateway restart\n\n# 查看日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.log\n\n# 打开Web UI\nclawdbot dashboard\n\n# 配置文件位置\n~\u002F.clawdbot\u002Fclawdbot.json\n```\n\n祝使用愉快！🦞\n\n---\n\n**教程版本：** v2.0 (2026-01-27)  \n**更新内容：** 修正API配置方式，添加完整踩坑指南  \n**适用版本：** Clawdbot 2026.1.25+\n","# Clawdbot完整配置指南：从安装到Claude Code中转\n\n![](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fxianyu110_clawbot_readme_840c29522040.png)\n\n## 目录\n\n- [简介](#简介)\n- [系统要求](#系统要求)\n- [安装步骤](#安装步骤)\n- [配置Claude Code API中转](#配置claude-code-api中转)\n- [验证和测试](#验证和测试)\n- [常见踩坑点](#常见踩坑点)\n- [常见问题FAQ](#常见问题faq)\n- [常用命令](#常用命令)\n\n---\n\n# 推荐新的部署教程，[从零开始打造你的AI工作助手：最全面的中文教程，涵盖安装、配置、实战案例和避坑指南！](https:\u002F\u002Fawesome.tryopenclaw.asia)\n\n## 简介\n\nClawdbot是一个开源的本地AI助手，支持通过消息应用（Telegram、WhatsApp、Discord等）或Web UI与AI模型交互。\n\n**核心特点：**\n- 🦞 完全开源，数据本地存储\n- 💬 支持多种消息平台\n- 🌐 提供Web控制面板\n- 🔧 可自定义AI模型和API端点\n\n---\n\n## 系统要求\n\n### 必需条件\n\n| 项目 | 要求 |\n|------|------|\n| 操作系统 | macOS \u002F Linux \u002F Windows |\n| Node.js | 22.0.0 或更高版本 |\n| 包管理器 | pnpm（推荐）或 npm |\n\n### 可选条件\n\n- Xcode（仅macOS，如需构建原生应用）\n- 消息平台账号（Telegram Bot Token、Discord Bot等）\n\n---\n\n## 安装步骤\n\n### 1. 升级Node.js版本\n\nClawdbot要求Node.js 22+，使用nvm管理版本：\n\n```bash\n# 安装Node.js 22\nnvm install 22\n\n# 设置为默认版本\nnvm use 22\nnvm alias default 22\n\n# 验证版本\nnode --version  # 应显示 v22.x.x\n```\n\n### 2. 选择安装方式\n\n**方式一：npm安装（推荐）**\n\n```bash\nnpm install -g clawdbot\n```\n\n**方式二：一键安装脚本**\n\n```bash\ncurl -fsSL https:\u002F\u002Fclawd.bot\u002Finstall.sh | bash\n```\n\n**方式三：从源码安装**\n\n```bash\n# 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002Fclawdbot\u002Fclawdbot.git\ncd clawdbot\n\n# 安装依赖\npnpm install\n\n# 构建\npnpm build\n\n# 链接CLI\nnpm link\n```\n\n### 3. 初始化配置\n\n安装完成后运行配置向导：\n\n```bash\nclawdbot onboard\n```\n\n**配置向导流程：**\n\n#### 步骤1：安全确认\n\n```\n◇  Security ───────────────────────────────────────────────────────╮\n│  Clawdbot agents can run commands, read\u002Fwrite files, and act     │\n│  through any tools you enable.                                   │\n│  Please read: https:\u002F\u002Fdocs.clawd.bot\u002Fsecurity                    │\n├──────────────────────────────────────────────────────────────────╯\n\n◇  I understand this is powerful and inherently risky. Continue?\n│  Yes\n```\n\n#### 步骤2：选择AI后端\n\n```\n◇  Model\u002Fauth provider\n│  Anthropic\n\n◆  Anthropic auth method\n│  ● Anthropic token (paste setup-token) ← 推荐Claude Max用户\n│  ○ Anthropic token (Claude Code CLI)\n│  ○ Anthropic API key\n```\n\n**认证方式对比：**\n\n| 认证方式 | 适用场景 | 优点 | 缺点 |\n|---------|---------|------|------|\n| setup-token | Claude Max\u002FPro订阅用户 | 无需额外付费 | 需要额外步骤生成token |\n| Claude Code CLI | 已配置Claude Code的用户 | 自动读取凭证 | 可能找不到凭证文件 |\n| API Key | API按量付费用户 | 最直接 | 需要独立付费 |\n\n#### 步骤3：生成setup-token（Claude Max用户）\n\n在另一个终端运行：\n\n```bash\nclaude setup-token\n```\n\n复制生成的token，粘贴到配置向导中：\n\n```\n◇  Paste Anthropic setup-token\n│  sk-ant-oat01-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx...\n\n◇  Token name (blank = default)\n│  default\n\n◇  Default model\n│  Keep current (default: anthropic\u002Fclaude-opus-4-5)\n```\n\n> **提示：** Claude Max订阅用户不需要单独购买API Key，使用setup-token即可复用订阅额度。\n\n#### 步骤4：配置消息平台（可选）\n\n```\n◇  Channel status ────────────────────────────╮\n│  Telegram: not configured                   │\n│  WhatsApp: not configured                   │\n│  Discord: not configured                    │\n│  ...共支持 12+ 平台                          │\n├─────────────────────────────────────────────╯\n\n◇  Select channel (QuickStart)\n│  Telegram (Bot API)\n```\n\n**获取Telegram Bot Token：**\n\n1. 在Telegram中搜索 @BotFather\n2. 发送 `\u002Fnewbot`\n3. 按提示输入Bot名称和用户名\n4. 复制Bot Token\n\n#### 步骤5：完成配置\n\n```\n◇  Telegram: ok (@YourBotName) (1416ms)\n   Agents: main (default)\n   Heartbeat interval: 1h (main)\n\n◇  Control UI ─────────────────────────────────────────────────────╮\n│  Web UI: http:\u002F\u002F127.0.0.1:18789\u002F                                 │\n│  Web UI (with token): http:\u002F\u002F127.0.0.1:18789\u002F?token=your-token   │\n│  Gateway WS: ws:\u002F\u002F127.0.0.1:18789                                │\n├──────────────────────────────────────────────────────────────────╯\n\n└  Onboarding complete.\n```\n\n#### 步骤6：配对验证（如使用Telegram）\n\n去Telegram给你的Bot发消息，会收到配对码：\n\n```\nClawdbot: access not configured.\n\nYour Telegram user id: 1234567890\nPairing code: ABC12345\n\nAsk the bot owner to approve with:\nclawdbot pairing approve telegram \u003Ccode>\n```\n\n在终端批准配对：\n\n```bash\nclawdbot pairing approve telegram ABC12345\n```\n\n---\n\n## 配置自定义中转站（多模型支持）\n\n### 方案一：配置多模型中转站（推荐）\n\n这个方案支持同时配置 GPT、Claude、Gemini 等多个模型。\n\n#### 1. 获取API凭证\n\n从中转服务获取：\n- **API Base URL**: `https:\u002F\u002Fapipro.maynor1024.live`\n- **API Key**: `sk-xxxxxxxxxxxxx`\n\n**推荐服务：**\n- 推荐中转API：https:\u002F\u002Fapipro.maynor1024.live\u002F\n- 购买链接：https:\u002F\u002Fmaynorai.tqfk.xyz\u002Fitem\u002F7\n\n#### 2. 修改主配置文件\n\n> **⚠️ 重要提示：** Clawdbot不支持通过环境变量`ANTHROPIC_BASE_URL`来设置自定义API端点。必须通过配置文件的`models.providers`来配置。\n\n**步骤1：备份配置文件**\n\n```bash\ncp ~\u002F.clawdbot\u002Fclawdbot.json ~\u002F.clawdbot\u002Fclawdbot.json.bak\n```\n\n**步骤2：编辑配置文件**\n\n```bash\nnano ~\u002F.clawdbot\u002Fclawdbot.json\n```\n\n在配置文件中添加多个 provider：\n\n```json\n{\n  \"models\": {\n    \"mode\": \"merge\",\n    \"providers\": {\n      \"api-proxy-gpt\": {\n        \"baseUrl\": \"https:\u002F\u002Fapipro.maynor1024.live\u002Fv1\",\n        \"api\": \"openai-completions\",\n        \"apiKey\": \"sk-你的API密钥\",\n        \"models\": [\n          {\n            \"id\": \"gpt-4o\",\n            \"name\": \"GPT-4o\",\n            \"reasoning\": false,\n            \"input\": [\"text\"],\n            \"cost\": {\n              \"input\": 0,\n              \"output\": 0,\n              \"cacheRead\": 0,\n              \"cacheWrite\": 0\n            },\n            \"contextWindow\": 128000,\n            \"maxTokens\": 8192\n          }\n        ]\n      },\n      \"api-proxy-claude\": {\n        \"baseUrl\": \"https:\u002F\u002Fapipro.maynor1024.live\",\n        \"api\": \"anthropic-messages\",\n        \"apiKey\": \"sk-你的API密钥\",\n        \"models\": [\n          {\n            \"id\": \"claude-sonnet-4-5-20250929\",\n            \"name\": \"Claude Sonnet 4.5\",\n            \"reasoning\": false,\n            \"input\": [\"text\"],\n            \"cost\": {\n              \"input\": 0,\n              \"output\": 0,\n              \"cacheRead\": 0,\n              \"cacheWrite\": 0\n            },\n            \"contextWindow\": 200000,\n            \"maxTokens\": 8192\n          }\n        ]\n      },\n      \"api-proxy-google\": {\n        \"baseUrl\": \"https:\u002F\u002Fapipro.maynor1024.live\u002Fv1beta\",\n        \"api\": \"google-generative-ai\",\n        \"apiKey\": \"sk-你的API密钥\",\n        \"models\": [\n          {\n            \"id\": \"gemini-3-pro-preview\",\n            \"name\": \"Gemini 3 Pro\",\n            \"reasoning\": false,\n            \"input\": [\"text\"],\n            \"cost\": {\n              \"input\": 0,\n              \"output\": 0,\n              \"cacheRead\": 0,\n              \"cacheWrite\": 0\n            },\n            \"contextWindow\": 2000000,\n            \"maxTokens\": 8192\n          }\n        ]\n      }\n    }\n  },\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"api-proxy-claude\u002Fclaude-sonnet-4-5-20250929\"\n      },\n      \"models\": {\n        \"api-proxy-gpt\u002Fgpt-4o\": {\n          \"alias\": \"GPT-4o\"\n        },\n        \"api-proxy-claude\u002Fclaude-sonnet-4-5-20250929\": {\n          \"alias\": \"Claude Sonnet 4.5\"\n        },\n        \"api-proxy-google\u002Fgemini-3-pro-preview\": {\n          \"alias\": \"Gemini 3 Pro\"\n        }\n      }\n    }\n  },\n  \"auth\": {\n    \"profiles\": {\n      \"api-proxy-gpt:default\": {\n        \"provider\": \"api-proxy-gpt\",\n        \"mode\": \"api_key\"\n      },\n      \"api-proxy-claude:default\": {\n        \"provider\": \"api-proxy-claude\",\n        \"mode\": \"api_key\"\n      },\n      \"api-proxy-google:default\": {\n        \"provider\": \"api-proxy-google\",\n        \"mode\": \"api_key\"\n      }\n    }\n  }\n}\n```\n\n**关键配置说明：**\n\n| 字段 | 说明 | 必需 |\n|------|------|------|\n| baseUrl | 自定义API端点 | ✅ |\n| apiKey | 你的API密钥 | ✅ |\n| api | API类型（openai-completions\u002Fanthropic-messages\u002Fgoogle-generative-ai） | ✅ |\n| models | 模型列表，必须包含此字段 | ✅ |\n\n**步骤3：配置鉴权文件**\n\n编辑 `~\u002F.clawdbot\u002Fagents\u002Fmain\u002Fagent\u002Fauth-profiles.json`：\n\n```bash\nnano ~\u002F.clawdbot\u002Fagents\u002Fmain\u002Fagent\u002Fauth-profiles.json\n```\n\n添加以下内容：\n\n```json\n{\n  \"version\": 1,\n  \"profiles\": {\n    \"api-proxy-gpt:default\": {\n      \"type\": \"api_key\",\n      \"provider\": \"api-proxy-gpt\",\n      \"key\": \"sk-你的API密钥\"\n    },\n    \"api-proxy-claude:default\": {\n      \"type\": \"api_key\",\n      \"provider\": \"api-proxy-claude\",\n      \"key\": \"sk-你的API密钥\"\n    },\n    \"api-proxy-google:default\": {\n      \"type\": \"api_key\",\n      \"provider\": \"api-proxy-google\",\n      \"key\": \"sk-你的API密钥\"\n    }\n  },\n  \"lastGood\": {\n    \"api-proxy-gpt\": \"api-proxy-gpt:default\",\n    \"api-proxy-claude\": \"api-proxy-claude:default\",\n    \"api-proxy-google\": \"api-proxy-google:default\"\n  }\n}\n```\n\n---\n\n### 方案二：配置 Claude Code 中转（需要 User-Agent）\n\n如果你使用的是需要 Claude Code User-Agent 验证的中转站：\n\n#### 1. 获取API凭证\n\n- **API Base URL**: `https:\u002F\u002Fcode.claude-opus.top\u002Fapi`\n- **API Key**: `cr_xxxxxxxxxxxxx`\n\n#### 2. 配置文件（带 User-Agent）\n\n```json\n{\n  \"models\": {\n    \"providers\": {\n      \"code-claude-opus\": {\n        \"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\",\n        \"apiKey\": \"cr_你的API密钥\",\n        \"auth\": \"api-key\",\n        \"api\": \"anthropic-messages\",\n        \"models\": [\n          {\n            \"id\": \"claude-opus-4-20250514\",\n            \"name\": \"Claude Opus 4\",\n            \"reasoning\": false,\n            \"input\": [\"text\"],\n            \"cost\": {\n              \"input\": 0,\n              \"output\": 0,\n              \"cacheRead\": 0,\n              \"cacheWrite\": 0\n            },\n            \"contextWindow\": 200000,\n            \"maxTokens\": 8192,\n            \"headers\": {\n              \"User-Agent\": \"Claude-Code\u002F1.0.0\"\n            }\n          }\n        ]\n      }\n    }\n  }\n}\n```\n\n**关键点：** 在 `models` 数组的每个模型中添加 `headers` 字段来设置自定义 User-Agent。\n\n**完整配置示例：**\n\n```json\n{\n  \"meta\": {\n    \"lastTouchedVersion\": \"2026.1.25\",\n    \"lastTouchedAt\": \"2026-01-27T01:05:21.233Z\"\n  },\n  \"models\": {\n    \"providers\": {\n      \"anthropic\": {\n        \"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\",\n        \"apiKey\": \"cr_你的API密钥\",\n        \"api\": \"anthropic-messages\",\n        \"models\": []\n      }\n    }\n  },\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"anthropic\u002Fclaude-sonnet-4-5\"\n      },\n      \"workspace\": \"\u002FUsers\u002F你的用户名\u002Fclawd\",\n      \"maxConcurrent\": 4\n    }\n  },\n  \"gateway\": {\n    \"port\": 18789,\n    \"mode\": \"local\",\n    \"bind\": \"loopback\",\n    \"auth\": {\n      \"mode\": \"token\",\n      \"token\": \"你的gateway_token\"\n    }\n  },\n  \"channels\": {\n    \"telegram\": {\n      \"enabled\": false\n    }\n  }\n}\n```\n\n#### 步骤4：验证配置格式\n\n```bash\n# 使用jq验证JSON格式\ncat ~\u002F.clawdbot\u002Fclawdbot.json | jq '.models'\n\n# 验证鉴权配置\ncat ~\u002F.clawdbot\u002Fagents\u002Fmain\u002Fagent\u002Fauth-profiles.json | jq '.'\n```\n\n### 3. 重启Gateway服务\n\n```bash\nclawdbot gateway restart\n```\n\n### 4. 验证配置生效\n\n```bash\n# 检查Gateway状态\nclawdbot channels status\n\n# 应应该显示：\n# Gateway reachable.\n```\n\n---\n\n## 验证和测试\n\n### 1. 检查Gateway状态\n\n```bash\nclawdbot channels status\n```\n\n**正常输出：**\n```\nGateway reachable.\n- Telegram default: disabled, configured, stopped\n```\n\n### 2. 访问Web UI\n\n打开浏览器访问：\n\n```\nhttp:\u002F\u002F127.0.0.1:18789\u002F?token=你的token\n```\n\n**Web UI功能：**\n- 💬 Chat: 直接与AI对话\n- 📊 Overview: 查看系统状态\n- 🔌 Channels: 管理消息通道\n- ⚙️ Config: 修改配置\n\n### 3. 发送测试消息\n\n在Web UI的Chat界面：\n\n1. 输入消息：`Hello, can you hear me?`\n2. 点击Send按钮\n3. 等待AI回复\n\n**预期结果：**\n- 状态显示\"Health OK\"\n- 收到AI的回复消息\n- 右上角显示token使用情况\n\n### 4. 查看日志\n\n如果遇到问题，检查日志：\n\n```bash\n# Gateway主日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.log\n\n# 错误日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.err.log\n\n# 详细调试日志\ntail -f \u002Ftmp\u002Fclawdbot\u002Fclawdbot-$(date +%Y-%m-%d).log\n```\n\n---\n\n## 常见踩坑点\n\n### ❌ 踩坑1：环境变量配置无效\n\n**错误做法：**\n```bash\nexport ANTHROPIC_BASE_URL=\"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\"\nexport ANTHROPIC_API_KEY=\"cr_你的API密钥\"\nexport CLAWDBOT_MODELS='{\"providers\": {\"anthropic\": {\"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\", \"apiKey\": \"cr_你的API密钥\", \"api\": \"anthropic-messages\", \"models\": [{\"id\": \"claude-sonnet-4-5\", \"name\": \"Claude Sonnet 4.5\", \"reasoning\": false, \"input\": [\"text\"], \"cost\": {\"input\": 0, \"output\": 0, \"cacheRead\": 0, \"cacheWrite\": 0}, \"contextWindow\": 200000, \"maxTokens\": 8192}]} }}'\n\n# 在LaunchAgent中设置环境变量（无效！）\n\u003Ckey>ANTHROPIC_BASE_URL\u003C\u002Fkey>\n\u003Cstring>https:\u002F\u002Fcode.claude-opus.top\u002Fapi\u003C\u002Fstring>\n```\n\n**问题原因：** Clawdbot不支持通过`ANTHROPIC_BASE_URL`环境变量来设置自定义API端点。\n\n**✅ 正确做法：** 在`~\u002F.clawdbot\u002Fclawdbot.json`配置文件中添加：\n```json\n{\n  \"models\": {\n    \"providers\": {\n      \"anthropic\": {\n        \"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\",\n        \"apiKey\": \"cr_你的密钥\",\n        \"api\": \"anthropic-messages\",\n        \"models\": []\n      }\n    }\n  }\n}\n```\n\n### ❌ 踩坑2：缺少models字段\n\n**错误配置：**\n```json\n{\n  \"models\": {\n    \"providers\": {\n      \"anthropic\": {\n        \"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\",\n        \"apiKey\": \"cr_xxx\",\n        \"api\": \"anthropic-messages\"\n        \u002F\u002F 缺少models字段！\n      }\n    }\n  }\n}\n```\n\n**错误信息：**\n```\nInvalid config at ~\u002F.clawdbot\u002Fclawdbot.json:\n- models.providers.anthropic.models: Invalid input: expected array\n```\n\n**✅ 正确做法：** 必须包含`models`字段，即使是空数组：\n```json\n{\n  \"models\": {\n    \"providers\": {\n      \"anthropic\": {\n        \"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\",\n        \"apiKey\": \"cr_xxx\",\n        \"api\": \"anthropic-messages\",\n        \"models\": []  \u002F\u002F 必须有这一行！\n      }\n    }\n  }\n}\n```\n\n### ❌ 踩坑3：Telegram连接失败导致Gateway不稳定\n\n**症状：**\n- Gateway不断重启\n- 日志显示`TypeError: fetch failed`\n- Web UI无法连接\n\n**✅ 解决方案：** 临时禁用Telegram：\n```bash\nclawdbot config set channels.telegram.enabled false\nclawdbot gateway restart\n```\n\n### ❌ 踩坑4：Node.js版本过低\n\n**错误信息：**\n```\nclawdbot requires Node >=22.0.0.\nDetected: node 20.19.0\n```\n\n**✅ 解决方案：**\n```bash\nnvm install 22\nnvm use 22\nnvm alias default 22\nnode --version  # 应显示 v22.x.x\n```\n\n### ❌ 踩坑5：中转API需要特定User-Agent\n\n**症状：** API返回403错误，提示\"本服务仅限 Claude Code 官方客户端使用\"\n\n**问题原因：** 某些中转站要求特定的User-Agent header。\n\n**✅ 解决方案：** 在模型配置中添加`headers`字段：\n```json\n{\n  \"models\": {\n    \"providers\": {\n      \"code-claude-opus\": {\n        \"baseUrl\": \"https:\u002F\u002Fcode.claude-opus.top\u002Fapi\",\n        \"apiKey\": \"cr_你的密钥\",\n        \"api\": \"anthropic-messages\",\n        \"models\": [\n          {\n            \"id\": \"claude-opus-4-20250514\",\n            \"name\": \"Claude Opus 4\",\n            \"headers\": {\n              \"User-Agent\": \"Claude-Code\u002F1.0.0\"\n            },\n            \"contextWindow\": 200000,\n            \"maxTokens\": 8192\n          }\n        ]\n      }\n    }\n  }\n}\n```\n\n### ❌ 踩坑6：忘记重启Gateway\n\n**问题：** 修改配置后没有重启Gateway，配置不生效。\n\n**✅ 解决方案：**\n```bash\n# 每次修改配置后都要重启\nclawdbot gateway restart\n\n# 验证配置生效\nclawdbot channels status\n```\n\n---\n\n## 常见问题FAQ\n\n### Q1: Gateway无法连接\n\n**症状：** Web UI显示\"disconnected (1006): no reason\"\n\n**解决方案：**\n```bash\n# 1. 检查Gateway是否运行\nps aux | grep clawdbot-gateway\n\n# 2. 检查端口占用\nlsof -i :18789\n\n# 3. 检查配置文件是否有效\ncat ~\u002F.clawdbot\u002Fclawdbot.json | jq '.'\n\n# 4. 重启Gateway\nclawdbot gateway restart\n\n# 5. 查看错误日志\ntail -50 ~\u002F.clawdbot\u002Flogs\u002Fgateway.err.log\n```\n\n### Q2: API调用失败\n\n**症状：** 日志显示\"TypeError: fetch failed\"\n\n**解决方案：**\n```bash\n# 1. 测试API端点可访问性\ncurl -s https:\u002F\u002Fcode.claude-opus.top\u002Fapi\u002Fv1\u002Fmessages \\\n  -H \"x-api-key: 你的API密钥\" \\\n  -H \"anthropic-version: 2023-06-01\" \\\n  -H \"content-type: application\u002Fjson\" \\\n  -d '{\"model\":\"claude-sonnet-4-5\",\"max_tokens\":100,\"messages\":[{\"role\":\"user\",\"content\":\"hi\"}]}'\n\n# 2. 验证配置文件\ncat ~\u002F.clawdbot\u002Fclawdbot.json | jq '.models.providers.anthropic'\n\n# 3. 确保包含所有必需字段\n# - baseUrl\n# - apiKey\n# - api: \"anthropic-messages\"\n# - models: []\n\n# 4. 重启Gateway\nclawdbot gateway restart\n```\n\n### Q3: Assistant不回复消息\n\n**症状：**\n- Web UI发送消息后无响应\n- 日志显示请求完成但耗时很短（\u003C 1秒）\n- 没有错误信息\n\n**解决方案：**\n1. 确认使用配置文件方式（见\"配置Claude Code API中转\"章节）\n2. 检查配置文件格式正确\n3. 重启Gateway\n4. 在Web UI中发送测试消息\n\n### Q4: 如何查看详细日志？\n\n```bash\n# Gateway主日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.log\n\n# 错误日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.err.log\n\n# 详细调试日志（JSON格式）\ntail -f \u002Ftmp\u002Fclawdbot\u002Fclawdbot-$(date +%Y-%m-%d).log\n\n# 过滤错误信息\ntail -f \u002Ftmp\u002Fclawdbot\u002Fclawdbot-$(date +%Y-%m-%d).log | grep -i \"error\\|fail\"\n```\n\n### Q5: 如何完全重置配置？\n\n```bash\n# 1. 备份当前配置\ncp -r ~\u002F.clawdbot ~\u002F.clawdbot.backup\n\n# 2. 停止Gateway\nclawdbot gateway stop\n\n# 3. 删除配置\nrm -rf ~\u002F.clawdbot\n\n# 4. 重新运行配置向导\nclawdbot onboard\n```\n\n---\n\n## 常用命令\n\n### Gateway管理\n\n```bash\n# 查看状态\nclawdbot channels status\n\n# 深度检查\nclawdbot channels status --deep\n\n# 重启Gateway\nclawdbot gateway restart\n\n# 停止Gateway\nlaunchctl unload ~\u002FLibrary\u002FLaunchAgents\u002Fcom.clawdbot.gateway.plist\n\n# 启动Gateway\nlaunchctl bootstrap gui\u002F$(id -u) ~\u002FLibrary\u002FLaunchAgents\u002Fcom.clawdbot.gateway.plist\n```\n\n### 配置管理\n\n```bash\n# 交互式配置\nclawdbot configure\n\n# 配置特定部分\nclawdbot configure --section gateway\nclawdbot configure --section channels\nclawdbot configure --section model\n\n# 设置配置项\nclawdbot config set gateway.mode local\nclawdbot config set channels.telegram.enabled false\n\n# 查看配置\ncat ~\u002F.clawdbot\u002Fclawdbot.json\n```\n\n### 日志查看\n\n```bash\n# Gateway主日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.log\n\n# 错误日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.err.log\n\n# 详细日志（JSON格式）\ntail -f \u002Ftmp\u002Fclawdbot\u002Fclawdbot-$(date +%Y-%m-%d).log\n```\n\n### 诊断工具\n\n```bash\n# 运行诊断\nclawdbot doctor\n\n# 自动修复问题\nclawdbot doctor --fix\n\n# 安全审计\nclawdbot security audit --deep\n```\n\n### Web UI\n\n```bash\n# 打开Web UI（浏览器）\nclawdbot dashboard\n\n# 获取带token的URL（不打开浏览器）\nclawdbot dashboard --no-open\n```\n\n### TUI（终端界面）\n\n```bash\n# 启动TUI\nclawdbot tui\n\n# TUI快捷键：\n# Ctrl+C: 退出\n# Enter: 发送消息\n# Shift+Enter: 换行\n```\n\n### 更新\n\n```bash\n# 从源码更新\ncd \u002Fpath\u002Fto\u002Fclawdbot\ngit pull --rebase\npnpm install\npnpm build\nclawdbot gateway restart\n\n# 从npm更新（全局安装）\nnpm install -g clawdbot@latest\n```\n\n---\n\n## 配置文件位置\n\n```\n~\u002F.clawdbot\u002F\n├── clawdbot.json              # 主配置文件\n├── credentials\u002F               # API凭证\n├── sessions\u002F                  # 会话数据\n├── logs\u002F                      # 日志文件\n│   ├── gateway.log           # Gateway主日志\n│   └── gateway.err.log       # 错误日志\n└── agents\u002F                    # Agent工作空间\n    └── main\u002F\n        └── sessions\u002F          # 会话存储\n\n~\u002FLibrary\u002FLaunchAgents\u002F        # macOS服务配置\n└── com.clawdbot.gateway.plist\n\n\u002Ftmp\u002Fclawdbot\u002F                 # 临时日志\n└── clawdbot-YYYY-MM-DD.log   # 详细调试日志\n```\n\n---\n\n## 安全建议\n\n### 1. 保护API Key\n\n- ❌ 不要将API Key提交到Git\n- ✅ 定期轮换API Key\n- ✅ 使用配置文件而非环境变量\n\n### 2. Gateway Token\n\n- ❌ 不要分享Web UI的token URL\n- ✅ 定期更换Gateway token\n\n### 3. 网络安全\n\n- ✅ Gateway默认只监听localhost\n- ✅ 如需远程访问，使用Tailscale或VPN\n- ❌ 不要直接暴露到公网\n\n### 4. 数据备份\n\n```bash\n# 备份配置和会话\ntar -czf clawdbot-backup-$(date +%Y%m%d).tar.gz ~\u002F.clawdbot\u002F\n```\n\n---\n\n## 参考资源\n\n- **官方文档**: https:\u002F\u002Fdocs.clawd.bot\u002F\n- **GitHub仓库**: https:\u002F\u002Fgithub.com\u002Fclawdbot\u002Fclawdbot\n- **官方网站**: https:\u002F\u002Fclawd.bot\u002F\n- **社区讨论**: GitHub Issues\n\n---\n\n## 总结\n\n通过本教程，你应该已经：\n\n✅ 成功安装Clawdbot  \n✅ 正确配置Claude Code API中转（通过配置文件）  \n✅ 启动Gateway服务  \n✅ 通过Web UI与AI对话  \n✅ 了解常用命令和故障排除  \n✅ 避开了所有常见踩坑点\n\n### 关键要点\n\n1. **API配置方式：** 必须使用配置文件`~\u002F.clawdbot\u002Fclawdbot.json`中的`models.providers`\n2. **必需字段：** `baseUrl`、`apiKey`、`api`、`models`四个字段缺一不可\n3. **配置后重启：** 每次修改配置后必须运行`clawdbot gateway restart`\n4. **Telegram问题：** 如遇连接问题，先禁用Telegram使用Web UI\n5. **Node.js版本：** 必须22.0.0或更高\n\n### 快速参考\n\n```bash\n# 查看状态\nclawdbot channels status\n\n# 重启Gateway\nclawdbot gateway restart\n\n# 查看日志\ntail -f ~\u002F.clawdbot\u002Flogs\u002Fgateway.log\n\n# 打开Web UI\nclawdbot dashboard\n\n# 配置文件位置\n~\u002F.clawdbot\u002Fclawdbot.json\n```\n\n祝使用愉快！🦞\n\n---\n\n**教程版本：** v2.0 (2026-01-27)  \n**更新内容：** 修正API配置方式，添加完整踩坑指南  \n**适用版本：** Clawdbot 2026.1.25+","# Clawdbot 快速上手指南\n\nClawdbot 是一个开源的本地 AI 助手，支持通过 Telegram、Discord 等消息应用或 Web UI 与 AI 模型（如 Claude、GPT-4）交互。它完全开源，数据本地存储，并支持自定义 API 端点。\n\n## 1. 环境准备\n\n在开始之前，请确保你的系统满足以下要求：\n\n*   **操作系统**：macOS \u002F Linux \u002F Windows\n*   **Node.js**：版本 **22.0.0** 或更高（必需）\n*   **包管理器**：推荐使用 `pnpm`，也可使用 `npm`\n\n### 升级 Node.js 版本\nClawdbot 强依赖 Node.js 22+。如果你使用的是 `nvm` (Node Version Manager)，请执行以下命令：\n\n```bash\n# 安装并切换到 Node.js 22\nnvm install 22\nnvm use 22\nnvm alias default 22\n\n# 验证版本\nnode --version  # 应显示 v22.x.x\n```\n\n## 2. 安装步骤\n\n你可以选择以下任意一种方式进行安装：\n\n### 方式一：全局安装（推荐）\n直接使用 npm 全局安装 CLI 工具：\n\n```bash\nnpm install -g clawdbot\n```\n\n### 方式二：一键脚本安装\n适合快速部署：\n\n```bash\ncurl -fsSL https:\u002F\u002Fclawd.bot\u002Finstall.sh | bash\n```\n\n### 方式三：源码安装\n适合需要最新特性或贡献代码的开发者：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fclawdbot\u002Fclawdbot.git\ncd clawdbot\npnpm install\npnpm build\nnpm link\n```\n\n## 3. 基本使用\n\n安装完成后，通过初始化向导完成配置即可开始使用。\n\n### 第一步：运行初始化向导\n在终端输入以下命令启动配置流程：\n\n```bash\nclawdbot onboard\n```\n\n### 第二步：跟随向导配置\n向导将引导你完成以下关键步骤：\n\n1.  **安全确认**：阅读风险提示并输入 `Yes` 继续。\n2.  **选择 AI 后端**：\n    *   推荐选择 **Anthropic**。\n    *   **认证方式**：\n        *   若你是 **Claude Max\u002FPro 订阅用户**：选择 `Anthropic token (paste setup-token)`。需在另一终端运行 `claude setup-token` 获取令牌并粘贴。\n        *   若使用 **API Key**：选择 `Anthropic API key` 并粘贴密钥。\n3.  **配置消息通道（可选）**：\n    *   可选择连接 Telegram、WhatsApp 或 Discord。\n    *   以 **Telegram** 为例：选择 `Telegram (Bot API)`，然后填入从 @BotFather 获取的 Bot Token。\n4.  **完成配置**：\n    *   配置成功后，终端会显示 Web UI 地址（通常为 `http:\u002F\u002F127.0.0.1:18789\u002F`）。\n\n### 第三步：开始对话\n\n#### 方法 A：使用 Web UI（最直观）\n1.  打开浏览器访问终端显示的地址（例如：`http:\u002F\u002F127.0.0.1:18789\u002F?token=你的 token`）。\n2.  进入 **Chat** 界面。\n3.  输入消息（如 `Hello`），即可直接与 AI 对话。\n\n#### 方法 B：使用 Telegram（需配对）\n如果你在向导中配置了 Telegram：\n1.  在 Telegram 中向你的 Bot 发送任意消息。\n2.  Bot 会回复一个 **配对码 (Pairing code)** 和你的 User ID。\n3.  在终端执行批准命令：\n    ```bash\n    clawdbot pairing approve telegram \u003C配对码>\n    ```\n4.  批准后，即可直接在 Telegram 中与 AI 聊天。\n\n### 进阶提示：配置国内中转 API\n如果需要访问更快的节点或使用多模型（GPT\u002FClaude\u002FGemini），需手动编辑配置文件，因为环境变量方式无效。\n\n1.  备份并编辑配置文件：\n    ```bash\n    cp ~\u002F.clawdbot\u002Fclawdbot.json ~\u002F.clawdbot\u002Fclawdbot.json.bak\n    nano ~\u002F.clawdbot\u002Fclawdbot.json\n    ```\n2.  在 `models.providers` 中添加自定义服务商（示例）：\n    ```json\n    {\n      \"models\": {\n        \"providers\": {\n          \"my-proxy\": {\n            \"baseUrl\": \"https:\u002F\u002F你的中转站域名\u002Fv1\",\n            \"api\": \"openai-completions\", \n            \"apiKey\": \"sk-你的密钥\",\n            \"models\": [\n              {\n                \"id\": \"gpt-4o\",\n                \"name\": \"GPT-4o\",\n                \"input\": [\"text\"],\n                \"contextWindow\": 128000,\n                \"maxTokens\": 8192\n              }\n            ]\n          }\n        }\n      }\n    }\n    ```\n    *注意：必须包含 `models` 数组字段，即使为空也不能省略。*\n3.  重启服务使配置生效：\n    ```bash\n    clawdbot gateway restart\n    ```","某独立开发者希望利用自己的 Claude Max 订阅额度，在 Telegram 上构建一个能随时响应代码审查请求的私人 AI 助手，同时确保所有对话数据留存本地。\n\n### 没有 clawbot 时\n- **订阅资源浪费**：拥有昂贵的 Claude Max 会员资格，却无法在非网页端（如手机即时通讯软件）直接调用，必须频繁切换浏览器标签页。\n- **数据隐私担忧**：使用第三方封装的机器人存在聊天记录泄露风险，且无法掌控数据存储位置，敏感代码片段不敢随意发送。\n- **配置门槛极高**：若想自建中转服务，需手动处理复杂的 API 鉴权、Node.js 环境依赖及多平台 Bot Token 对接，极易因配置错误而放弃。\n- **多模型管理混乱**：若需同时测试不同模型（如对比 Opus 与 Sonnet），缺乏统一的管理面板，每次切换都需修改底层配置文件。\n\n### 使用 clawbot 后\n- **无缝复用额度**：通过简单的 `claude setup-token` 命令生成凭证，即可让 Telegram 机器人直接复用本地的 Claude Max 订阅，无需额外支付 API 费用。\n- **数据完全自主**：所有交互记录默认存储在本地设备，配合开源架构，彻底消除了将核心代码上传至未知服务器的安全顾虑。\n- **一键极速部署**：运行 `clawdbot onboard` 向导，几分钟内自动完成从环境检测、模型认证到 Telegram 配对的全流程，无需编写任何胶水代码。\n- **灵活中控管理**：内置 Web 控制面板可实时查看状态，并轻松切换或新增其他模型后端（如 Gemini 或 GPT），实现“一个入口，多模型调度”。\n\nclawbot 将原本繁琐的私有化 AI 部署转化为简单的命令行交互，让开发者能以零成本、高隐私的方式将顶级大模型能力延伸至任意即时通讯场景。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fxianyu110_clawbot_2d885b97.png","xianyu110","Maynor","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fxianyu110_6c4a874d.jpg","OpenClaw实操手册作者\r\nOPC创业ing","AI编程公众号【MaynorAI】","China",null,"https:\u002F\u002Fblog.csdn.net\u002Fxianyu120","https:\u002F\u002Fgithub.com\u002Fxianyu110",883,124,"2026-04-08T09:42:09","macOS, Linux, Windows","未说明",{"notes":87,"python":85,"dependencies":88},"该工具基于 Node.js 运行，非 Python 项目。必需安装 Node.js 22.0.0 或更高版本（推荐使用 nvm 管理）。包管理器推荐使用 pnpm。如需在 macOS 上构建原生应用，需安装 Xcode。支持通过配置文件自定义多种 AI 模型后端（如 Anthropic, OpenAI, Google 等），不支持通过环境变量设置自定义 API 端点，必须修改 JSON 配置文件。",[89,90],"Node.js >= 22.0.0","pnpm (推荐) 或 npm",[35,13,52],[64,6],"2026-03-27T02:49:30.150509","2026-04-09T21:09:59.401280",[96,101,106,111,116,121],{"id":97,"question_zh":98,"answer_zh":99,"source_url":100},26479,"项目是否改名了？现在的项目名称是什么？","是的，项目已经改名。最初被称为 moltbot，现在的正式名称是 openclaw。","https:\u002F\u002Fgithub.com\u002Fxianyu110\u002Fclawbot\u002Fissues\u002F2",{"id":102,"question_zh":103,"answer_zh":104,"source_url":105},26480,"配置 Claude 中转时遇到凭证授权错误（invalid_request_error）怎么办？","如果报错提示 \"This credential is only authorized for use with Claude Code...\"，说明该凭证仅限 Claude Code 使用。建议尝试更换账号分组，或直接联系微信客服 coder-maynor 获取支持。","https:\u002F\u002Fgithub.com\u002Fxianyu110\u002Fclawbot\u002Fissues\u002F3",{"id":107,"question_zh":108,"answer_zh":109,"source_url":110},26481,"遇到 \"500 No available Claude accounts support the requested model\" 错误如何解决？","该错误表示当前没有可用的 Claude 账号支持请求的模型（如 claude-sonnet-4-5）。请直接联系微信客服 coder-maynor 进行排查和解决。","https:\u002F\u002Fgithub.com\u002Fxianyu110\u002Fclawbot\u002Fissues\u002F6",{"id":112,"question_zh":113,"answer_zh":114,"source_url":115},26482,"如何设置 OpenAI 的中转配置？关键字段该怎么填？","关于 OpenAI 中转的具体关键字段设置，官方建议可以直接询问 AI 助手获取详细的配置指导。","https:\u002F\u002Fgithub.com\u002Fxianyu110\u002Fclawbot\u002Fissues\u002F1",{"id":117,"question_zh":118,"answer_zh":119,"source_url":120},26483,"是否有推荐的折扣版 Claude 中转服务提供商？","有用户推荐 siray.ai (https:\u002F\u002Fwww.siray.ai\u002F)，该站点提供有折扣的 Claude 中转服务。","https:\u002F\u002Fgithub.com\u002Fxianyu110\u002Fclawbot\u002Fissues\u002F5",{"id":122,"question_zh":123,"answer_zh":124,"source_url":105},26484,"遇到配置问题无法自行解决时，如何联系官方支持？","对于各类配置错误或账号问题，统一的解决方案是联系微信客服，微信号为：coder-maynor。",[]]