企业官网建设流程全解析

1. 这不是又一个“点下一步”的安装教程——Moltbot 1.0 的真实定位与使用边界

Moltbot（原Clawdbot）1.0，这个名字在2026年初的开发者工具圈里突然密集出现，但多数人点开链接后只看到一堆零散的GitHub README片段、几行curl命令和一句“请自行配置环境”。它既不是VS Code插件，也不是PyPI上一键pip install就能跑通的Python包；它不依赖Docker Compose一键拉起，也不提供Windows双击exe安装向导。如果你正打算用它来“自动写代码”“替代Claude Code”或“秒配MySQL+Redis开发栈”，那我得先泼一盆冷水：Moltbot 1.0 的核心价值，从来就不是“全自动傻瓜化”，而是为中高级开发者提供一套可审计、可追溯、可复现的本地化工程化配置中枢。它解决的，是那个被反复忽略却每天消耗你27分钟的真实问题：当你在三台不同配置的机器（一台Win11带WSL2，一台M2 Mac，一台Ubuntu22.04裸机）上同步部署同一套后端服务时，为什么每次都要重走一遍“查文档→试错→翻GitHub issue→改环境变量→删缓存→重启终端”这个死亡循环？Moltbot 就是那个把“人工记忆”变成“机器可执行声明”的转换器。它不替你写业务逻辑，但它确保你写的每一行SQL、每一条Redis命令、每一个Git hook，在所有环境中都运行在完全一致的底层约束下。关键词里的“codex安装”“mysql安装配置教程”“vscode配置python开发环境”看似是并列项，实则全是Moltbot的输入源——它不安装Codex，但它能读取Codex官方安装脚本的校验逻辑；它不启动MySQL服务，但它会校验你的my.cnf是否满足你项目定义的“生产就绪阈值”（比如innodb_buffer_pool_size ≥ 75%可用内存）。所以，这不是一篇教你“怎么装软件”的文章，而是一篇教你“怎么让软件知道自己该以什么身份、在什么条件下、为谁服务”的配置哲学实践手记。适合人群非常明确：已经能手动配好VS Code + Python + Git + MySQL的人，但厌倦了每次换电脑/重装系统/交接项目时重复劳动；正在带团队做标准化开发环境建设的技术负责人；或者刚被CI/CD流水线里莫名其妙的“本地能跑线上报错”问题折磨到凌晨三点的后端工程师。如果你连Python环境变量都还没配明白，请先去补完“python安装教程”和“git安装及配置教程”这两课——Moltbot 不是入门捷径，它是帮你把已掌握技能固化成生产力的压舱石。

2. 安装前必须亲手验证的5个硬性前提——跳过任一项，后续90%的报错都源于此

很多用户反馈“执行install.sh后卡在第3步”“moltbot init提示command not found”，翻遍日志却找不到根源。我拆解了最近三个月收到的137份失败日志，发现其中112份（占比81.8%）的问题，全部集中在安装前的环境基线校验环节。Moltbot 1.0 的设计哲学是“宁可拒绝启动，也不容忍模糊状态”，因此它强制要求5个不可协商的前提条件。这些条件不是为了刁难你，而是因为它们直接对应着配置引擎的核心依赖链。下面我逐条说明验证方法、失败表现、以及为什么必须如此严格。

2.1 Shell 解释器必须为 Bash 5.1+ 或 Zsh 5.8+（且非兼容模式）

Moltbot 的核心配置解析器使用了Bash 5.1引入的declare -gA（全局关联数组）语法和Zsh 5.8的typeset -gA等特性，这些在旧版Shell或dash/sh兼容模式下会直接语法报错。很多人以为自己用的是bash，其实终端启动时默认调用的是/bin/sh（在Ubuntu/Debian系常指向dash）。验证方法极其简单：

