diff --git a/src/runtime/openclaw-telegram-patch-contract.ts b/src/runtime/openclaw-telegram-patch-contract.ts
new file mode 100644
index 0000000..d5f7180
--- /dev/null
+++ b/src/runtime/openclaw-telegram-patch-contract.ts
@@ -0,0 +1,26 @@
+import type { ReplyEndChoice, TelegramInlineButton } from "../types.js"
+import { buildTelegramReplyEndAck, buildTelegramReplyEndButtonsForReply, buildTelegramReplyEndButtonsForResolvedChoice } from "./openclaw-telegram-bridge.js"
+
+export type OpenClawTelegramPatchContract = {
+  defaultButtons: TelegramInlineButton[][]
+  resolved: Record<ReplyEndChoice, {
+    buttons: TelegramInlineButton[][]
+    acknowledgement: string
+  }>
+}
+
+export function buildOpenClawTelegramPatchContract(): OpenClawTelegramPatchContract {
+  return {
+    defaultButtons: buildTelegramReplyEndButtonsForReply(),
+    resolved: {
+      continue: {
+        buttons: buildTelegramReplyEndButtonsForResolvedChoice("continue"),
+        acknowledgement: buildTelegramReplyEndAck("continue"),
+      },
+      stop: {
+        buttons: buildTelegramReplyEndButtonsForResolvedChoice("stop"),
+        acknowledgement: buildTelegramReplyEndAck("stop"),
+      },
+    },
+  }
+}
diff --git a/tests/runtime-patch-contract.test.mjs b/tests/runtime-patch-contract.test.mjs
new file mode 100644
index 0000000..c2518b4
--- /dev/null
+++ b/tests/runtime-patch-contract.test.mjs
@@ -0,0 +1,14 @@
+import test from "node:test"
+import assert from "node:assert/strict"
+
+import { buildOpenClawTelegramPatchContract } from "../src/runtime/openclaw-telegram-patch-contract.ts"
+
+test("patch contract exposes default and resolved callback behavior from shared repo-side logic", () => {
+  const contract = buildOpenClawTelegramPatchContract()
+  assert.equal(contract.defaultButtons[0][0].callback_data, "rec:continue")
+  assert.equal(contract.defaultButtons[0][1].callback_data, "rec:stop")
+  assert.match(contract.resolved.continue.buttons[0][0].text, /^✅/)
+  assert.match(contract.resolved.stop.buttons[0][1].text, /^⏹/)
+  assert.equal(contract.resolved.continue.acknowledgement, "reply-end-controls: continue received")
+  assert.equal(contract.resolved.stop.acknowledgement, "reply-end-controls: stop received")
+})