Skip to content

README.md

Latest commit

ย 

History

History
421 lines (342 loc) ยท 15.5 KB

README.md

File metadata and controls

421 lines (342 loc) ยท 15.5 KB

๐Ÿš€ OpenClaw QuickFix (v1.1.1)

License: MIT Platform CI Version

OpenClaw QuickFix ๆ˜ฏไธ€ๆฌพไธ“ไธบ OpenClaw ่ฎพ่ฎก็š„ๆ™บ่ƒฝ่พ…ๅŠฉไฟๆŠค็ณป็ปŸใ€‚ๅฎƒไฝœไธบๅฎ˜ๆ–น็›‘็ฎก็จ‹ๅบ๏ผˆSupervisor๏ผ‰ไน‹ไธŠ็š„"็ฌฌไบŒ้“ไฟ้™ฉ"๏ผŒ้€š่ฟ‡"ๆฃ€ๆต‹-ๅˆ†ๆž-ไฟฎๅค-้ชŒ่ฏ"็š„้—ญ็Žฏๆต็จ‹๏ผŒไธ“ๆณจไบŽ่งฃๅ†ณ้…็ฝฎๅ†ฒ็ชใ€้€ป่พ‘ๆญป้”ๅŠ AI ่ฟ่กŒๆ€ๅผ‚ๅธธ๏ผŒๅฎž็ŽฐๆœๅŠก็š„ๅ…จๅคฉๅ€™่‡ชๆ„ˆใ€‚

๐Ÿ“‹ ้กน็›ฎ็ฎ€ไป‹

็—›็‚น้—ฎ้ข˜

ๅœจ OpenClaw 2.x ็”Ÿๆ€ไธญ๏ผŒๅฎ˜ๆ–นๆไพ›ไบ†ๅผบๅคง็š„่ฟ›็จ‹ๅฎˆๆŠค๏ผŒไฝ†ไปฅไธ‹ๅœบๆ™ฏไป้œ€่ฆไบบๅทฅๅนฒ้ข„๏ผš

้—ฎ้ข˜็ฑปๅž‹ ๅ…ทไฝ“่กจ็Žฐ ไผ ็ปŸ่งฃๅ†ณๆ–นๆกˆ QuickFixๆ–นๆกˆ
้…็ฝฎ่ฏญไน‰้”™่ฏฏ JSONๆ ผๅผๆญฃ็กฎไฝ†ๅ‚ๆ•ฐๅทฒๅผƒ็”จ ไบบๅทฅๆŽ’ๆŸฅๆ–‡ๆกฃ ่‡ชๅŠจๆฏ”ๅฏนๅฎ˜ๆ–นๆ–‡ๆกฃไฟฎๅค
้™้ป˜ๅคฑๆ•ˆ ่ฟ›็จ‹ๅญ˜ๅœจไฝ†RPCๆ— ๅ“ๅบ” ๆ‰‹ๅŠจ้‡ๅฏๆœๅŠก ่‡ชๅŠจๆฃ€ๆต‹ๅนถ้‡ๅฏ
ๅคๆ‚ๆญป้” ้œ€่ฆAIๅˆ†ๆžๆ—ฅๅฟ— ไบบๅทฅๅˆ†ๆžๆ—ฅๅฟ— SmartFixๆ™บ่ƒฝไฟฎๅค

่งฃๅ†ณๆ–นๆกˆ

QuickFix ๆž„ๅปบไบ†ไธ‰ๅฑ‚้˜ฒๆŠคไฝ“็ณป๏ผš

  1. ้ข„้˜ฒๅฑ‚๏ผš้…็ฝฎ้ข„ๆฃ€ไธŽSchema้ชŒ่ฏ
  2. ไฟฎๅคๅฑ‚๏ผš่‡ชๅŠจไฟฎๅคๅทฒ็Ÿฅ้—ฎ้ข˜
  3. ๆ™บไฟฎๅฑ‚๏ผšAIไป‹ๅ…ฅๅค„็†ๅคๆ‚ๅœบๆ™ฏ