# 查看当前shell进程名 ps -p $$ # 正确输出应为： PID TTY TIME CMD # 12345 pts/0 00:00:00 bash （或zsh） # 查看bash版本（如果输出bash） bash --version # 必须 ≥ 5.1，如：GNU bash, version 5.1.16(1)-release (x86_64-pc-linux-gnu) # 查看zsh版本（如果输出zsh） zsh --version # 必须 ≥ 5.8，如：zsh 5.8.1 (x86_64-ubuntu-linux-gnu)

提示：Windows用户若使用Git Bash，请确认其版本。Git for Windows 2.40+自带的Git Bash基于MSYS2，其bash版本通常为5.1+；但老版本（如2.33）仍为4.4，必须升级。不要试图用chsh -s /bin/bash强行切换WSL2的默认shell——Moltbot检测的是当前会话的$SHELL环境变量，而非系统默认shell。最稳妥的做法是在启动终端时显式指定：exec bash -l（加载login shell配置）。

2.2 Git 必须支持git config --local且仓库初始化权限完备

Moltbot 的所有配置元数据都存储在项目根目录下的.molt/子目录中，而该目录的初始化依赖于Git的本地配置能力。它需要执行git config --local core.hooksPath .molt/hooks来接管Git hooks，这要求：

• 当前目录必须是一个已初始化的Git仓库（git init已执行）；
• 该仓库的.git/config文件可写；
• Git版本 ≥ 2.25（因--local参数在此版本才稳定支持hooksPath）。

验证方法：

# 进入你的目标项目目录（例如 ~/myproject） cd ~/myproject # 检查是否为git仓库 git rev-parse --is-inside-work-tree 2>/dev/null || echo "Not a git repo" # 检查git版本 git --version # 必须 ≥ 2.25 # 尝试写入一个测试配置（无副作用） git config --local molt.test "verify" 2>/dev/null && \ git config --local --get molt.test | grep -q "verify" && \ echo "Git local config OK" && \ git config --local --unset molt.test

注意：很多企业内网环境禁用了git config --local，或Git配置被全局策略锁定。此时Moltbot会静默失败。解决方案不是绕过，而是联系IT部门开放core.hooksPath白名单——这是安全合规的必要妥协，而非技术障碍。

2.3 Python 3.9+ 解释器必须存在于PATH且具备pip模块管理能力

Moltbot 本身是Shell脚本，但它驱动的绝大多数配置动作（如数据库连接测试、API密钥加密、环境变量注入）都由Python子进程完成。它不捆绑Python，而是严格依赖系统已安装的Python解释器。关键要求有三：

• python3命令必须在PATH中可执行；
• 该Python版本必须 ≥ 3.9（因使用了zoneinfo标准库和graphlib.TopologicalSorter）；
• pip必须可用，且能安装pyyaml,cryptography,requests等基础包。

验证方法（一行命令搞定）：

# 执行复合验证 if command -v python3 >/dev/null 2>&1; then \ PYVER=$(python3 -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')"); \ if [[ "$PYVER" =~ ^3\.[9-9]|3\.[1-9][0-9]$ ]]; then \ if python3 -c "import yaml, cryptography, requests" 2>/dev/null; then \ echo "Python $PYVER with deps OK"; \ else \ echo "Python $PYVER OK but missing deps: pip install pyyaml cryptography requests"; \ fi; \ else \ echo "Python $PYVER too old. Need 3.9+"; \ fi; \ else \ echo "python3 not in PATH"; \ fi

实操心得：Mac用户常遇到python3指向Homebrew安装的3.11，但系统自带的/usr/bin/python3是3.8。务必确认which python3输出的是你期望的路径。Moltbot读取的是$PATH顺序，不会主动搜索。曾有用户因/opt/homebrew/bin在PATH中排在/usr/bin之后，导致Moltbot误用系统旧版Python而报错ModuleNotFoundError: No module named 'zoneinfo'——这种问题必须从PATH源头解决，而非临时export PATH="/opt/homebrew/bin:$PATH"。

2.4 系统必须提供curl或wget，且支持TLS 1.2+协议

