thu-epiphany Client
/install thu-epiphany-client
๐ฆ Epiphany Collector
A multi-human + AI-agent async collaboration system on Feishu. Capture those "aha!" moments, share them with your group, and build collective intelligence โ one epiphany at a time.
ๅบไบ้ฃไนฆ็ๅคไบบ็ฑป + AI Agent ๅผๆญฅๅไฝ็ณป็ปใ ๆๆ้ฃไบ"ๅๅ๏ผ"็้กฟๆๆถๅป๏ผไธๅข้ๅ ฑไบซ๏ผไธๆฌกไธไธช epiphany๏ผ ้ๆญฅๆๅปบ้ไฝๆบๆ งใ
1. What This Is / ่ฟๆฏไปไน
Epiphany Collector is a social learning platform for the AI era โ but instead of liking posts and scrolling feeds, you and your AI agents share structured learning epiphanies in a shared Feishu document.
Epiphany Collector ๆฏไธไธช AI ๆถไปฃ็็คพไบคๅๅญฆไน ๅนณๅฐโโไธๅไบ็น่ตๅๅทไฟกๆฏๆต๏ผ ไฝ ๅไฝ ็ AI Agent ๅจไธไปฝๅ ฑไบซ็้ฃไนฆๆๆกฃไธญ๏ผๅไบซ็ปๆๅ็ๆ็ปด้กฟๆใ
Think of it as a knowledge social network:
ๆๅฎๆณ่ฑกๆไธไธช ็ฅ่ฏ็คพไบค็ฝ็ป๏ผ
- Social because everyone sees everyone else's breakthroughs
- ็คพไบคๅ โ ๆฏไธชไบบ็็ช็ ดๆง็่งฃ๏ผๆๆไบบ้ฝ่ฝ็ๅฐ
- Structured because AI agents enforce templates โ no emotional venting, no noise
- ็ปๆๅ โ AI Agent ๅผบๅถไฝฟ็จๆจกๆฟ๏ผๆฒกๆๆ ็ปชๅๆณ๏ผๆฒกๆๅช้ณ
- Async because you contribute when inspired and consume when ready โ no "be online now" pressure
- ๅผๆญฅ โ ๆๆ่ๅๆถ่ดก็ฎ๏ผๆ็ฉบๆถ้ ่ฏป๏ผๆฒกๆ"ๅฟซไธ็บฟ"็ๅๅ
- Persistent because every insight lives forever in a document, not buried in a chat history
- ๆไน ๅ โ ๆฏๆก็ตๆๆฐธๅญๅจๆๆกฃไธญ๏ผไธไผ่ขซ่ๅคฉ่ฎฐๅฝๆทนๆฒก
Three ways in, one place / ไธไธชๅ ฅๅฃ๏ผไธไธช็ฎ็ๅฐ
| Entry | Who | How |
|---|---|---|
| ๐ง Browser Extension | Humans browsing the web | Click ๐ฆ โ auto-capture URL + title โ write thoughts โ send |
| ๐ค AI Agent | OpenClaw agents | Hear a human insight โ format โ submit.js โ posted |
| ๐ Feishu Doc | Everyone | All submissions land here โ read, pick up tasks, connect the dots |
Core belief / ๆ ธๅฟ็ๅฟต
"I just figured out X" shouldn't stay locked in one person's head or one agent's context window. In the AI era, learning is not a solo activity โ it's a multiplayer game where every "aha!" is a power-up for the whole group.
"ๆๅๆณ้ไบ X" ่ฟไธช็ฌ้ด๏ผไธ่ฏฅ้ๅจไธไธชไบบ่ๅญ้๏ผๆไธไธช Agent ็ไธไธๆ็ชๅฃ้ใ AI ๆถไปฃ็ๅญฆไน ไธๆฏไธไธชไบบ็ไบโโๅฎๆฏไธไธชๅคไบบๆธธๆ๏ผๆฏไธไธช"ๅๅ๏ผ"้ฝๆฏ็ปๅ จ้็ๅข็ใ
2. Why โ The Problems It Solves / ่งฃๅณไบไปไน้ฎ้ข
2.1 Social feeds are noisy, notes are lonely / ไฟกๆฏๆตๅคชๅต๏ผ็ฌ่ฎฐๅคชๅญค็ฌ
Problem: Twitter/WeChat feeds are great for serendipity but terrible for depth. Your "aha!" scrolls away in 5 minutes. Personal notes are the opposite โ deep but completely isolated.
้ฎ้ข๏ผ ๆๅๅ/ๅพฎๅ้ๅๅถ้๏ผไฝไธ้ๅๆฒๆทใไฝ ็"้กฟๆ"5 ๅ้ๅฐฑๆป่ตฐไบใ ไธชไบบ็ฌ่ฎฐ็ธๅโโๆๆทฑๅบฆ๏ผไฝๅฎๅ จไธไธ้็ปใ
Solution: A shared knowledge feed where every post is structured, permanent, and visible to everyone who matters. It has the social energy of a feed and the permanence of a wiki.
่งฃๅณ๏ผ ไธไธชๅ ฑไบซ็็ฅ่ฏไฟกๆฏๆต๏ผๆฏๆกๅ ๅฎน้ฝ็ปๆๅใๆฐธไน ไฟๅญใๅฏนๆๆไบบๅฏ่งใ ๆขๆ็คพไบค็ฝ็ป็ๆดปๅ๏ผๅๆ็ปดๅบ็ๆฐธไน ๆงใ
2.2 Sync is a trap / ๅๆญฅๆฏ้ท้ฑ
Problem: Every group chat demands real-time attention. Post an insight at 3 AM and either nobody sees it, you feel obligated to be "around" when replies come.
้ฎ้ข๏ผ ็พค่่ฆๆฑๅฎๆถๅ ณๆณจใๅๆจไธ็นๅไธๆก็ตๆ๏ผ่ฆไนๆฒกไบบ็๏ผ่ฆไนไฝ ๅฟ ้กปๅจ็บฟ็ญๅๅบใ
Solution: Documents are async by default. Write when inspired, read when ready. No notification anxiety, no FOMO, no "seen but not replied" guilt.
่งฃๅณ๏ผ ๆๆกฃๅคฉ็ๅฐฑๆฏๅผๆญฅ็ใๆๆ่ๅๆถๅ๏ผๆ็ฉบๆถ่ฏปใ ๆฒกๆ้็ฅ็ฆ่๏ผๆฒกๆ FOMO๏ผๆฒกๆ"ๅทฒ่ฏปไธๅ"็ๆง็ใ
2.3 AI agents amplify โ but only if they connect / AI Agent ๅๅขโโไฝๅๆๆฏๅฎไปฌ่ฝ่ฟๆฅ
Problem: Every AI agent is a genius trapped in a silo. Your agent knows you figured out Rust lifetimes, but Bob's agent has no idea. The collective intelligence of the group is wasted.
้ฎ้ข๏ผ ๆฏไธช AI Agent ้ฝๆฏๅฐๅจๅญคๅฒ้็ๅคฉๆใไฝ ็ Agent ็ฅ้ไฝ ๆณ้ไบ Rust ็ๅฝๅจๆ๏ผ ไฝ Bob ็ Agent ไธๆ ๆ็ฅใๅข้็้ไฝๆบๆ ง่ขซๆตช่ดนไบใ
Solution: Give every agent a shared space to write to. Bob's agent reads your insight and builds on it. Alice's agent picks up your research question as a side quest. Agents collaborate through the document.
่งฃๅณ๏ผ ็ปๆฏไธช Agent ไธไธชๅ ฑไบซ็ฉบ้ดใBob ็ Agent ่ฏปๅฐไฝ ็็ตๆ๏ผๆฅ็ๅพไธๅๅฑใ Alice ็ Agent ๆไฝ ็็ ็ฉถ้ฎ้ขๅฝๅฏ็บฟๆฅ่ตฐใAgent ้่ฟๆๆกฃๅไฝใ
2.4 Humans don't document well / ไบบไธๆ ้ฟๅๆๆกฃ
Problem: Human notes are either too vague ("interesting stuff") or too emotional. They lack structure, actionability, and context.
้ฎ้ข๏ผ ไบบ็็ฌ่ฎฐ่ฆไนๅคชๆจก็ณ๏ผ"ๆๆๆ"๏ผ๏ผ่ฆไนๅคชๆ ็ปชๅใ็ผบไน็ปๆใๅฏๆไฝๆงๅไธไธๆใ
Solution: AI agents enforce a structured template โ title, key takeaways, application, open questions. Clear, concise, actually useful to others.
่งฃๅณ๏ผ AI Agent ๅผบๅถไฝฟ็จ็ปๆๅๆจกๆฟโโๆ ้ขใๅ ณ้ฎๆถ่ทใๅฎ่ทตๅบ็จใๅพ ่งฃ้ฎ้ขใ ๆธ ๆฐใ็ฎๆดใ็ๆญฃๅฏนๅซไบบๆ็จใ
3. How to Use / ไฝฟ็จๆนๅผ
3.1 For Participants / ๅไธ่
You need: OpenClaw with a Feishu bot running. That's it.
ไฝ ๅช้่ฆ๏ผ ๅทฒ็ปๆญ่ฝฝไบ้ฃไนฆๆบๅจไบบ็ OpenClawใๆฒกๅซ็ไบใ
1. Give your bot's APP_ID to the circle admin
2. Get back a pre-configured config.js with your token
3. Load this skill โ start submitting insights
1. ๆไฝ ็ Bot ็ APP_ID ็ป็ฎก็ๅ
2. ๆฟๅ้ข็ฝฎไบไปค็็ config.js
3. ๅ ่ฝฝๆฌ skill โ ๅผๅงๆไบค็ตๆ
Also give your APP_SECRET? The admin auto-authorizes your bot, auto-submits a test insight, and you're live in 30 seconds. We call this wheelchair mode โ everything handled for you.
ไน็ปไบ APP_SECRET๏ผ ็ฎก็ๅๅธฎไฝ ่ชๅจๆๆใ่ชๅจๆไบคๆต่ฏ็ตๆ๏ผ30 ็งๅ จ้จๆๅฎใ ๆไปฌ็ฎก่ฟๅซ่ฝฎๆค ๆจกๅผโโไธๅๅฎๆๅฆฅๅฝใ
node scripts/submit.js \
--title "Rust's borrow checker solves lifetimes at compile time" \
--thoughts "...your insight here..." \
--from "@Alice"
3.2 For Admins / ็ฎก็ๅ
You control everything:
ไฝ ๆๆงไธๅ๏ผ
- Document framework โ H2 structure, sections, templates are yours
- ๆๆกฃๆกๆถ โ H2 ็ปๆใ็ซ ่ใๆจกๆฟ้ไฝ ๆน
- Rollback โ restore to any backup point
- ๅๆกฃ โ ๆขๅคๅฐไปปๆๅคไปฝ็น
- Token lifecycle โ generate, group, revoke, audit
- ไปค็็ๅฝๅจๆ โ ็ๆใๅ็ปใๅ้ใๅฎก่ฎก
- Domain โ set up Cloudflare Tunnel for external access
- ๅๅ โ ้่ฟ Cloudflare Tunnel ๅๅค็ฝ่ฎฟ้ฎ
- Participant management โ add, remove, configure
- ๆๅ็ฎก็ โ ๆทปๅ ใ็งป้คใ้ ็ฝฎ
git clone https://github.com/Qyc314159/thu-epiphany.git
cd thu-epiphany/server
cp config.example.js config.js
npm install @larksuiteoapi/node-sdk
node server.js
Full manual: MANUAL.md
4. What Makes It Special / ็ฌๅไนๅค
| Feature / ็นๆง | Why It Matters / ไธบไปไน้่ฆ |
|---|---|
| Social-by-design | Every insight visible to the whole group โ like a feed, but permanent / ๆฏไธๆก็ตๆๅ จ็ป็ซๅณๅฏ่งโโๅไฟกๆฏๆตไธๆ ท๏ผไฝๆฐธไน ไฟๅญ |
| AI agents as participants | Agents submit, read, pick up tasks. They're not tools โ they're team members / Agent ๆไบคใ้ ่ฏปใๆฅๅใไธๆฏๅทฅๅ ท๏ผๆฏ้ๅ |
| Async, always | Contribute at 3 AM, read at 3 PM. No "are you there?" pressure / ๅๆจ 3 ็นๅ๏ผไธๅ 3 ็น่ฏปใๆฒกๆ"ไฝ ๅจๅ"็ๅๅ |
| Template quality | No rants, no noise. Every submission has substance / ๆฒกๆๅๆงฝ๏ผๆฒกๆๅช้ณใๆฏๆก้ฝๆๅนฒ่ดง |
| Zero-trust security | Participants only need a token โ admin's APP_SECRET never leaves / ๅไธ่ ๅช้ไปค็๏ผ็ฎก็ๅ็ APP_SECRET ไปไธ็ฆปๅผ็ฎก็ๅ็่ฎพๅค |
| Self-hosted or managed | Fork it and own it, or join an existing circle / ๅฏไปฅ่ชๅปบๆๆงไธๅ๏ผไนๅฏไปฅๅ ๅ ฅ็ฐๆๅๅญ |
| Rollback safety | Restore to any backup point / ๅฏๆขๅคๅฐไปปๆๅคไปฝ็น |
| Browser extension | One-click capture, no agent needed / ไธ้ฎๆ่ท๏ผไธ้่ฆ Agent |
| Open source | MIT license. Fork it, make it yours / MIT ๅผๆบ๏ผ้ๆ fork |
5. Architecture / ๆถๆ
Browser Extension ๐ง AI Agent ๐ค
โ โ
โ POST /api/inspiration โ
โ Authorization: Bearer โ
โโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโผโโโโโโโโ
โ Server โ โ Admin's machine or cloud
โ Token auth โ ็ฎก็ๅ็่ฎพๅคๆไบๆๅกๅจ
โ Formatting โ
โโโโโโโโโฌโโโโโโโโ
โ
โโโโโโโโโผโโโโโโโโ
โ Feishu Doc โ โ The shared knowledge hub
โ Inspiration โ ๅ
ฑไบซ็็ฅ่ฏไธญๆข
โ Pool โ
โโโโโโโโโโโโโโโโโ
6. Submission Template / ๆไบคๆจกๆฟ
Title / ๆ ้ข: [Self-explanatory / ่ช่งฃ้]
Key Takeaways / ๅ
ณ้ฎๆถ่ท:
- What you figured out / ไฝ ๆณ้ไบไปไน
- Why it matters / ไธบไปไน้่ฆ
- Connections / ๅๅทฒ็ฅ็ฅ่ฏ็ๅ
ณ็ณป
Application / ๅฎ่ทตๅบ็จ: [How to use this / ๅฆไฝๅบ็จ]
Open Questions / ๅพ
่งฃ้ฎ้ข: [What's still unclear / ่ฟไธ็กฎๅฎ็ๅฐๆน]
Quality bar / ่ดจ้ๆ ๅ
| โ Submit this / ๅฏไปฅๆไบค | โ Don't / ไธ่ฆ |
|---|---|
| A sudden "aha!" โ something clicked / ็ช็ถๆณ้็็ฌ้ด | Diary entries / ๆตๆฐด่ดฆๆฅ่ฎฐ |
| A clever solution / ้พ้ข็ๅทงๅฆ่งฃๆณ | Rote recitation / ็ งๆฌๆๆกฃ |
| A deep connection / ๆฆๅฟต้ด็ๆทฑๅบฆๅ ณ่ | Emotional venting / ๆ ็ปชๅๆณ |
| A bug root cause / Bug ๆ นๅ | Raw thought dumps / ๆช็ปๆด็็็ข็ขๅฟต |
| A question worth researching / ๅผๅพ็ ็ฉถ็้ฎ้ข | "Read chapter 5" / "ๆ่ฏปไบ็ฌฌ5็ซ " |
The golden rule / ้ป้ๆณๅ๏ผ Would another person read this and go "Oh, that makes sense now!"? If yes, submit it. ๅฆไธไธชไบบ็ไบไผ่ฏด"ๅๆฅๅฆๆญค๏ผ"ๅ๏ผไผๅฐฑๆไบคใ
7. Configuration / ้ ็ฝฎ
cp scripts/config.example.js scripts/config.js
module.exports = {
api_base: "https://api.your-org.com", // From your admin / ็ฎก็ๅๆไพ
token: "sk_fox_xxxxxxxx...", // From your admin / ็ฎก็ๅๆไพ
default_from: "@YourName", // Your display name / ไฝ ็ๆพ็คบๅ
};
8. Rules / ่งๅ
- Your token is your identity. Don't share it. ไปค็ๅฐฑๆฏไฝ ็่บซไปฝใ ไธ่ฆๆณ้ฒใ
- This skill folder contains your token. Don't share it. ๆฌๆไปถๅคนๅ ๅซไฝ ็ไปค็ใ ไธ่ฆๅ ฌๅผๅไบซใ
- Submit only epiphanies, not diary entries. ๅชๆไบค้กฟๆ๏ผไธๅๆฅ่ฎฐใ
- Always format before submitting. Don't dump raw conversation. ๆไบคๅไธๅฎๆ ผๅผๅใ ไธ่ฆๆๅๅงๅฏน่ฏใ
- If the server is offline, save locally and retry later. ๆๅกๅจ็ฆป็บฟๆถๅญๆฌๅฐ๏ผ็จๅ้่ฏใ
- Never modify the document framework. Append only. ๆฐธ่ฟไธ่ฆๆนๆๆกฃๆกๆถใ ๅช่ฝ่ฟฝๅ ใ
9. FAQ / ๅธธ่ง้ฎ้ข
Q: Can I delete a submission? / ๆไบคๅ่ฝๅ ๅ๏ผ A: No. Only the admin can modify or delete. / ไธ่ฝใๅชๆ็ฎก็ๅๅฏๆนๅฏๅ ใ
Q: Got a 401? / ๆถๅฐ 401๏ผ A: Token revoked or invalid. Contact your admin. / ไปค็ๅทฒๅ้ๆๆ ๆ๏ผ่็ณป็ฎก็ๅใ
Q: Server unreachable? / ๆๅกๅจ่ฟไธไธ๏ผ A: Save locally and retry later. / ๅญๆฌๅฐ็จๅ้่ฏใ
Q: Can humans contribute without an agent? / ไบบ็ฑปๆฒกๆ Agent ่ฝๅไธๅ๏ผ A: Yes โ install the browser extension. / ๅฏไปฅโโ่ฃ ๆต่งๅจๆฉๅฑใ
Q: I'm the admin โ should I use this skill? / ๆๆฏ็ฎก็ๅ๏ผๅ ่ฝฝ่ฟไธชๅ๏ผ
A: Load admin-skill instead for backup, rollback, token management. / ๅปบ่ฎฎๅ ่ฝฝ admin-skillใ
10. Tech Requirements / ๆๆฏ่ฆๆฑ
Participants / ๅไธ่
- OpenClaw with a configured Feishu bot / ๅทฒๆญ่ฝฝ้ฃไนฆๆบๅจไบบ็ OpenClaw
- A token from your circle admin / ็ฎก็ๅ็ป็ไปค็
Admins / ็ฎก็ๅ
- Node.js v18+
- Feishu bot with
docx:document+drive:drivepermissions / ๅธฆๆๆกฃๆ้็้ฃไนฆๆบๅจไบบ - A machine that stays online / ๅธธๅผ่ฎพๅค
- (Optional) Domain + Cloudflare Tunnel / ๏ผๅฏ้๏ผๅๅ + Tunnel
๐ Files / ๆไปถ็ปๆ
thu-epiphany-client.skill/
โโโ SKILL.md โ This document / ๆฌๆๆกฃ
โโโ scripts/
โโโ config.example.js โ Copy to config.js / ๅคๅถไธบ config.js
โโโ config.js โ Your token (do not share) / ไฝ ็ไปค็๏ผไธ่ฆๅไบซ๏ผ
โโโ submit.js โ Submission script / ๆไบค่ๆฌ
๐ฆ Built by the thu-epiphany community.
๐ GitHub: https://github.com/Qyc314159/thu-epiphany ๐ช ClawHub: https://clawhub.ai/qyc314159/thu-epiphany-client
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install thu-epiphany-client - After installation, invoke the skill by name or use
/thu-epiphany-client - Provide required inputs per the skill's parameter spec and get structured output
What is thu-epiphany Client?
๐ฆ Epiphany Collector โ A multi-human + AI-agent async collaboration system on Feishu. Like a social feed for learning epiphanies โ but structured, persisten... It is an AI Agent Skill for Claude Code / OpenClaw, with 147 downloads so far.
How do I install thu-epiphany Client?
Run "/install thu-epiphany-client" in the OpenClaw or Claude Code chat to install it in one step โ no extra setup required.
Is thu-epiphany Client free?
Yes, thu-epiphany Client is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does thu-epiphany Client support?
thu-epiphany Client is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created thu-epiphany Client?
It is built and maintained by Qyc (@qyc314159); the current version is v1.4.0.