GoLand中配置企业微信机器人需确保config.yaml字段与结构体yaml tag严格一致，Secret明文直填，Working directory指向配置文件所在根目录，并用viper正确加载；长连接模式下调试应关注WebSocket连接日志而非HTTP回调，启用机器人并开启「长连接」开关，断点设在onConnect而非HTTP handler。
GoLand里怎么配企业微信机器人所需的 secret 和 bot_id
直接在 config.yaml 里写死参数是最常见也最容易出问题的做法。GoLand 本身不解析配置文件语义，但能帮你避免拼错字段名、漏掉必填项、或把字符串误当布尔值用。
实际开发中，多数人卡在第一步：改完配置不生效，或者启动时报 missing required field "bot_id" —— 其实不是代码没读到，而是结构体字段 tag 没对上，或 YAML 缩进错了两格。
- 确保
config.yaml中字段名和 Go 结构体的yaml:tag 完全一致，比如：bot_id: "xxx"对应结构体字段BotID string `yaml:"bot_id"` - Secret 必须是原始字符串，不要加 base64 或 hex 编码；企业微信后台给的 Secret 就是明文，直接复制粘贴
- GoLand 的「Edit Configurations」里，检查
Working directory是否指向项目根目录（即config.yaml所在位置），否则os.ReadFile("config.yaml")会报no such file or directory - 如果用 viper 读配置，记得调用
viper.SetConfigName("config")和viper.AddConfigPath(".")，否则它根本不会去找当前目录下的文件
为什么用 GoLand 调试时收不到企微回调
长连接模式下根本不存在“回调”概念 —— 这是 Webhook 模式的术语。你在 GoLand 里跑的是主动建连客户端，不是 HTTP 服务端。所以调试时看不到任何 /callback 日志，也不需要监听端口。
真正要盯的是 WebSocket 连接状态和心跳日志。如果 connect 后立刻断开，大概率是 Bot ID 或 Secret 错了，或者企业微信那边还没点「保存」。
- 检查日志里有没有
wss://qyapi.weixin.qq.com/cgi-bin/webapp/ws连接成功消息，没有就说明没连上 - 确认企业微信后台该机器人已启用，并且「长连接」开关打开（不是默认的「URL 回调」）
- GoLand 的 Debug 控制台里，打断点在
onConnect回调函数入口，而不是 HTTP handler 里 —— 后者压根不会触发 - 如果连上后没收到消息，检查企业微信侧是否只对「创建者」开放私聊权限，普通成员发消息不会推送到你的长连接
GoLand 运行配置里要不要加环境变量
要，但只加运行时必需的，别把敏感信息塞进去。比如 WECHAT_BOT_ID 和 WECHAT_SECRET 这类，应该从 config.yaml 读，而不是靠环境变量覆盖 —— 否则团队协作时容易漏提交或误提交。
真正该设的环境变量只有两个：ENV=dev（控制是否加载 mock 数据）和 LOG_LEVEL=debug（让日志输出 WebSocket 帧内容）。
- GoLand 的「Run Configurations」→ 「Environment variables」里，填
LOG_LEVEL=debug即可看到每条ping/pong的时间戳 - 别用
go run .直接运行，而要用 GoLand 自带的 Run 按钮 —— 它会自动注入配置，且支持热重载（Ctrl+Shift+F9） - 如果用了
air或其他热重载工具，GoLand 的 Debug 模式会失效，必须关掉 air 改用原生调试
GoLand 提示 “cannot find package” 怎么办
这不是依赖没装，而是 GOPATH 或 Go Modules 配置不对。OpenClaw 相关 SDK（比如 github.com/wechaty/go-wechaty 或内部封装的 ws client）往往不在标准库路径下，GoLand 默认不索引 vendor 或本地路径。
最稳的办法是手动告诉它源码在哪：
- 右键项目根目录 → 「Mark Directory as」→ 「Sources Root」，让 GoLand 把整个项目当模块根
- 如果引用了私有 Git 仓库（比如公司内网的
git.example.com/ai/openclaw-go-sdk），在go.mod里写清楚 replace 规则，然后执行go mod tidy，GoLand 会自动识别 - 遇到
cannot find package "github.com/xxx/yyy/v2"，说明版本号带 v2，但你本地没切到对应分支 —— 别手动 git checkout，用go get github.com/xxx/yyy@v2.1.0更可靠
长连接最关键的不是接口地址或 token 格式，而是建连后那一秒内是否成功发送 aibot_subscribe 指令 —— GoLand 调试器停在这行代码上时，得亲眼看见 WebSocket frame 发出去才算数。