๐Ÿ—๏ธ ็ณป็ปŸๆžถๆž„

ๆ•ดไฝ“ๆžถๆž„ๅ›พ

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                     OpenClaw QuickFix                        โ”‚
โ”‚                      (ๆ™บ่ƒฝ่พ…ๅŠฉไฟๆŠค็ณป็ปŸ)                       โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                              โ”‚
        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
        โ–ผ                     โ–ผ                     โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   ๆฃ€ๆต‹ๅฑ‚      โ”‚    โ”‚   ไฟฎๅคๅฑ‚      โ”‚    โ”‚   ไบคไบ’ๅฑ‚      โ”‚
โ”‚  Detection   โ”‚โ”€โ”€โ”€โ–ถโ”‚    Repair    โ”‚โ”€โ”€โ”€โ–ถโ”‚    Visual    โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
        โ”‚                     โ”‚                     โ”‚
        โ–ผ                     โ–ผ                     โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                     ๆ ธๅฟƒๅŠŸ่ƒฝๆจกๅ—                              โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  ้…็ฝฎๆฃ€ๆต‹     โ”‚  ่‡ชๅŠจไฟฎๅค     โ”‚  ๅค‡ไปฝๆขๅค     โ”‚   SmartFix     โ”‚
โ”‚ Config Check โ”‚  Auto Repair โ”‚   Backup     โ”‚   AI Repair    โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                              โ”‚
                              โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                  OpenClaw Gateway Service                    โ”‚
โ”‚                    (่ขซไฟๆŠค็š„็›ฎๆ ‡ๆœๅŠก)                         โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

ๆจกๅ—่Œ่ดฃ

ๆจกๅ— ่Œ่ดฃ ๅฏนๅบ”่„šๆœฌ
ๆฃ€ๆต‹ๅฑ‚ RPCๅฅๅบทๆฃ€ๆŸฅใ€้…็ฝฎ้”™่ฏฏๆฃ€ๆต‹ใ€่ทฏๅพ„ๆŽขๆต‹ openclaw-quickfix.sh
ไฟฎๅคๅฑ‚ ่‡ชๅŠจไฟฎๅคๅทฒ็Ÿฅ้—ฎ้ข˜ใ€ๅค‡ไปฝ็ฎก็†ใ€ๆœๅŠก้‡ๅฏ openclaw-quickfix.sh
ๆ™บไฟฎๅฑ‚ AIไป‹ๅ…ฅๅˆ†ๆžๆ—ฅๅฟ—ใ€ๆ‰ง่กŒๅคๆ‚ไฟฎๅค openclaw-fix.sh
ไบคไบ’ๅฑ‚ ๅฏ่ง†ๅŒ–็ปˆ็ซฏใ€ๅˆ†ๅฑ็›‘ๆŽงใ€่ฟ›ๅบฆๅฑ•็คบ openclaw-terminal.sh

๐Ÿ”„ ๆ‰ง่กŒๆต็จ‹

