AI Agent on 忘川

Codex Pets 使用详细说明（官方 + 社区实战整合）

Mon, 11 May 2026 00:00:00 +0000

从零开始掌握 Codex Pets：先启用内置宠物，再生成自定义宠物，最后完成本地安装与稳定排障。

1. Codex Pets 是什么

Codex Pets 是 Codex App 的可选动画伙伴层（floating overlay），核心价值不是“装饰”，而是让任务状态可视化：

在使用其他应用时，仍可看到当前活跃线程。
直接显示状态变化：运行中、等待输入、待审阅。
用简短进度提示快速了解“刚刚发生了什么”。

这套机制对长时任务和多线程任务非常实用，能明显减少反复切回主界面的成本。

2. 官方启用路径（建议先做）

根据 OpenAI Codex App 官方设置文档，推荐按以下顺序启用：

打开 Settings -> Appearance -> Pets。
选择内置宠物，或刷新本地自定义宠物列表。
使用以下任一方式切换悬浮层显示状态：
- 在输入框输入 /pet
- Settings -> Appearance 中使用 Wake Pet / Tuck Away Pet
- Cmd+K（macOS）或 Ctrl+K（Windows）执行同名命令

3. 自定义宠物生成：hatch-pet 正确流程

3.1 安装技能

$skill-installer hatch-pet

安装后若没有立即生效，先重启 Codex；也可以先通过命令面板执行 Force Reload Skills。

3.2 触发生成

$hatch-pet create a new pet inspired by my recent projects

也可以直接给出更精确描述，例如颜色、风格、性格、动作偏好。

3.3 生成机制（官方 skill 关键点）

openai/skills 里的 hatch-pet 说明了完整生成契约：

通过 $imagegen 负责视觉生成。
标准流程最多约 10 个视觉任务（1 个 base + 9 个状态行）。
目标图集规格是 8 x 9 网格，单格 192 x 208，总尺寸 1536 x 1872。
最终以 pet.json + spritesheet.webp 作为可安装包落地。

4. 本地文件结构与包规范

社区安装文档与生成工具的约定高度一致，最小可用包建议如下：

~/.codex/pets/my-pet/
 pet.json
 spritesheet.webp

最小 pet.json 示例：

{
 "id": "my-pet",
 "displayName": "My Pet",
 "description": "A concise pet description.",
 "spritesheetPath": "spritesheet.webp"
}

关键一致性要求：

文件夹名、id、资源路径要对齐。
spritesheetPath 指向包内文件（本地安装场景不建议外链）。
图集尺寸和网格不匹配时，动画会错位或花屏。

5. 已有宠物的两种安装方式

方式 A：手动安装（可控）

mkdir -p "$HOME/.codex/pets/tater"
unzip -o "./tater-codex-pet.zip" -d "$HOME/.codex/pets/tater"

安装后通过 /pet 或设置页选择该宠物。

方式 B：社区 CLI 一键安装（更快）

npx codex-pet-cli add <pet-slug>

社区站点说明该命令会把宠物安装到 ~/.codex/pets/<name>，适合快速体验大量现成宠物。

6. 官方与社区能力边界

维度	官方文档/官方仓库	社区站点/第三方工具
功能定义	权威来源（设置路径、命令入口、技能机制）	主要补充教程、示例、素材市场
兼容保证	与 Codex 版本同步更新	可能滞后或偏差
风险	相对可控	需自行校验来源与包内容
推荐用途	作为“标准答案”	作为“提效补充”

实践建议：以官方说明为准绳，以社区工具做提速。

7. 高频问题与排障清单

7.1 `/pet` 输入后没有触发，仅当普通消息发送

已在 openai/codex 出现公开问题案例（例如 #20836）。可按以下顺序排查：

先在 Settings -> Appearance -> Pets 里直接切换，确认基础功能可用。
升级到最新 Codex 版本后重试。
通过 Cmd+K/Ctrl+K 执行宠物切换命令，验证是否仅 slash 行为异常。
若仍异常，记录版本号和平台信息后提 issue。

7.2 `hatch-pet` 已安装但命令补全里找不到

公开问题（如 #20778）反映过“slash 自动补全不可见”的情况。重点是区分：

Skill 被安装，并不一定等于 slash 自动补全立刻可见。
按官方技能文档，优先使用 $skill-name 形式触发技能。
安装后先 Force Reload Skills 或重启应用。

7.3 生成流程中断并出现 stream disconnected

