Go cqhttp - sandtechnology/OtterBot GitHub Wiki

cqhttp-go

1. 先请自行下载cqhttp-go

2. 新建一个文件夹(以英文命名, eg. tata),将go-cqhttp.exe放入其中,从獭窝下载配置文件并放在同路径(客户端选择Go-cqhttp)

或根据注释及下文档建立config.yml(只需要在意带注释的字段,其余字段请不要更改)

# go-cqhttp 默认配置文件

account: # 账号相关
  uin: 1233456 # 机器人的QQ账号
  password: '' # 机器人的qq密码,密码为空时使用扫码登录(推荐)
  encrypt: false
  status: 0      # 在线状态 请参考 https://github.com/Mrs4s/go-cqhttp/blob/dev/docs/config.md#在线状态
  relogin:
    disabled: false
    delay: 3
    interval: 0
    max-times: 0
  use-sso-address: true

heartbeat:
  # 心跳频率, 单位秒
  # -1 为关闭心跳
  interval: 5

message:
  post-format: string
  ignore-invalid-cqcode: false
  force-fragment: false
  fix-url: false
  proxy-rewrite: ''
  report-self-message: false
  remove-reply-at: false
  extra-reply-data: false

output:
  # 日志等级 trace,debug,info,warn,error
  log-level: warn
  # 是否启用 DEBUG
  debug: false # 开启调试模式

default-middlewares: &default
  # 访问密钥, 即申请獭獭时的token
  access-token: ''
  filter: ''
  rate-limit:
    enabled: false
    frequency: 1
    bucket: 1

servers:
  - ws-reverse:
      universal: ws://xn--v9x.net/ws
      api: 
      event: 
      # 重连间隔 单位毫秒
      reconnect-interval: 3000
      middlewares:
        <<: *default

  # 可添加更多
  #- ws-reverse:
  #- ws:
  #- http:
  #- pprof:

database:
  leveldb:
    enable: true

3. 在该目录下打开cmd或powershell,运行./go-cqhttp即可。

注意事项

  1. 推荐使用扫码登录(即不填password字段)
  2. 当提示“上网环境异常”等字样时,删除目录下的device.jsonsession.token两文件,再尝试扫码登录
  3. 跟换服务器/迁移bot请带上device.jsonsession.token两文件
  4. 扫码登录时若看不清/看不全/看不见二维码,打开目录下qrcode.png,扫描即可

事件过滤器

关于事件过滤器启动失败: open filter.json: The system cannot find the file specified.报错

一般不用管,若要启用事件过滤器,请看相关文档

更改登录设备版本

找到设备信息 device.json文件,更改protocol字段即可:

类型 登录状态 限制
0 iPad 苹果平板在线
1 Android Phone 安卓手机在线 无法接收新版表情如 /吃瓜/汪汪, 会自动转换为字符串
2 Android Watch 安卓手表在线 Android Phone的限制外, 无法接收 notify 事件、无法接收口令红包、无法接收撤回消息
3 MacOS 苹果电脑在线

注意, 根据协议的不同, 各类消息有所限制

更改protocol字段后可能需要重新验证设备锁