ไธปๆต็จ‹ๅ›พ

                    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                    โ”‚  ๅฏๅŠจ QuickFix  โ”‚
                    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                             โ”‚
                             โ–ผ
                    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
              ๅคฑ่ดฅ  โ”‚ ๆฃ€ๆต‹OpenClaw่ทฏๅพ„ โ”‚  ๆˆๅŠŸ
           โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค                 โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
           โ”‚       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜       โ”‚
           โ–ผ                                   โ–ผ
    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”                   โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚   ๆŠฅ้”™้€€ๅ‡บ   โ”‚                   โ”‚  RPCๅฅๅบทๆฃ€ๆŸฅ    โ”‚
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜                   โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                               โ”‚
                          ๅผ‚ๅธธ                 โ”‚  ๆญฃๅธธ
                             โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
                             โ”‚                 โ”‚
                             โ–ผ                 โ–ผ
                    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                    โ”‚  ๅฐ่ฏ•้‡ๅฏๆœๅŠก   โ”‚ โ”‚  ้…็ฝฎ้”™่ฏฏๆฃ€ๆต‹   โ”‚
                    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                             โ”‚                   โ”‚
                             โ–ผ                   โ”‚
                    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”          โ”‚
              ๅฆ    โ”‚  ้‡ๅฏๆˆๅŠŸ?      โ”‚  ๆ˜ฏ      โ”‚
           โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค                 โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
           โ”‚       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
           โ–ผ
    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚  ่ฐƒ็”จSmartFix   โ”‚โ—€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”‚  ๆ— ้”™่ฏฏ         โ”‚
    โ”‚  (AIๆ™บ่ƒฝไฟฎๅค)   โ”‚          โ”‚  ่พ“ๅ‡บ็Šถๆ€ๆญฃๅธธ   โ”‚
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜          โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
             โ”‚
             โ–ผ
    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚ ๅฏๅŠจๅฏ่ง†ๅŒ–็ปˆ็ซฏ  โ”‚
    โ”‚ (iTerm2/tmux)   โ”‚
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
             โ”‚
             โ–ผ
    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚  AIๅˆ†ๆžๆ—ฅๅฟ—     โ”‚
    โ”‚  ๆ‰ง่กŒไฟฎๅคๅปบ่ฎฎ   โ”‚
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
             โ”‚
             โ–ผ
    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚   ไฟฎๅคๅฎŒๆˆ      โ”‚
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

ไฟฎๅคๆต็จ‹่ฏฆ่งฃ

Phase 1: ๆฃ€ๆต‹้˜ถๆฎต (Detection)

1. ็Žฏๅขƒๆฃ€ๆต‹
   โ”œโ”€โ”€ ๆ“ไฝœ็ณป็ปŸ่ฏ†ๅˆซ (macOS/Linux/Windows)
   โ”œโ”€โ”€ OpenClawๅฎ‰่ฃ…่ทฏๅพ„ๆŽขๆต‹
   โ””โ”€โ”€ ้…็ฝฎๆ–‡ไปถๅฎšไฝ

2. ๅฅๅบทๆฃ€ๆŸฅ
   โ”œโ”€โ”€ RPCๆŽฅๅฃๅ“ๅบ”ๆต‹่ฏ•
   โ””โ”€โ”€ ๆœๅŠก็Šถๆ€้ชŒ่ฏ

3. ้…็ฝฎๆฃ€ๆต‹
   โ”œโ”€โ”€ JSON่ฏญๆณ•ๆ ก้ชŒ
   โ”œโ”€โ”€ ๅผƒ็”จๅญ—ๆฎต่ฏ†ๅˆซ (heartbeat็ญ‰)
   โ””โ”€โ”€ ๅ‚ๆ•ฐๆœ‰ๆ•ˆๆ€ง้ชŒ่ฏ

Phase 2: ไฟฎๅค้˜ถๆฎต (Repair)

1. ๅค‡ไปฝๅˆ›ๅปบ
   โ””โ”€โ”€ ่‡ชๅŠจๅค‡ไปฝๅˆฐ ~/.openclaw/backups/

2. ่‡ชๅŠจไฟฎๅค
   โ”œโ”€โ”€ ็งป้™คๅผƒ็”จๅญ—ๆฎต
   โ”œโ”€โ”€ ไฟฎๆญฃ้…็ฝฎๆ ผๅผ
   โ””โ”€โ”€ ๆธ…็†ๆ— ๆ•ˆ้…็ฝฎ

3. ๆœๅŠก้‡ๅฏ
   โ”œโ”€โ”€ macOS: launchctl kickstart
   โ”œโ”€โ”€ Linux: systemctl restart
   โ””โ”€โ”€ ้ชŒ่ฏ้‡ๅฏ็ป“ๆžœ

Phase 3: ๆ™บไฟฎ้˜ถๆฎต (SmartFix)

