ClawdBot配置教程

必看！！！！！！！！！！！

应用配置后容器停止是正常的，这代表你的配置文件没有错误，重启容器就好了

首次进入应用，点击Overview，Gateway Token填写 admin，点击Connect

提前说明

如果需要使用命令行操作（验证电报、配置oauth）

新版Moltbot、openclaw自带终端，点击新建终端可以直接进入容器

在默认的/app目录下，将所有官方文档的clawdbot命令换成node dist/index.js（openclaw不需要替换）

比如：

验证电报机器人

moltbot：node dist/index.js pairing approve telegram 验证码

openclaw：openclawpairing approve telegram 验证码

其他命令直接输入node dist/index.js查看

clawdbot内置了强大的工具，只要将ai配置成功就万事大吉，其他的所有的配置包括添加频道都可以通过与ai对话的形式让clawdbot自己给自己修改配置，跟聊天一样！！！

所有使用中的问题也可以通过与clawdbot对话让它自己去尝试解决

（尽量避免使用带推理的模型）

开始配置

点击config，切换到RAW模式，将填写完成的配置粘贴进去，点击save保存

最小运行配置（更多供应商配置及参数请查阅官方文档）：

点击我访问可视化配置工具网站

{
  "browser": {
    "enabled": true,
    "executablePath": "/usr/bin/chromium",
    "headless": true,
    "noSandbox": true,
    "defaultProfile": "clawd"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "自定义供应商名称": {
        "baseUrl": "供应商API地址",
        "apiKey": "供应商密钥",
        "auth": "token",
        "api": "openai-completions",
        "authHeader": true,
        "models": [
          {
            "id": "模型ID",
            "name": "模型名字",
            "api": "openai-completions",
            "reasoning": false,
            "input": [
              "text",
              "image"
            ],
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "自定义供应商名称/模型ID"
      },
      "workspace": "/home/node/clawd",
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "gateway": {
    "mode": "local",
    "controlUi": {
      "allowInsecureAuth": true
    },
    "auth": {
      "mode": "token",
      "token": "admin"
    }
  }
}

常见问题：

只有气泡没有模型输出？买台算力舱就好了（bushi）

• 1.尝试更换api端点版本（旧版openai-completions）
• "api": "openai-responses"
• 2.尝试关闭推理处理，或直接更换其他模型(尽量避免使用推理模型)
• "reasoning": false

供应商要不要加 /v1

• OpenAI 官方: https://api.openai.com/v1 （Ollama 提供 OpenAI 兼容的 API）
• Anthropic: https://api.anthropic.com （不需要 /v1）
• 大部分 OpenAI 兼容代理: 需要 /v1

增加Telegram聊天频道（配置文件中增加）：

创建telegram机器人的方法请自行Google

"channels": {
    "telegram": {
      "enabled": true,
      "dmPolicy": "pairing",
      "botToken": "你的telegram机器人的token",
      "groups": {
        "*": {
          "requireMention": false
        }
      },
      "groupPolicy": "open",
      "streamMode": "partial"
    }
  }

群组中机器人不回复消息？：

• 1.找 @BotFather

• 2.发送 /mybots → 选择你的 bot

• 3.点 Bot Settings → Group Privacy

• 4.设置为 Disabled（关闭隐私模式）

• 5.把机器人踢出群组再重新拉进来

• (有些群组要求 bot 必须是管理员才能读取消息。可以试试把 bot 设为管理员。)

• 验证步骤

• 先在 Telegram 私聊 bot 发条消息，看能不能回复

• 如果私聊可以、群组不行 → 99% 是 Privacy Mode 的问题

关于网页搜索的配置

clawdbot已经内置了 web_fetch — 抓取网页内容（给它一个url）

如果你需要更强大的网页搜索，可以点击这里申请免费的api key（个人免费额度完全够用），需要绑定卡，并且保证有5美元的可用额度用做验证（验证成功后会返还）

增加配置

browser:
  enabled: true

教程持续更新中。。。