Moltbot 在安装阶段需要从官方源（https://moltbot.io/releases/）下载配置模板、校验签名和第三方工具清单。它优先使用curl，若不存在则回退至wget。关键限制是：必须支持TLS 1.2+，因为所有通信均强制HTTPS且服务器已禁用TLS 1.0/1.1。老旧系统（如CentOS 7默认OpenSSL 1.0.2）会在此处静默失败。

验证方法：

# 测试curl的TLS能力 curl -I --tlsv1.2 https://moltbot.io/health 2>/dev/null | head -1 | grep "200 OK" && echo "curl TLS 1.2 OK" || echo "curl TLS 1.2 failed" # 若curl不存在，测试wget if ! command -v curl >/dev/null 2>&1; then \ wget --server-response --spider --no-check-certificate https://moltbot.io/health 2>&1 | grep "200 OK" && echo "wget OK" || echo "wget TLS failed"; \ fi

踩坑实录：某金融客户在RHEL 7.9上安装失败，日志显示Failed to fetch release manifest。排查发现其curl版本为7.29.0，但OpenSSL库为1.0.2k，不支持TLS 1.2。解决方案不是降级安全协议（绝对禁止），而是升级curl：sudo yum install -y epel-release && sudo yum install -y curl。EPEL源提供的curl 7.61+绑定OpenSSL 1.0.2u，完美支持TLS 1.2。

2.5 用户主目录（HOME）必须为常规POSIX路径，且无空格/中文/特殊符号

这是最容易被忽视却最致命的一条。Moltbot 的配置文件路径拼接、Shell函数作用域、Git hooks脚本生成，全部基于$HOME的纯ASCII路径。一旦$HOME包含空格（如/home/user name）、中文（如/home/张三）或符号（如/home/user@work），所有路径拼接操作都会在Shell层面崩溃，错误信息往往指向无关的sed或awk命令。

验证方法（极简）：

# 检查HOME路径是否“干净” echo "$HOME" | grep -q "[^a-zA-Z0-9._/-]" && echo "HOME contains illegal chars!" || echo "HOME path clean"

经验技巧：Windows用户在WSL2中，若通过wsl --import导入的发行版，其/etc/passwd中的HOME字段可能被设为/home/user name（含空格）。此时不要修改/etc/passwd——这会导致整个WSL2用户系统异常。正确做法是：在~/.bashrc末尾添加export HOME="/home/${USER}"，并确保该路径确实存在（mkdir -p "/home/$USER"）。Moltbot 启动时会优先读取此环境变量，绕过系统passwd文件。

这五个前提，就是Moltbot 1.0的“准入门槛”。它不提供任何“兼容模式”或“降级选项”，因为配置即契约，模糊的起点必然导致不可控的终点。花10分钟亲手验证这五点，能为你节省后续数小时的无效调试时间。记住：Moltbot 不是让你少干活，而是让你干的每一分力气，都精准落在刀刃上。

3. 从零开始的原子化安装流程——为什么必须分四步执行，而非单脚本覆盖

网上流传的所谓“一键安装脚本”（如curl -sL moltbot.io/install | bash）在Moltbot 1.0中已被官方弃用。原因很现实：它掩盖了安装过程中的关键决策点，导致用户在配置阶段陷入“不知道自己当初选了什么”的困境。Moltbot 1.0 强制采用四步原子化安装，每一步都是一个独立、可验证、可回滚的操作单元。这四步不是为了增加复杂度，而是为了将“环境准备”、“工具获取”、“配置初始化”、“验证闭环”这四个本质不同的任务彻底解耦。下面我带你完整走一遍，重点解释每一步背后的设计意图和不可跳过的细节。

3.1 第一步：下载并校验安装引导器（molt-installer）

这步不安装任何东西，只获取一个轻量级Shell脚本（约12KB），其唯一职责是：安全地下载Moltbot主程序并验证其完整性。它不执行任何配置，不修改系统，不联网下载除主程序外的任何内容。

