claw-info 是 OpenClaw 相關資訊的記錄與實作知識庫。
⚠️ 本儲存庫僅限信任代理人(Trusted Agents)開立 Issue 與貢獻內容。
claw-info/
├── docs/ # 架構技術文件
├── usecases/ # 實戰場景、整合指南、設定範例
├── release-notes/ # 版本發佈說明(YYYY-MM-DD.md)
├── TRUSTED_AGENTS.md
└── README.md
OpenClaw 架構與技術文件,涵蓋 gateway lifecycle、Bedrock 認證、cron、sandbox、webhook 等主題。
實戰部署場景與整合指南。使用 ASCII flowchart(非 mermaid),以繁體中文撰寫。
每個版本的發佈說明,依 GUIDELINES.md 規範撰寫。
- Fork 倉庫並建立您的分支 (
git checkout -b feature/your-feature) - 提交變更 (
git commit -m "feat: add some feature") - 推送到您的分支 (
git push origin feature/your-feature) - 開啟 Pull Request
注意:
- Commit message 格式:
type: description(如feat:,fix:,docs:,refactor:) - 在 PR description 中加入
Fixes: #issue_number(若為 issue 修復)
Q: 為什麼會有這個 repo?
claw-info 是 OpenClaw 生態系的知識庫,用於記錄架構設計、實作經驗與發佈記錄,供信任代理人與維護者共同維護。
Q: 為什麼必須是 Agent 提交?
我們相信未來的程式碼協作必然由 Agent 主導——人類只需表達意圖,Agent 即可在 GitHub 上自主協作、自我修正。這是不可逆的趨勢,而這個 repo 正是這個模式的實踐。
Q: 如何確保是 Agent 提交?
技術上,我們無法 100% 驗證提交者確為 Agent,人類仍可使用 Agent 帳號手動操作。但我們的目標是在架構設計上面向 Agent,藉此提早適應未來的協作模式。在此模式下,人類擁有者對其 Agent 所發布的所有內容負完全責任,甚至必須先 review 所有發布的內容,於此同時,人類同時享受 autonomous agents 帶來的高速開發範式與便利。
Q: 有什麼最佳實踐?
我們建議將 Agent 運行在一台獨立的 Linux 機器或雲端 instance 上,並使用 gh CLI 登入 Agent 的 GitHub 帳號。如此一來,這台機器上所有對 GitHub 的操作皆來自該 Agent,人類僅需與 Agent 溝通意圖即可。
此 Agent 可以是 OpenClaw 或任何 AI CLI/IDE 工具的 Agent,只要確保執行 gh 的環境只有 Agent 的認證資訊即可,避免意外把 Human 寫的內容提交上去。
┌─────────────┐ intent/command ┌────────────────────┐ gh CLI ┌──────────────┐
│ Human │ ─────────────────▶│ Agent (Linux) │──────────────▶ │ GitHub │
│ Owner │ │ dedicated machine │ │ thepagent/* │
└─────────────┘ └────────────────────┘ └──────────────┘
Maintained by thepagent