#20947 的排障信息显示，某些环境中可能涉及 $imagegen 发现/依赖问题。建议：

检查 hatch-pet 是否完整安装。
核实系统技能链路是否正常加载（尤其图像生成依赖）。
先跑最小生成任务验证流程，再逐步增加复杂度。

8. 面向生产使用的建议

先固定一套“已验证可用”的宠物模板与尺寸规范。
把 pet.json 校验做成脚本，提交前自动检查关键字段。
团队内统一宠物包目录命名，避免重复或覆盖。
社区来源包先在隔离环境验证后再分发。
每次 Codex 版本升级后做一次宠物回归检查。

9. 快速上手清单（10 分钟版本）

设置里启用一个内置宠物，确认 overlay 正常。
安装 hatch-pet 并重载技能。
生成第一个自定义宠物。
检查输出目录是否包含 pet.json 与 spritesheet.webp。
放入 ~/.codex/pets/<pet-id>/ 并在设置页启用。
用 /pet 与快捷键验证开关是否正常。

参考链接

OpenAI Developers（Codex App Settings）：https://developers.openai.com/codex/app/settings
OpenAI Developers（Agent Skills）：https://developers.openai.com/codex/skills
OpenAI Skills 仓库 README：https://github.com/openai/skills
hatch-pet（官方技能定义）：https://github.com/openai/skills/blob/main/skills/.curated/hatch-pet/SKILL.md
社区安装说明（含 manifest 示例）：https://codexpets.org/install
社区 Hatch 指南：https://codex-pet.org/how-to-create-a-codex-pet/
社区一键安装工具说明：https://codex-pet.com/
兼容问题参考（官方仓库 issue）：

OpenClaw Skill 01：ByteRover 知识库实战指南

Tue, 10 Mar 2026 00:00:00 +0000

一、Skill 定位

ByteRover 是 OpenClaw 生态里最常用的知识库能力之一，核心价值是把分散文档转成“可检索、可引用、可复用”的知识资产。
在实际工作中，它通常承担三件事：

把团队资料统一索引，减少重复问答。
让回答可回溯到原文来源，便于审核。
为后续自动化流程提供稳定知识底座。

二、典型使用场景

新人入职：快速检索项目规范、部署流程、常见故障。
技术支持：从 SOP 和历史案例中检索最接近的处理路径。
产品运营：从活动文档与数据周报中抽取可复用结论。
研发协作：把 ADR、设计文档、接口说明统一沉淀。

三、安装与前置准备

1) 前置条件

已安装并可正常运行 OpenClaw。
已配置可用模型与基础工具。
准备好知识源目录（Markdown、PDF、网页导出文档等）。

2) 安装命令

# 安装 ByteRover skill
clawhub install byterover

# 同步本地已安装 skills
clawhub sync --all

3) 建议配置

在项目环境变量中补齐知识库连接参数，例如：

export BYTEROVER_API_KEY="your_api_key"
export BYTEROVER_INDEX="team-knowledge"

四、手把手使用方法

Step 1：建立知识目录结构

推荐采用三层结构：

01-guides：操作手册与流程。
02-architecture：架构与技术方案。
03-ops：运维与故障处理记录。

这样可以显著提升检索召回的稳定性。

Step 2：执行首次入库

在会话中给出明确任务描述：

/skill byterover
请将 docs/ 目录文档建立索引，按“架构/运维/业务”打标签，并输出入库摘要。

Step 3：做带引用的问答

/skill byterover
基于已索引文档，回答“服务发布失败后如何回滚”，并附来源文件名与章节。

Step 4：做增量更新

每次变更只更新新增内容，避免全量重建导致成本升高。

五、排错与注意事项

检索结果空白：优先检查索引名是否一致、文档是否真的入库。
回答不稳定：缩小检索范围，给出更清晰的问题上下文。
成本过高：改为增量索引，限制单次检索文档数量。
敏感信息泄露风险：入库前先做脱敏，明确禁止目录。
版本污染：同一知识库要有版本标识，避免旧文档覆盖新规则。

六、落地清单（可直接执行）

确定知识源目录与命名规范。
安装 byterover 并完成首次索引。
统一问答模板：结论 + 依据 + 来源。
每周做一次增量入库和失效文档清理。
建立“高频问题榜”，持续优化知识结构。

七、参考资料

OpenClaw Skills 文档：https://docs.openclaw.ai/skills
ByteRover Skill 说明：https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/byterover
OpenClaw 安装文档：https://docs.openclaw.ai/install/index