# 下载引导器（使用curl，若不可用则用wget） curl -fsSL https://moltbot.io/releases/molt-installer -o molt-installer # 或 wget -qO molt-installer https://moltbot.io/releases/molt-installer # 校验SHA256（官方发布页提供，此处为示例值，实际请以官网为准） echo "d8e9b5a7c2f1e0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b0c9d8e7f6a5" | sha256sum -c --quiet molt-installer && echo "Installer checksum OK" || { echo "Checksum mismatch! Abort."; exit 1; } # 赋予可执行权限 chmod +x molt-installer

为什么必须手动校验？因为这是信任链的起点。Moltbot 主程序（molt二进制）由官方私钥签名，而molt-installer脚本内嵌了公钥指纹。它下载主程序后，会用该公钥验证签名。但如果你跳过对molt-installer本身的校验，攻击者只需劫持一次HTTP响应，就能替换掉整个签名验证逻辑。手动SHA256校验，是人类对机器的第一道防线。我见过太多案例：用户图省事直接curl | bash，结果因中间人攻击下载了恶意引导器，后续所有“安全配置”都建立在流沙之上。

3.2 第二步：执行引导器，获取Moltbot主程序（molt）

这步才是真正下载Moltbot核心。molt-installer会：

• 检测你的操作系统（Linux/macOS/WSL2）和架构（x86_64/aarch64）；
• 从https://moltbot.io/releases/下载对应平台的molt二进制；
• 使用内嵌公钥验证其GPG签名；
• 将molt二进制复制到$HOME/.local/bin/（若存在）或/usr/local/bin/（需sudo）；
• 输出校验摘要供你二次确认。

执行命令：

# 执行引导器（无需sudo，除非目标目录需权限） ./molt-installer # 成功输出示例： # > Detected: Linux x86_64 # > Downloading molt-linux-amd64-v1.0.0... # > Verifying signature with key ID 0xA1B2C3D4... # > Signature OK. Installing to /home/yourname/.local/bin/molt # > Installed. Run 'molt --version' to verify.

关键细节：molt-installer默认优先安装到$HOME/.local/bin/，这是一个符合XDG Base Directory规范的用户级bin目录。它比/usr/local/bin/更安全（无需sudo），也比~/bin更标准（许多发行版默认将其加入PATH）。但前提是你的shell配置文件（如~/.bashrc）中已包含export PATH="$HOME/.local/bin:$PATH"。如果molt --version报command not found，请立即检查此PATH设置——这是安装后最常见的“找不到命令”问题，根源不在Moltbot，而在你的shell环境。

3.3 第三步：初始化项目配置（molt init）

这才是真正开始“配置”的一步。molt init命令必须在你的目标项目根目录下执行，它会：

• 创建.molt/目录（存放所有配置元数据）；
• 生成.molt/config.yaml（主配置文件，定义项目所需的服务、工具、环境变量）；
• 初始化Git hooks（pre-commit, pre-push等）；
• 创建.molt/templates/目录（存放自定义配置模板）。

执行流程：

# 进入你的项目目录（必须是git仓库！） cd ~/my-awesome-project # 执行初始化 molt init # 它会交互式提问（可按需修改）： # ? Project name [my-awesome-project]: # ? Select primary language: [Use arrow keys] # > Python # Node.js # Java # Go # ? Enable database configuration? (MySQL, PostgreSQL, SQLite): Yes # ? Enable cache configuration? (Redis, Memcached): Yes # ? Generate VS Code settings? Yes

为什么是交互式而非全自动？因为配置的本质是决策。选择“Python”还是“Node.js”，决定了后续molt check时校验哪些Python包版本、哪些npm全局包是否存在；选择启用MySQL，会触发.molt/config.yaml中databases.mysql区块的生成，并预置host,port,username等占位符。这些不是魔法，而是将你的主观意图，转化为机器可读的声明。我建议第一次使用时，认真回答每个问题——哪怕只是按回车接受默认值。因为.molt/config.yaml就是你项目的“配置宪法”，后续所有molt apply、molt check都以此为唯一依据。跳过这步直接编辑YAML，就像没打地基就砌墙，迟早出问题。

3.4 第四步：应用并验证配置（molt apply && molt check）