1. ๅฏๅŠจๅฏ่ง†ๅŒ–็ปˆ็ซฏ (iTerm2/tmux)
   โ”œโ”€โ”€ ๅทฆไพง: ไธปไปปๅŠก็ช—ๅฃ
   โ”œโ”€โ”€ ๅณไธŠ: ๅฎžๆ—ถๆ—ฅๅฟ—็›‘ๆŽง
   โ””โ”€โ”€ ๅณไธ‹: ไฟฎๅค็ป“ๆžœๅฑ•็คบ

2. AIไป‹ๅ…ฅๅˆ†ๆž
   โ”œโ”€โ”€ ่ฏปๅ–OpenClawๆ—ฅๅฟ—
   โ”œโ”€โ”€ ๆฏ”ๅฏนๅฎ˜ๆ–นๆ–‡ๆกฃ
   โ””โ”€โ”€ ็”Ÿๆˆไฟฎๅคๆ–นๆกˆ

3. ๆ‰ง่กŒไฟฎๅค
   โ””โ”€โ”€ ไบบๅทฅ็กฎ่ฎคๅŽๆ‰ง่กŒไฟฎๅคๅปบ่ฎฎ

๐Ÿ“ ้กน็›ฎ็ป“ๆž„

openclaw-quickfix/
โ”œโ”€โ”€ ๐Ÿ“„ ๆ ธๅฟƒ่„šๆœฌ
โ”‚   โ”œโ”€โ”€ openclaw-quickfix.sh    # ไธป่„šๆœฌ๏ผšๆฃ€ๆต‹+่‡ชๅŠจไฟฎๅค
โ”‚   โ”œโ”€โ”€ openclaw-fix.sh         # SmartFix๏ผšAIๆ™บ่ƒฝไฟฎๅค
โ”‚   โ”œโ”€โ”€ openclaw-terminal.sh    # ็ปˆ็ซฏๅฏๅŠจๅ™จ๏ผšๅฏ่ง†ๅŒ–ๅˆ†ๅฑ
โ”‚   โ”œโ”€โ”€ install.sh              # ๅฎ‰่ฃ…่„šๆœฌ
โ”‚   โ”œโ”€โ”€ uninstall.sh            # ๅธ่ฝฝ่„šๆœฌ
โ”‚   โ””โ”€โ”€ setup.sh                # ไบคไบ’ๅผ้…็ฝฎๅ‘ๅฏผ
โ”‚
โ”œโ”€โ”€ ๐Ÿ“ ๅทฅไฝœๆต (.github/workflows/)
โ”‚   โ””โ”€โ”€ ci.yml                  # GitHub Actions CI/CD
โ”‚
โ”œโ”€โ”€ ๐Ÿ“ ๆ–‡ๆกฃ
โ”‚   โ”œโ”€โ”€ README.md               # ไธญๆ–‡ๆ–‡ๆกฃ (ๆœฌๆ–‡ไปถ)
โ”‚   โ”œโ”€โ”€ README_EN.md            # ่‹ฑๆ–‡ๆ–‡ๆกฃ
โ”‚   โ”œโ”€โ”€ CHANGELOG.md            # ๅ˜ๆ›ดๆ—ฅๅฟ—
โ”‚   โ”œโ”€โ”€ FAQ.md                  # ๅธธ่ง้—ฎ้ข˜
โ”‚   โ””โ”€โ”€ LICENSE                 # MIT่ฎธๅฏ่ฏ
โ”‚
โ”œโ”€โ”€ ๐Ÿ“ ๅ›ฝ้™…ๅŒ– (locales/)
โ”‚   โ”œโ”€โ”€ zh_CN.sh                # ็ฎ€ไฝ“ไธญๆ–‡
โ”‚   โ””โ”€โ”€ en_US.sh                # ่‹ฑๆ–‡
โ”‚
โ”œโ”€โ”€ ๐Ÿ“ ๅบ“ๆ–‡ไปถ (lib/)
โ”‚   โ””โ”€โ”€ logging.sh              # ๅขžๅผบๆ—ฅๅฟ—็ณป็ปŸ
โ”‚
โ”œโ”€โ”€ ๐Ÿ“ ๆต‹่ฏ• (tests/)
โ”‚   โ””โ”€โ”€ run_tests.sh            # ๅฎŒๆ•ดๆต‹่ฏ•ๅฅ—ไปถ
โ”‚
โ””โ”€โ”€ ๐Ÿ“ ็คบไพ‹ (examples/)
    โ””โ”€โ”€ *.sh                    # ไฝฟ็”จ็คบไพ‹

