OpenClaw Workspace

这是 Ray 的 OpenClaw 运行工作区，已经收敛成一套可直接使用的内容运营与产品协作环境。

你可以把它理解成一个已经接好常用链路的 AI 员工工作台，重点覆盖这些场景：

• AI简报 / 今日选题 / 公众号成稿与草稿箱推送
• 小红书笔记 图文生成与发布链路
• 闲鱼发布 半自动运营链路
• 产品需求 / 原型设计 / 演示文稿
• 投资复盘 / 投资周报 / 每日快检

如果你是第一次接手这个项目，先按下面的 3 分钟流程跑通，再去看细节文档。

先知道这 6 件事

1. 运行时固定为 Node 22 LTS。
2. 工作区固定为 ~/.openclaw/workspace-runtime-real，不要搬到 Desktop、中文路径或 emoji 路径。
3. 日常启动只推荐 bash scripts/gateway_stable_start.sh。
4. 禁止手工 kill 网关进程，禁止 stop + start 连击；优先 restart。
5. 敏感信息统一放 .credentials，不要写进仓库文件。
6. 长期记忆只写 MEMORY.md，不要再建独立记忆目录。
7. 微信 clawbot 已登录但 openclaw channels status 只显示 configured 时，不要手改配置；直接再跑一次 bash scripts/gateway_stable_start.sh。

3 分钟快速上手

1. 一次性准备

npm install -g node@22
openclaw gateway install --force

2. 日常启动

bash scripts/gateway_stable_start.sh

通过标准：

• 终端里看到 RPC probe: ok
• Dashboard 可打开：http://127.0.0.1:18789/
• 若已登录微信账号，scripts/gateway_stable_start.sh 会顺手补做 openclaw-weixin re-arm，避免只 configured 不 running

3. 检查运行状态

openclaw gateway status
openclaw status
openclaw agent --agent main --message "只回OK" --json

通过标准：

• openclaw gateway status 正常
• openclaw status 正常
• 连跑 2 到 3 次 openclaw agent，都返回 status=ok，且不出现 fallback

4. 安装 24x7 守护

bash scripts/install_openclaw_guardian.sh
python3 scripts/openclaw_guardian.py status

这一步会做 4 件事：

• 给 OpenClaw runtime 打稳定性补丁
• 把 heartbeat 调整到更稳的口径
• 自动清理不兼容配置字段
• 安装 guardian 做周期巡检与自愈

核心文档怎么读

启动顺序以 SOUL.md、IDENTITY.md、USER.md、MEMORY.md 为准。

真正上手时，建议按这个顺序看：

新手最常用的触发词

关键 Skills 一览

如果不知道一个任务该走哪个 skill，优先看 SKILLS.md。如果知道要做什么但不知道怎么执行，直接进对应 skill 目录读它自己的 SKILL.md、README.md 或 AGENTS.md。

开源项目引用与致谢

本工作区整合了多个开源项目与社区组件，用于补齐内容生成、发布自动化、公开信息读取和投资复盘能力。这里特别说明两点：

• 本仓库会保留原项目作者署名、许可证和必要的引用说明。
• 本仓库上的改动主要集中在 OpenClaw 工作区接入、稳定性加固、脚本编排、中文文档和使用流程收敛，不改变原项目的原始署名归属。

当前直接集成或显式引用的核心开源项目包括：

感谢上述项目的作者、维护者与每一位贡献者。没有这些开源工作，这个工作区不会这么快形成可复用的稳定链路。

日常命令速查

网关与守护

# 推荐唯一日常入口
bash scripts/gateway_stable_start.sh

# 常规状态检查
openclaw gateway status
openclaw status

# 推荐复位方式
openclaw gateway restart
openclaw gateway status

# 守护状态
python3 scripts/openclaw_guardian.py status

补充：

• 已登录微信但 channels status 不显示 running 时，仍优先重复执行 bash scripts/gateway_stable_start.sh
• bash scripts/doctor.sh 现在会提示 openclaw-weixin 启动锚点是否缺失

安全基线

bash scripts/security_baseline.sh check
bash scripts/security_baseline.sh fix

公众号草稿箱

python3 scripts/wechat_draft.py --file "drafts/文章.md" --title "标题" --digest "摘要"

规则：

• 未执行脚本且未看到成功结果，不能说“草稿箱已更新”
• 报 40164 invalid ip 时，先去微信后台加 IP 白名单

小红书

python3 skills/小红书笔记技能包/scripts/render_xhs.py content.md -o /tmp/xhs -t playful-geometric -m auto-split
python3 skills/小红书笔记技能包/scripts/publish_xhs.py --payload /tmp/xhs/payload.json --browser-mode --browser-profile-dir ~/xhs_workspace/xiaohongshu-send/profile-persistent --cookies-path ~/xhs_workspace/xiaohongshu-send/data/cookies.json

规则：

• 默认先发“仅自己可见”
• payload 必须带 content
• 图不超过 8 张
• 出现扫码通常意味着 Cookie 已失效

闲鱼

bash scripts/xianyu_live_publish.sh --title "标题" --description "描述"

规则：

• 发布是外部动作，执行前必须确认
• 先准备好文案和首图

关键运行细节

这些是 README 必须保留的稳定事实：

• 默认模型链路：openai-codex/gpt-5.4 -> openai-codex/gpt-5.3-codex
• 默认停用 api123/* 自动路由
• wecom 官方插件真实 ID 是 wecom-openclaw-plugin
• guardian 会处理坏 session、模型熔断和部分配置漂移
• scripts/gateway_stable_start.sh 是当前最稳的网关启动入口
• MEMORY.md 是唯一长期记忆落盘位置

安全边界

可以直接做

• 读文件、搜索、分析、生成草稿
• 推公众号草稿箱
• 抓公开内容

先确认再做

• WhatsApp 发送
• 公开发布
• Cookie 导入或更新
• 安装软件、改配置、推送 GitHub、外部 API 写操作

明确不要做

• rm -rf
• 手工改 ~/.openclaw/openclaw.json
• 手工 kill 网关进程
• 泄露 .credentials、Token、Cookie、密钥

细节边界以 HEARTBEAT.md 为准。

常见故障处理

1. 聊天框报 -11 read

先跑：

bash scripts/gateway_stable_start.sh

如果还异常，再跑：

openclaw gateway install --force
openclaw gateway restart

不要做：

• 不要手工 kill
• 不要 stop + start 连击
• 不要在 Dashboard 刚 warm-up 时急着新建 session

2. Dashboard 打不开

先检查：

openclaw gateway status

再回到推荐入口：

bash scripts/gateway_stable_start.sh

3. 小红书要求扫码

基本可以直接判断为 Cookie 失效。更新浏览器 Cookie 后重启对应链路，不要把扫码当常规登录方式。

4. 公众号推送失败

优先检查：

• .credentials 是否正确
• 微信后台 IP 白名单是否包含当前出口 IP
• wechat_draft.py 是否真的返回成功

目录说明

已接入的重要能力

• 公众号选题、成稿、排版、草稿箱推送
• 小红书图文渲染与发布链路
• 闲鱼半自动发布链路
• 产品设计系统三件套
• HTML 演示文稿生成器
• AI 投资复盘技能包
• 企业微信 WeCom 插件

一句话建议

第一次使用，别上来就看完全部文档。先跑通：

1. bash scripts/gateway_stable_start.sh
2. openclaw agent --agent main --message "只回OK" --json
3. 选一个触发词直接试，比如 AI简报、今日选题 或 产品需求

跑通之后，再去看 AGENTS.md、SKILLS.md 和 HEARTBEAT.md。