從 OpenClaw 到 AgentOS：我的 AI Agent 搬遷紀錄

from-openclaw-to-agent-os.mdx[ ← back ]

2025-03-25Allen Hsu7 min read

一月多開始用 OpenClaw（龍蝦），跑了一段時間，也做了一些自動化的嘗試。但最近龍蝦的更新有點不穩定，版本很容易壞，踩了幾次坑之後開始覺得煩。

加上最近 Claude 出了不少新功能，前陣子的 Claude Code Session 加上這兩天的 Claude Computer Use，我試了一下，基本上可以完美替換 OpenClaw 了。所以就把原本的設定搬過來，參考 OpenClaw 的架構重新整理了一版。

看到蠻多人裝 OpenClaw 也遇到各種困難，乾脆把這個基本架構開源出來：AgentOS。

先講成本：我自己是 Mac + Claude Max，有些功能需要本地跑，所以不算低成本養龍蝦。要跑得順，最少也要一台 Mac Mini 加 Claude Pro 訂閱。

為什麼要搬？

龍蝦版本更新不穩定，有幾次升級完直接壞掉，要花時間 debug 框架本身而不是做正事
Claude Code 原生的 Agent tool 已經能做到 sub-agent 分派，不需要額外的 runtime
Claude Code Session 解決了串接 IM 的問題，Computer Use 補上了 GUI 操作的缺口
少一層框架就少一層會壞的東西

搬過來長什麼樣

AgentOS
├── CLAUDE.md              ← Chief：中央協調者（就是根目錄的這個檔案）
├── skills/                ← 共用技能（triage、morning briefing）
├── templates/             ← 建新 Agent / Skill 的範本
├── memory/                ← 共享知識庫與每日日誌
└── agents/
    ├── dev/               ← 工程師（coding、debug、架構）
    │   ├── CLAUDE.md
    │   ├── IDENTITY.md
    │   └── memory/
    ├── writer/            ← 創作者（文章、文件、email）
    │   ├── CLAUDE.md
    │   ├── IDENTITY.md
    │   └── memory/
    └── researcher/        ← 研究員（調查、分析、查核）
        ├── CLAUDE.md
        ├── IDENTITY.md
        └── memory/

跟 OpenClaw 概念類似，但不用裝 CLI，直接用 Claude Code 跑。claude 指令在專案根目錄執行，Chief 自動載入。如果你需要串接 Telegram，可以照 Claude Code Channels 這篇文件做，就能用 Telegram 跟你的 Agent 對話。

我怎麼組織每個 Agent

Chief 的 CLAUDE.md 大概長這樣：

## SOUL — Who I Am
你是 Chief，Allen 的 AI 幕僚長...
核心原則：能派就派、講重點不講全部、不確定就問...
 
## USER — Who I Work For
Allen，做軟體開發和知識管理，討厭 AI 廢話...
 
## AGENTS — What I Do & How
路由表：程式碼 → @dev、寫作 → @writer、研究 → @researcher...
 
## MEMORY — What I Know
## SKILLS — What I Can Do

SOUL、USER、AGENTS、TOOLS、MEMORY、SKILLS 六個區塊，每個 Agent 都這個結構，內容不同。

每個子 Agent 還有一個 IDENTITY.md，很短，大概十行：

# Dev Agent
## What I Do — 全端開發、除錯、重構、code review
## Send Me — 功能需求、Bug 回報、架構問題
## I Need — 清楚的目標描述、相關檔案路徑、驗收標準
## I Return — 可運作的程式碼（含測試）、變更摘要

這個檔案是給 Chief 看的，不是給人看的。Chief 在分派任務之前會先讀目標 Agent 的 IDENTITY.md，判斷要給什麼 context、怎麼包裝任務。現在框架裡留下來的 skill 不多，夠用就好

Triage — Chief 拿到請求之後，決定自己處理還是分派給誰
Morning Briefing — 每天開工先跑一次，看昨天做了什麼、今天有什麼待辦

Reflect 寫在了每個 Agent 的 CLAUDE.md。

定時任務

這塊老實說還不是很完美，但已經堪用。目前有幾種做法：

本機 cron + Claude CLI — 最直覺的方式。在 crontab 裡加一行，每天早上九點讓 Claude 跑 Morning Briefing。前提是電腦要開著。

# 每天早上 9 點跑 Morning Briefing
0 9 * * * cd /path/to/agent-os && claude -p "執行 Morning Briefing" >> /tmp/morning-briefing.log 2>&1

Session 內排程 — 在 Claude Code session 裡用 CronCreate 建臨時排程。方便測試，但僅限當前 session，最多活七天。

理想狀態是 Morning Briefing 每天自動跑，結果推到 Telegram。現在能做到，但偶爾會卡住或漏掉。等這塊更成熟再寫一篇分享。

跟 OpenClaw 的差別

	OpenClaw	AgentOS
安裝	裝 CLI + 設定環境	`git clone` 就好
Agent 執行	OpenClaw runtime	Claude Code 原生 Agent tool
記憶	OpenClaw 管理	檔案系統，可 git 追蹤
穩定性	最近更新容易壞	跟著 Claude Code 走
工具連接	內建連接器	MCP（預留擴充）
成本	依方案	Mac + Claude Pro/Max

不是說 OpenClaw 不好。它讓我理解了一個 Agent 系統該怎麼組織。但對我來說，能少一層就少一層。

怎麼用

git clone git@github.com:allen-hsu/agent-os.git
cd agent-os
claude

裝好 Claude Code，clone 下來，跑 claude。Chief 自動載入。

第一件事：改 CLAUDE.md 裡的 USER 區塊，換成你自己的資訊。然後試著丟一個任務給它，看它怎麼分派。

要加新 Agent 就在 agents/ 底下開資料夾，照 templates/new-agent.md 範本填就好。

如果你正在用龍蝦但覺得不太穩定，或者想自己搞但不知道結構怎麼組，可以拿這個當起點。改成你自己的東西就好。

GitHub

Threads