๐ŸŒŸ ๆ ธๅฟƒ็‰นๆ€ง

1. ไธ‰ๅฑ‚้˜ฒๆŠคไฝ“็ณป

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  Layer 3: SmartFix (AIๆ™บ่ƒฝไฟฎๅคๅฑ‚)        โ”‚
โ”‚  - ๅคๆ‚้—ฎ้ข˜AIๅˆ†ๆž                        โ”‚
โ”‚  - ๅฎ˜ๆ–นๆ–‡ๆกฃ่‡ชๅŠจๆฏ”ๅฏน                      โ”‚
โ”‚  - ๅฏ่ง†ๅŒ–ไบคไบ’ไฟฎๅค                        โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                    โ–ฒ
        ่‡ชๅŠจไฟฎๅคๅคฑ่ดฅ โ”‚
                    โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  Layer 2: Auto Repair (่‡ชๅŠจไฟฎๅคๅฑ‚)       โ”‚
โ”‚  - 4็ฑปๅธธ่ง้—ฎ้ข˜่‡ชๅŠจไฟฎๅค                    โ”‚
โ”‚  - ๅŽŸๅญ็บงๅค‡ไปฝไธŽๅ›žๆปš                       โ”‚
โ”‚  - ๆœๅŠก่‡ชๅŠจ้‡ๅฏ                          โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                    โ–ฒ
        ๅ‘็Žฐ้…็ฝฎ้—ฎ้ข˜ โ”‚
                    โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  Layer 1: Detection (ๆฃ€ๆต‹ๅฑ‚)             โ”‚
โ”‚  - RPCๅฅๅบทๆฃ€ๆŸฅ                           โ”‚
โ”‚  - ้…็ฝฎ้”™่ฏฏๆฃ€ๆต‹                          โ”‚
โ”‚  - ่ทฏๅพ„่‡ชๅŠจๆŽขๆต‹                          โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

2. ่ทจๅนณๅฐๆทฑๅบฆ้€‚้…

ๅนณๅฐ ่ฟ›็จ‹็ฎก็† ็ปˆ็ซฏๅทฅๅ…ท ็‰น่‰ฒๅŠŸ่ƒฝ
macOS LaunchAgent iTerm2 ๅŽŸ็”Ÿๅˆ†ๅฑใ€AppleScript
Linux Systemd tmux ไผš่ฏไฟๆŒใ€่ฟœ็จ‹ๆ”ฏๆŒ
Windows NSSM/Service Git Bash WSLๅ…ผๅฎน

3. ๅŽŸๅญ็บง่‡ชๆ„ˆ

็”จๆˆท่ฐƒ็”จQuickFix
      โ”‚
      โ–ผ
ๅˆ›ๅปบๅค‡ไปฝ โ—€โ”€โ”€โ”€โ”€โ”€โ”€โ”
      โ”‚        โ”‚
      โ–ผ        โ”‚
ๆ‰ง่กŒไฟฎๆ”น       โ”‚
      โ”‚        โ”‚
      โ–ผ        โ”‚
ไฟฎๅคๆˆๅŠŸ?      โ”‚
   ๆ˜ฏ/ๅฆ       โ”‚
    โ”‚          โ”‚
    โ”œโ”€ ๆ˜ฏ โ”€โ”€โ”€โ–ถ ๅฎŒๆˆ
    โ”‚
    โ””โ”€ ๅฆ โ”€โ”€โ”€โ–ถ ๆขๅคๅค‡ไปฝ
                  โ”‚
                  โ–ผ
               ่ฟ”ๅ›ž้”™่ฏฏ

