Skip to main content
Arka 包含几个受 OpenClaw 启发 的特性(并非独立的 OpenClaw 产品集成)。它们为第三方插件添加了持久化会话笔记、Agent 健康跟踪,以及声明式技能门禁。

会话记忆

存储在 ~/.config/arka/agent-memory/ 下的基于 Markdown 的会话笔记:
  • MEMORY.md —— 长期笔记(自动修剪)
  • daily/YYYY-MM-DD.md —— 每日会话笔记
当 SESSION_MEMORY=1 时,Arka 会通过 context_for() 将召回的上下文注入 Agent 循环中。

环境变量

Arka 会在存储前对笔记进行净化,并阻止注入模式和不安全内容。

心跳

跟踪最后一次 Agent 活动、安全标志、例程数量和记忆统计。
Arka 将心跳数据写入 ~/.cache/fish-agent/heartbeat.json。每次 ping() 会追加到有界的 history 环形缓冲(默认 20 条;可用 HEARTBEAT_HISTORY 覆盖)。会话记忆和例程等子系统在活动时会自动调用 ping()。

技能清单门禁

第三方插件可以在 skill.json 中声明 OpenClaw 风格的门禁。Arka 在发现、路由和执行期间应用它们。

顶层字段

metadata.openclaw(或 metadata.arka / metadata.hermes)

相同的字段可以位于 metadata.openclaw、metadata.arka 或 metadata.hermes 下,以兼容 OpenClaw 风格和 Hermes 风格的清单:
Arka 在解析时会将这些元数据块中的任何一个合并到顶层的 requires、os 和 permissions 字段中。

门禁行为

被门禁阻止的技能:
  • 在 arka skills list 中标记为 [gated: reason]
  • 被 match_command() 跳过,使路由不会匹配到不可用的插件
  • 在 run_skill() 处作为安全网阻止

环境变量

另请参阅:安装插件 以及 src/arka/skills/examples/demo_echo/skill.json 中的示例。

相关安全

例程和 webhook 应用独立的加固层:
  • ROUTINES_SECURITY=1 —— 针对已调度任务的符号动作检查
  • Webhook 入站验证会阻止注入负载
它们与 安全 中记录的全局 SECURITY、SECURITY_LLM 和 SECURITY_ACTIONS 标志协同工作。