molt apply是执行引擎，它读取.molt/config.yaml，按声明式逻辑调用系统命令完成配置。molt check则是验证引擎，它不修改任何东西，只报告当前环境是否满足配置声明。

# 应用配置（会安装缺失工具、写入配置文件、重启服务等） molt apply # 验证结果（关键！必须执行） molt check # 成功输出示例： # ✓ Python: 3.11.5 (expected >= 3.9) # ✓ Git: 2.40.1 (expected >= 2.25) # ✓ MySQL: 8.0.33 (expected >= 8.0.20, < 9.0.0) # ✓ Redis: 7.0.15 (expected >= 7.0.0) # ✓ VS Code: settings.json updated # ✗ Codex API Key: not set (required for code generation) # Status: 4/5 checks passed. Fix the failing check.

核心洞察：molt apply和molt check是分离的。你可以多次执行molt apply（幂等），但molt check才是最终裁判。它不关心你是怎么配的，只关心“现在是不是对的”。那个✗ Codex API Key: not set的报错，正是Moltbot“声明式”思想的体现——你在.molt/config.yaml里声明了codex.enabled: true，molt check就强制要求CODEX_API_KEY环境变量存在。它不会帮你生成key，也不会静默跳过，而是明确告诉你“契约未履行”。这种“不近人情”的严格，恰恰是它能成为可靠配置中枢的根本原因。

这四步流程，每一步都像一个齿轮，严丝合缝地咬合在一起。它不追求表面的“快”，而追求内在的“稳”。当你熟练后，整个过程可在2分钟内完成，但那2分钟里，你清晰地知道每一步发生了什么、为什么发生、以及如何验证它真的发生了。这才是专业配置应有的样子。

4. 配置文件深度解析与实战定制——.molt/config.yaml 不是模板，而是你的项目DNA

.molt/config.yaml是Moltbot 1.0的心脏，它远不止是一个“配置模板”。它是一份用YAML编写的、描述你项目运行时契约的正式文档。它的结构不是随意设计的，而是严格映射到现代软件工程的四个核心维度：语言生态、数据服务、开发工具、安全策略。下面我将逐区块拆解其语法、语义、以及我在真实项目中总结出的定制技巧。所有示例均来自2026年1月最新版（v1.0.0）的schema。

4.1 languages: 区块——定义你的技术栈基线，而非简单罗列版本

这个区块声明项目所依赖的编程语言及其最小/最大兼容版本。它直接影响molt check对python --version、node --version等命令的校验逻辑。

languages: python: min_version: "3.9" max_version: "3.12" # 3.12+尚未经过全量测试 packages: - name: "django" min_version: "4.2.0" - name: "psycopg2-binary" min_version: "2.9.7" nodejs: min_version: "18.17.0" max_version: "20.10.0" global_packages: - name: "pnpm" min_version: "8.9.0"

原理解析：Moltbot 不会为你安装Python或Node.js（那是系统包管理器的事），但它会精确校验python --version输出是否在[3.9, 3.12)区间内。对于packages，它会执行python -m pip show django | grep Version来提取版本号。关键技巧在于max_version：设为3.12意味着“允许3.11.x，但拒绝3.12.0及以上”，因为新大版本常引入破坏性变更。我曾在某电商项目中将max_version设为3.11，结果团队成员升级到3.12后，molt check立刻报错，避免了因zoneinfo模块行为变更导致的时区bug上线。

4.2 databases: 区块——声明服务契约，而非连接字符串

这是最容易被误解的区块。很多人以为这里要填真实的password，其实不然。Moltbot 的设计原则是：配置文件只声明契约，敏感信息由环境变量注入。

databases: mysql: enabled: true host: "${MYSQL_HOST:-localhost}" # 读取环境变量，缺省为localhost port: "${MYSQL_PORT:-3306}" username: "${MYSQL_USER:-root}" # password: NEVER PUT PASSWORD HERE! database: "myapp_dev" min_version: "8.0.20" max_version: "8.4.0" health_check: "SELECT 1" # 自定义健康检查SQL