๐Ÿ› ๏ธ ๅฎ‰่ฃ…ๆŒ‡ๅ—

ๅฟซ้€Ÿๅฎ‰่ฃ… (ๆŽจ่ โญ)

curl -fsSL https://raw.githubusercontent.com/ai-gongxueshe/openclaw-quickfix/main/install.sh | bash

ไบคไบ’ๅผๅฎ‰่ฃ… (ๆŽจ่้ฆ–ๆฌกไฝฟ็”จ)

bash setup.sh

ๅ‘ๅฏผไผšๅผ•ๅฏผๆ‚จๅฎŒๆˆ๏ผš็Žฏๅขƒๆฃ€ๆŸฅ โ†’ ๅฎ‰่ฃ…ๆจกๅผ้€‰ๆ‹ฉ โ†’ ๅŠŸ่ƒฝ้…็ฝฎ โ†’ ่‡ชๅŠจๅฎ‰่ฃ…

็ฆป็บฟ/ๆœฌๅœฐๅฎ‰่ฃ…

git clone https://github.com/luomeng119/openclaw-quickfix.git
cd openclaw-quickfix
OFFLINE_MODE=true bash install.sh

๐Ÿ“– ไฝฟ็”จๆ–นๆณ•

ๆ ‡ๅ‡†ๆฃ€ๆต‹ไธŽไฟฎๅค

openclaw-quickfix

ๅฎŒๆ•ดๆ‰ง่กŒ๏ผšๆฃ€ๆต‹ โ†’ ไฟฎๅค โ†’ ้‡ๅฏ

ๅฎ‰ๅ…จๆฃ€ๆต‹ๆจกๅผ (ไป…ๆŠฅๅ‘Šไธไฟฎๆ”น)

openclaw-quickfix --dry-run

้€‚็”จไบŽ๏ผš็”Ÿไบง็Žฏๅขƒ้ข„ๆฃ€ใ€้—ฎ้ข˜่ฏŠๆ–ญ

ไฝฟ็”จ็คบไพ‹

# ๅœบๆ™ฏ1: ๆ—ฅๅธธ็ปดๆŠค
$ openclaw-quickfix
๐Ÿ”ง OpenClaw ๆ™บ่ƒฝไฟฎๅค v1.1.1
[INFO] RPCๆŽฅๅฃๅ“ๅบ”ๆญฃๅธธ
[INFO] ๅ‘็Žฐ้…็ฝฎ้—ฎ้ข˜: agents.list[0].heartbeat (ๅทฒๅผƒ็”จ)
[FIX] ๅทฒ็งป้™คๅผƒ็”จๅญ—ๆฎต
[INFO] ้‡ๅฏๆœๅŠกๆˆๅŠŸ
โœ… ไฟฎๅคๅฎŒๆˆ!

# ๅœบๆ™ฏ2: ๅฎ‰ๅ…จๆฃ€ๆต‹
$ openclaw-quickfix --dry-run
๐Ÿ”ง OpenClaw ๆ™บ่ƒฝไฟฎๅค v1.1.1 (ๅฎ‰ๅ…จๆจกๅผ)
[WARN] ๅ‘็Žฐ1ไธช้—ฎ้ข˜:
  - agents.list[0].heartbeat: ่ฏฅๅญ—ๆฎตๅทฒๅผƒ็”จ
[INFO] dry-runๆจกๅผ๏ผŒๆœชๆ‰ง่กŒไฟฎๅค

๐Ÿงช ๆต‹่ฏ•

cd tests
bash run_tests.sh

ๆต‹่ฏ•่ฆ†็›–:

  • โœ… OSๆฃ€ๆต‹ๆต‹่ฏ•
  • โœ… ่ฏญๆณ•ๆฃ€ๆŸฅๆต‹่ฏ•
  • โœ… ๅ‡ฝๆ•ฐๅฎšไน‰ๆต‹่ฏ•
  • โœ… ้…็ฝฎๆฃ€ๆต‹ๆต‹่ฏ•
  • โœ… ๅค‡ไปฝๆœบๅˆถๆต‹่ฏ•
  • โœ… ่ทจๅนณๅฐๅ…ผๅฎนๆ€งๆต‹่ฏ•
  • โœ… ้”™่ฏฏๅค„็†ๆต‹่ฏ•
  • โœ… ๆ–‡ไปถๆƒ้™ๆต‹่ฏ•
  • โœ… ๆ–‡ๆกฃๅฎŒๆ•ดๆ€งๆต‹่ฏ•

