夜雨聆风写在前面
今天下午，我想给 OpenClaw 安装一个微信公众号发布技能 **wechat-article-publisher**，把文章一键发布到公众号草稿箱。
技能安装很顺利，但在飞书执行“发布到公众号草稿箱”时，遇到了一系列问题：
ModuleNotFoundError: No module named 'requests'（依赖缺失）Read-only file system（只读权限）Permission denied（权限不足）No usable temporary directory（无临时目录）最后还有封面图片写入失败的问题
从下午 1 点折腾到晚上 6 点，整整 5 个小时。写下这篇教程，记录踩过的每一个坑和最终解决方案。
一、问题根源
read_only: true | |
/tmp | |
skills/assets目录 |
核心教训：不要在运行时手动装依赖，要把所有依赖打包进 Docker 镜像。
二、最终解决方案
2.1 Dockerfile（依赖打包进镜像）
FROM ghcr.nju.edu.cn/openclaw/openclaw:latest
USER root
# 强制阿里云源（加速 apt-get）
RUN rm -rf /etc/apt/sources.list.d/* 2>/dev/null || true && \
echo"deb http://mirrors.aliyun.com/debian bookworm main" > /etc/apt/sources.list && \
echo"deb http://mirrors.aliyun.com/debian bookworm-updates main" >> /etc/apt/sources.list && \
echo"deb http://mirrors.aliyun.com/debian-security bookworm-security main" >> /etc/apt/sources.list
# 安装 pip
RUN apt-get update && apt-get install -y python3-pip cron && rm -rf /var/lib/apt/lists/*
# 安装 wechat-article-publisher 技能所需的依赖
RUN python3 -m pip install --break-system-packages \
-i https://pypi.tuna.tsinghua.edu.cn/simple \
requests beautifulsoup4 markdown pyyaml Pillow
USER node
2.2 docker-compose.yml（关键配置）
services:
openclaw:
build:.
container_name:openclaw-gateway
restart:unless-stopped
# 安全配置（全部开启）
cap_drop:
-ALL
cap_add:
-DAC_OVERRIDE
read_only:true
tmpfs:
-/tmp# 让 /tmp 可写（解决临时文件问题）
user:"1000:1000"
security_opt:
-no-new-privileges:true
ports:
-"127.0.0.1:37406:18789"
volumes:
-./config:/home/node/.openclaw:rw
-./workspace:/home/node/.openclaw/workspace:rw
-./logs:/home/node/logs:rw
-./data:/home/node/data:rw
-./credentials:/home/node/.openclaw/credentials:ro
-./skills:/home/node/.openclaw/skills:ro# 技能目录保持只读
-./extensions:/home/node/.openclaw/extensions:ro
-./agents:/home/node/.openclaw/agents:rw
-./tmp/openclaw-1000:/tmp/openclaw-1000:rw
-./npm:/home/node/.npm:rw
environment:
-NODE_ENV=production
-LOG_LEVEL=info
-OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_TOKEN}
# ... 其他环境变量
2.3 修改技能脚本（解决封面图片写入问题）
技能脚本试图写入只读的 skills/assets目录，需要改为写入 /tmp。
# 修改脚本中的临时目录
sed -i 's|Path(__file__).resolve().parent.parent / "assets" / "generated_cover.jpg"|Path("/tmp") / "generated_cover.jpg"|g' \
skills/wechat-article-publisher-1/scripts/publish_wechat.py
三、构建与验证
3.1 首次构建
cd /opt/openclaw
docker compose build --no-cache
docker compose up -d
3.2 验证依赖
docker exec -it openclaw-gateway python3 -c "import requests, bs4, markdown, yaml, PIL; print('✅ 依赖齐全')"
3.3 配置公众号凭证
在飞书里发送：
这是我的公众号配置，请帮我写入到公众号发布技能中
AppID：你的AppID
AppSecret：你的AppSecret
3.4 测试发布
在飞书里发送：
发布到公众号草稿箱
或先生成一篇文章再发布：
帮我写一篇关于AI的公众号文章，发布到公众号草稿箱
四、以后的操作
日常升级
cd /opt/openclaw
docker compose down
docker compose build --no-cache
docker compose up -d
日常重启
docker compose restart
验证依赖是否正常
docker exec -it openclaw-gateway python3 -c "import requests; print('✅ OK')"
五、踩坑清单与解决方案汇总
pip3: command not found | |||
Read-only file system | read_only: true | ||
Permission denied | |||
apt-get update | |||
ModuleNotFoundError | |||
No usable temporary directory | /tmp | tmpfs: - /tmp | |
skills/assets | /tmp |
六、快速排障清单
如果发布失败，按顺序检查：
# 1. 检查依赖
docker exec -it openclaw-gateway python3 -c "import requests; print('OK')"
# 2. 检查技能目录
docker exec -it openclaw-gateway ls -la /home/node/.openclaw/skills/ | grep wechat
# 3. 检查配置
docker exec -it openclaw-gateway cat /home/node/.openclaw/skills/wechat-article-publisher-1/config.json
# 4. 查看错误日志
docker compose logs --tail 50 | grep -i error
# 5. 检查 /tmp 是否可写
docker exec -it openclaw-gateway touch /tmp/test.txt && echo"可写"
七、一句话总结
把依赖打包进 Docker 镜像，装到系统默认路径，用 tmpfs 让 /tmp 可写，修改技能脚本使用 /tmp 作为临时目录，换好国内源——一次构建，永久省心。
八、对比：错误方案 vs 正确方案
记录我踩过的坑，希望通过这篇教程能帮你省下 5 个小时。🦞