实操要点：所有敏感字段（password,secret_key）必须使用${VAR_NAME}语法，且在运行molt apply前，确保这些环境变量已设置。Moltbot 会将.molt/config.yaml渲染为最终的my.cnf或application.properties，但原始YAML中绝不出现明文密码。这是安全合规的底线。我见过最危险的案例：某开发者为图方便，在YAML里写了password: "123456"，然后提交到GitHub，导致整个测试库被拖库。Moltbot 用这种强制语法，逼你养成安全习惯。

4.3 tools: 区块——管理开发工具链的生命周期

这个区块定义VS Code、Git、CLI工具等的配置，它控制的是“工具如何为你服务”，而非“工具本身”。

tools: vscode: enabled: true extensions: - "ms-python.python" - "esbenp.prettier-vscode" settings: "python.defaultInterpreterPath": "./venv/bin/python" "editor.formatOnSave": true git: hooks: pre_commit: - "molt check --only=python" # 提交前只检查Python环境 pre_push: - "molt check --only=databases" # 推送前检查数据库连接

高级技巧：git.hooks支持任意Shell命令。上面的例子中，pre_commit钩子执行molt check --only=python，这意味着只有当Python环境满足.molt/config.yaml声明时，代码才能提交。这比在CI里检查更前置，把问题消灭在本地。另一个技巧是settings中的路径："./venv/bin/python"是相对路径，molt apply会将其渲染为绝对路径（如/home/user/myproject/venv/bin/python），确保VS Code总能找到正确的解释器。

4.4 security: 区块——将安全策略编码为可执行规则

这是Moltbot 1.0最具前瞻性的设计。它把安全要求（如密钥轮换、证书有效期）变成了可自动检查的规则。

security: api_keys: - name: "codex" env_var: "CODEX_API_KEY" required: true min_length: 32 pattern: "^sk-[a-zA-Z0-9]{32,}$" # 匹配OpenAI风格密钥 certificates: - name: "ssl_cert" path: "${SSL_CERT_PATH:-./certs/server.crt}" expires_in_days: 90 # 证书剩余有效期必须>90天

真实案例：我们团队用molt check每日扫描所有API密钥。当CODEX_API_KEY长度不足32位，或不匹配sk-前缀时，molt check立即失败，并输出：“API key for codex is invalid. Please rotate it.” 这比等密钥过期导致服务中断，提前了整整两周。expires_in_days更是救命功能——它用openssl x509 -in ./certs/server.crt -enddate -noout提取证书到期时间，自动计算剩余天数。当低于90天时，CI流水线直接阻断部署，强制运维更新证书。安全，从此不再是文档里的口号，而是每天运行的代码。

.molt/config.yaml的每一行，都在回答一个根本问题：“我的项目，到底需要什么才能正确、安全、可重复地运行？” 它不是一份待填写的表格，而是你对项目未来所有运行环境的庄严承诺。花时间读懂它、定制它、敬畏它，是你作为工程师对自身工作质量的最高负责。

5. 常见故障的完整排查链路——从“molt check 失败”到根因定位的七步法

molt check报错是使用Moltbot 1.0过程中最常遇到的问题。但很多人止步于“看一眼错误信息”，然后盲目谷歌，结果越陷越深。实际上，Moltbot 的错误信息设计得极为精准，它遵循一个严格的“七层归因模型”。下面我以一个真实案例（某用户报告molt check卡在✓ MySQL: ...后无响应）为例，完整演示从现象到根因的排查全过程。这套方法论，适用于所有molt check失败场景。

5.1 第一步：捕获完整、未截断的错误输出

这是最关键的一步，也是90%用户忽略的。molt check默认输出是精简的，但详细日志藏在--debug模式下。

# 错误做法：只看屏幕滚动的几行 molt check # 正确做法：重定向所有输出到文件，并启用debug molt check --debug 2>&1 | tee molt-check-debug.log

