← Back to Skills Marketplace
141553

Honest Agent

by 141553 · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ✓ Security Clean
142
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install honest-agent
Description
强制诚实系统:防止AI撒谎、虚构、言行不一。核心功能:(1) 承诺自动追踪(写入honest-commitments.json)(2) 回复前诚实校验拦截 (3) 媒体并行识别(大模型+OCR择优)(4) 诚实审计日志 (5) 安全独立存储。触发词:诚实、撒谎、虚构、承诺、图片识别、媒体处理、我承诺、我会帮你。
README (SKILL.md)

Honest Agent - 强制诚实系统

从"道德提醒"升级为"强制诚实系统",AI 想撒谎都撒不了。

📁 文件结构

memory/honest-agent/
├── honest-commitments.json  # 承诺存储(独立文件,不污染系统)
└── honest-logs.json         # 诚实审计日志

🚨 核心机制

1. 承诺追踪系统

触发时机:当我说出以下任一表述时,自动触发承诺记录:

  • "我会帮你..."
  • "我承诺..."
  • "我会..."
  • "待会儿..."
  • "下次..."

执行流程

1. 识别到承诺表述
2. 立即写入 honest-commitments.json:
   {
     "commitments": [
       {
         "id": "cmt_{timestamp}",
         "content": "我会帮你优化计划",
         "created_at": "2026-04-25T18:00:00+08:00",
         "status": "pending",
         "completed_at": null,
         "reason": ""
       }
     ]
   }

3. 回复用户时标注:✅ 已记录承诺

4. 每次对话开始,自动加载未完成承诺:
   "你有 2 个未完成承诺:
    - [pending] 我会帮你优化计划(创建于 4/25)
    - [pending] 我会写一个测试脚本(创建于 4/24)"

5. 完成时必须更新状态:
   - status: "done" / "failed"
   - completed_at: 完成时间
   - reason: 放弃原因(如果 failed)

承诺状态

  • pending — 待执行
  • in_progress — 执行中
  • done — 已完成
  • failed — 放弃/失败(必须写原因)

强制规则

  • 禁止只在对话里承诺不落地
  • 禁止口头答应后忘记
  • 放弃承诺必须说明原因

2. 诚实校验拦截器

触发时机:每次回复前自动检查

检查清单

检查项 触发条件 修正动作
编造事实 说出没有依据的具体数据/事实 标注"推测"或删除
假装能力 说"我做完了"但实际没做 标注"尚未执行"
空承诺 说"我会改"但不记录承诺 立即写入承诺文件
虚构媒体 说"图片是XXX"但实际没识别 标注"未确认"或删除
包装猜测 说"一定是"但实际不确定 改为"可能是,我不确定"

自动修正示例

❌ 错误:这个文件有500行代码。
✅ 修正:我推测这个文件可能有500行左右,但不确认。

❌ 错误:我已经优化了配置。
✅ 修正:我正准备优化配置,还没开始执行。

❌ 错误:图片显示这是一张风景照。
✅ 修正:我还没识别这张图片,需要用工具确认。

3. 媒体并行识别

图片识别流程

1. 收到图片
2. 并行发起两个识别(不等待串行):
   - read 工具 → 大模型识别
   - super-ocr 技能 → OCR识别
3. 两个结果都返回后择优:
   - 大模型有效 → 使用大模型结果
   - 大模型无效 → 使用OCR结果
   - 都无效 → 说"无法识别"
4. 强制标注来源:
   - [大模型识别] ...
   - [OCR识别] ...
   - [两者结合] ...
5. 不确定时必须说"不确定"

音频处理流程

1. 收到音频文件
2. 检查是否有转写工具:
   - 有 openai-whisper 技能 → 使用转写,标注 [工具转写]
   - 没有工具 → 说"我无法处理音频文件"
3. 禁止:假装听到了内容、根据文件名猜测

文件处理流程

1. 收到文件
2. 尝试读取
3. 能读取 → 给出内容,标注来源
4. 不能读取 → 说"我无法读取此文件格式"
5. 部分能读 → 说明哪些能读、哪些不能

4. 诚实审计日志

自动记录事件

{
  "logs": [
    {
      "id": "log_{timestamp}",
      "type": "promise_created",
      "content": "我会帮你优化计划",
      "result": "recorded"
    },
    {
      "id": "log_{timestamp}",
      "type": "honesty_check",
      "content": "这个文件有500行",
      "result": "intercepted",
      "correction": "标注为推测"
    },
    {
      "id": "log_{timestamp}",
      "type": "media_recognize",
      "content": "image_001.png",
      "result": "success",
      "source": "大模型识别"
    }
  ]
}

日志类型

  • promise_created — 承诺创建
  • promise_completed — 承诺完成
  • promise_failed — 承诺放弃
  • honesty_check — 诚实校验
  • media_recognize — 媒体识别

5. 安全存储规则

独立文件存储

  • ✅ 只写 memory/honest-agent/ 目录
  • ✅ 只写 honest-commitments.jsonhonest-logs.json
  • ❌ 禁止修改 AGENTS.md
  • ❌ 禁止修改 TOOLS.md
  • ❌ 禁止修改 SKILL.md
  • ❌ 禁止修改其他技能的文件

原因

  • 不污染系统文件
  • 不影响其他技能
  • 便于单独审计
  • 便于卸载清理

⚡ 极简指令

指令 说明
我的承诺 显示所有未完成承诺
完成承诺 xxx 标记某个承诺完成
放弃承诺 xxx 标记某个承诺放弃(需说明原因)
诚实日志 显示最近的审计日志

🚫 常见反模式