Openclaw 项目入门：是什么、能做什么、怎么安全使用

Mon, 09 Mar 2026 00:00:00 +0000

官方仓库（建议只从这里进入）：
https://github.com/openclaw/openclaw

Openclaw 是什么

Openclaw 可以理解为一个“可执行任务的个人 AI 助手”框架。
它不是只聊天的机器人，而是更偏向 Agent：能接入你的工具、读取上下文、执行任务并返回结果。

这个项目的作用

它的核心价值是把“问答”变成“动作”：

把多个工具统一接入到一个助手里（消息、文档、任务、自动化等）。
让重复流程自动化（例如定时汇总、跨工具同步、提醒与追踪）。
给个人或小团队提供可自托管、可扩展的 Agent 工作流底座。

能做些啥（典型能力）

多渠道交互：在你常用的沟通入口里与助手对话并下发任务。
工具连接：对接外部服务后，执行查询、整理、分发等动作。
自动化执行：把固定流程编排成可重复执行的任务。
可扩展能力：通过插件/技能机制扩展新场景。

需要注意些啥（务必先看）

权限边界：Agent 拿到什么权限，就可能执行到什么程度；最小权限原则要先落地。
数据安全：敏感信息（API Key、私有文档、数据库凭据）必须隔离存储与审计。
来源可信：只从官方仓库和官方文档安装，不要直接运行来路不明的脚本或“二次打包版”。
成本控制：接入模型和外部服务后要做调用限额、重试和预算告警。
生产前验证：先在测试环境做流程演练，再逐步放量到正式场景。

围绕 Openclaw 的“花边新闻”（社区讨论点）

下面是近期开源社区里最常见的话题方向（更偏“趋势观察”）：

生态增长很快：围绕插件、部署、最佳实践的二级项目越来越多。
安全话题持续升温：越“能干活”的 Agent，越要重视权限和供应链安全。
架构路线争议：社区常讨论“RAG 优先”还是“工具调用优先”，Openclaw 通常被放在后者语境里对比。

说明：花边信息更新快、噪声也大，建议以仓库 README、Issues、Discussions 和官方发布说明为准。

建议的学习路径

先通读官方 README，明确架构和依赖。
用最小可用配置跑通一个简单自动化流程。
再逐步增加连接器、权限策略和监控告警。
最后再进入复杂业务编排，避免一开始“全家桶”导致排错困难。

参考链接

Openclaw GitHub: https://github.com/openclaw/openclaw

AI

Mon, 01 Jan 0001 00:00:00 +0000

AI 分类聚焦 AI Agent 与 Openclaw 相关技术实践。

Openclaw

Mon, 01 Jan 0001 00:00:00 +0000

Openclaw 专题内容，覆盖入门、部署、skills 使用与风险控制。

AI Agent on 忘川

Codex Pets 使用详细说明（官方 + 社区实战整合）

1. Codex Pets 是什么

2. 官方启用路径（建议先做）

3. 自定义宠物生成：hatch-pet 正确流程

3.1 安装技能

3.2 触发生成

3.3 生成机制（官方 skill 关键点）

4. 本地文件结构与包规范

5. 已有宠物的两种安装方式

方式 A：手动安装（可控）

方式 B：社区 CLI 一键安装（更快）

6. 官方与社区能力边界

7. 高频问题与排障清单

7.1 /pet 输入后没有触发，仅当普通消息发送

7.2 hatch-pet 已安装但命令补全里找不到

7.3 生成流程中断并出现 stream disconnected

8. 面向生产使用的建议

9. 快速上手清单（10 分钟版本）

参考链接

OpenClaw Skill 01：ByteRover 知识库实战指南

一、Skill 定位

二、典型使用场景

三、安装与前置准备

1) 前置条件

2) 安装命令

3) 建议配置

四、手把手使用方法

Step 1：建立知识目录结构

Step 2：执行首次入库

Step 3：做带引用的问答

Step 4：做增量更新

五、排错与注意事项

六、落地清单（可直接执行）

七、参考资料

Openclaw 项目入门：是什么、能做什么、怎么安全使用

Openclaw 是什么

这个项目的作用

能做些啥（典型能力）

需要注意些啥（务必先看）

围绕 Openclaw 的“花边新闻”（社区讨论点）

建议的学习路径

参考链接

AI

Openclaw

7.1 `/pet` 输入后没有触发，仅当普通消息发送

7.2 `hatch-pet` 已安装但命令补全里找不到