为什么？因为molt check的校验是串行的，它会依次执行python --version、mysql --version、redis-cli --version等命令。当卡在某个步骤时，标准输出可能只显示✓ Python: 3.11.5，但--debug日志会记录下Executing: mysql --version，以及紧接着的Command timed out after 30s。没有这份日志，你永远不知道是命令没执行，还是执行了但卡住了。

5.2 第二步：定位失败模块——从日志中提取“最后成功”和“首个失败”

打开molt-check-debug.log，搜索Executing:和✓/✗标记。

# 日志片段示例 DEBUG: Executing: python --version INFO: ✓ Python: 3.11.5 (expected >= 3.9) DEBUG: Executing: mysql --version # 此处日志停止，无INFO或ERROR行

分析：✓ Python之后，日志停留在Executing: mysql --version，说明问题出在MySQL命令执行环节。这排除了Python、Git、Node.js等前置依赖的问题，将排查范围精准缩小到MySQL客户端。

5.3 第三步：手动复现失败命令——剥离Moltbot，直面系统

既然molt check卡在mysql --version，那就手动执行它：

# 在同一终端、同一目录下执行 mysql --version # 如果也卡住，说明是MySQL客户端问题 # 如果正常输出，说明是Moltbot的超时设置问题（罕见）

实操发现：该用户的mysql --version同样卡住。这证明问题与Moltbot无关，而是MySQL客户端自身的配置缺陷。

5.4 第四步：分析MySQL客户端卡顿的三大根源

MySQL客户端卡顿，99%的情况源于以下三个原因，按概率排序：

该用户执行strace后，日志显示：

connect(3, {sa_family=AF_INET6, sin6_port=htons(3306), inet_pton(AF_INET6, "::1", &sin6_addr), sin6_flowinfo=htonl(0), sin6_scope_id=0}, 28) = -1 EINPROGRESS (Operation now in progress)

这明确指向DNS反向解析：客户端在尝试连接IPv6的::1，但DNS查询超时。

5.5 第五步：根治方案——修改MySQL客户端行为

找到问题根源后，解决方案必须一劳永逸，而非临时规避。

# 方案1：强制使用IPv4（推荐，最简单） echo "[client]\nprotocol=TCP" >> ~/.my.cnf # 方案2：禁用DNS解析（更彻底） echo "[client]\nskip-name-resolve" >> ~/.my.cnf # 方案3：在.molt/config.yaml中覆盖（项目级） # databases: # mysql: # host: "127.0.0.1" # 显式指定IPv4地址，绕过DNS

为什么选方案1？因为protocol=TCP强制客户端使用TCP/IP协议栈，跳过Unix socket和IPv6自动探测，同时保持与MySQL服务器的兼容性。skip-name-resolve虽彻底，但会影响GRANT语句中基于主机名的权限控制，需评估风险。而host: "127.0.0.1"是项目级方案，不影响其他项目，适合多项目共存的开发者。

5.6 第六步：验证修复效果——回归Moltbot流程

修改配置后，必须重新走一遍Moltbot的验证闭环：

# 清理Moltbot的缓存（可选，但推荐） rm -rf .molt/cache/ # 重新执行check molt check # 成功输出应为： # ✓ Python: 3.11.5 (expected >= 3.9) # ✓ MySQL: 8.0.33 (expected >= 8.0.20, < 9.0.0) # ...

注意：molt check是幂等的，它不修改环境，只读取和报告。因此，修复系统问题后，molt check自然通过，无需molt apply。

5.7 第七步：沉淀为团队知识——将排查过程写入.molt/docs/

Moltbot 1.0 支持在.molt/目录下存放团队知识库。这是将个人经验转化为组织资产的关键一步。

# 创建故障文档 cat > .molt/docs/mysql-dns-timeout.md << 'EOF' # MySQL DNS Timeout Issue ## Symptom `molt check` hangs at "Executing: mysql --version". ## Root Cause MySQL client attempts IPv6 reverse DNS lookup on `localhost`, timing out. ## Solution Add to `~/.my.cnf`: \`\`\` [client] protocol=TCP \`\`\` ##