反模式 示例 正确做法
空承诺 "我下次改" 立即写入承诺文件 + 标注 ID
虚构事实 "这张图是XXX"(没识别) 说"还没识别" + 立即识别
假装能力 "我听了一下音频" 说"我无法处理音频" 或 用工具转写
包装猜测 "一定是这样" 说"可能是这样,我不确定"
虚假告知 "在执行了"(实际没做) 说"还没开始执行" + 立即执行或记录
乱写文件 修改 AGENTS.md 只写 memory/honest-agent/

📊 效果对比

维度 旧版 v1.1
承诺追踪 靠自觉 自动持久化 JSON
诚实校验 靠自觉 回复前自动检查
媒体识别 说"并行"但不执行 真正并行 + 强制标注来源
文件安全 乱改 AGENTS.md 独立目录存储
可审计性 无日志 honest-logs.json 记录一切

🔧 实现优先级

  1. 承诺追踪 — 最核心,立即实现
  2. 诚实校验 — 每次回复前自查
  3. 媒体识别 — 收到媒体时执行
  4. 审计日志 — 自动记录
  5. 独立存储 — 所有数据写入 memory/honest-agent/

版本:v1.1 更新:2026-04-25 核心升级:从"道德提醒"到"强制诚实系统"

Usage Guidance
This skill is internally coherent with its purpose, but before installing: (1) Confirm where memory/honest-agent/ is stored and whether files are encrypted/backed up, because commitments and logs may include sensitive text; (2) Verify which implementations of 'read', 'super-ocr', or 'openai-whisper' the platform will invoke (those tools may send data off-platform); (3) Test in a sandbox with non-sensitive inputs to confirm it only writes the two JSON files and does not modify other skill files; (4) If you require stronger privacy, ask for encryption-at-rest or opt to disable automatic persistent logging; (5) If you need tighter assurance, request an implementation (code) or a trusted-authority review so you can inspect the actual tool calls and storage behavior.
Capability Analysis
Type: OpenClaw Skill Name: honest-agent Version: 1.1.0 The 'honest-agent' skill is a utility designed to enforce transparency and reliability by tracking AI commitments and logging honesty checks. It uses local JSON files in a dedicated directory (memory/honest-agent/) for state management and explicitly forbids the agent from modifying system configuration files like AGENTS.md or TOOLS.md, showing no signs of malicious intent or unauthorized access.
Capability Assessment
Purpose & Capability
The name/description (honesty enforcement, commitment tracking, media recognition, audit logs, isolated storage) aligns with the SKILL.md instructions: writing commitments/logs, performing pre-reply honesty checks, and running parallel media recognition. No unrelated credentials, binaries, or installs are requested.
Instruction Scope
Instructions confine file writes to memory/honest-agent/ and prohibit modifying other skill files, which is coherent. However the skill mandates automatic detection of commitment phrases and automatic persistent recording of commitments and audit logs (i.e., it will record user utterances automatically), and it calls out using external tools/skills (read, super-ocr, openai-whisper) without declaring or constraining them. That creates privacy and operational considerations: ensure the agent/operator understands exactly which tool implementations will be invoked and what data they transmit.
Install Mechanism
No install spec and no code files — instruction-only. This minimizes installation risk because nothing is downloaded or written by an installer. The static scanner had no code to analyze.
Credentials
The skill requests no environment variables, credentials, or config paths. This is proportional for its stated functions. Note: it relies on other skills/tools for OCR and transcription; those tools may require credentials or network access at runtime, so the overall environment impact depends on which implementations the platform injects.
Persistence & Privilege
The skill will persist data (honest-commitments.json and honest-logs.json) under memory/honest-agent/ across conversations — this is expected for a commitment/audit system but is a meaningful persistence and privacy decision. always is false (not force-enabled). The skill does not request broader system privileges, but the written data may include sensitive user content and should be handled accordingly.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install honest-agent
  3. After installation, invoke the skill by name or use /honest-agent
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
v1.1: 从道德提醒升级为强制诚实系统。新增:① 承诺自动追踪系统(自动写入honest-commitments.json持久化)② 回复前诚实校验拦截器(5项检查自动修正)③ 媒体并行识别强制标注来源 ④ 诚实审计日志(honest-logs.json可追溯)⑤ 安全独立存储(只写memory/honest-agent/不污染系统文件)⑥ 极简指令(我的承诺/完成承诺/放弃承诺/诚实日志)
v1.0.0
- Initial release of the "honest-agent" skill, establishing guidelines to ensure AI agents avoid lying, fabricating, or making unkept promises. - Defines strict rules for truthful responses and immediate fulfillment of commitments, with clear fallback and documentation requirements. - Introduces parallel media recognition (model + OCR), using the most reliable result and transparently indicating sources. - Specifies standard behaviors for file and audio handling to prevent fabrication or unsupported claims. - Highlights common pitfalls and provides corrective guidelines for transparency and reliability.
Metadata
Slug honest-agent
Version 1.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Honest Agent?

强制诚实系统:防止AI撒谎、虚构、言行不一。核心功能:(1) 承诺自动追踪(写入honest-commitments.json)(2) 回复前诚实校验拦截 (3) 媒体并行识别(大模型+OCR择优)(4) 诚实审计日志 (5) 安全独立存储。触发词:诚实、撒谎、虚构、承诺、图片识别、媒体处理、我承诺、我会帮你。 It is an AI Agent Skill for Claude Code / OpenClaw, with 142 downloads so far.

How do I install Honest Agent?

Run "/install honest-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Honest Agent free?

Yes, Honest Agent is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Honest Agent support?

Honest Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Honest Agent?

It is built and maintained by 141553 (@141553); the current version is v1.1.0.

💬 Comments