โš ๏ธ ้‡่ฆ่ฏดๆ˜Ž

ไธŽๅฎ˜ๆ–น้…็ฝฎๅฏน้ฝ

ๆœฌๅทฅๅ…ทๆ˜ฏ่พ…ๅŠฉ่„šๆœฌ๏ผŒๅœจไฝฟ็”จๅ‰่ฏท็กฎไฟๆ‚จๅทฒๅ‚่€ƒไปฅไธ‹ๅฎ˜ๆ–นๆ–‡ๆกฃๅฎŒๆˆไบ†ๅŸบ็ก€็š„"24h ๅฎˆๆŠค"้…็ฝฎ๏ผš

ๅนณๅฐ ๅฎ˜ๆ–นๆ–‡ๆกฃ ๅ…ณ้”ฎ้…็ฝฎ
macOS docs/zh-CN/gateway/launchd.md LaunchAgent plist
Linux docs/zh-CN/gateway/systemd.md Systemd service
Windows docs/zh-CN/gateway/windows-service.md Windows Service

ไฝฟ็”จๅปบ่ฎฎ

  1. ้ฆ–ๆฌกไฝฟ็”จ: ๅปบ่ฎฎๅ…ˆไฝฟ็”จ --dry-run ๆจกๅผๆŸฅ็œ‹้—ฎ้ข˜
  2. ็”Ÿไบง็Žฏๅขƒ: ็กฎไฟๅค‡ไปฝ็ญ–็•ฅๅทฒ้…็ฝฎ
  3. SmartFix: ้œ€่ฆๅฎ‰่ฃ… Claude Code CLI

๐Ÿ“„ ็›ธๅ…ณๆ–‡ๆกฃ

๐Ÿค ่ดก็Œฎ

ๆฌข่ฟŽๆไบค Issue ๅ’Œ Pull Request๏ผ

๐Ÿ“œ ่ฎธๅฏ่ฏ

MIT License

"็กฎๅฎšๆ€ง่ฝฏไปถๅทฅ็จ‹๏ผŒ่ฎฉ AI ๆœๅŠกๆฐธไธๅฎ•ๆœบใ€‚"

Made with โค๏ธ by ๆกฃๆกˆAIๅ…ฑๅญฆ็คพ

๐Ÿ™ ่‡ด่ฐข

ๆœฌ้กน็›ฎ็ตๆ„ŸๆฅๆบไบŽ win4r/openclaw-min-bundle๏ผŒๆ„Ÿ่ฐขๅŽŸไฝœ่€…็š„ๅ‡บ่‰ฒๅทฅไฝœๅ’ŒๅฏนOpenClaw็”Ÿๆ€็š„่ดก็Œฎใ€‚

็‰นๅˆซๆ„Ÿ่ฐข๏ผš

  • win4r - ๅŽŸ้กน็›ฎไฝœ่€…๏ผŒๆไพ›ไบ†ๆ ธๅฟƒๆ€่ทฏๅ’ŒๆŠ€ๆœฏๅŸบ็ก€
  • OpenClaw็คพๅŒบ - ๆไพ›ไบ†ไธฐๅฏŒ็š„ๆ–‡ๆกฃๅ’Œๆœ€ไฝณๅฎž่ทต
  • Claude Codeๅ›ข้˜Ÿ - ๆไพ›ไบ†ๅผบๅคง็š„AI่พ…ๅŠฉๅผ€ๅ‘ๅทฅๅ…ท

Made with โค๏ธ by ๆกฃๆกˆAIๅ…ฑๅญฆ็คพ