HexClaw ئارخىتېكتۇرا تەپسىلاتى: بىر كىشى + Claude + 5 ئاي، Go بىلەن نۆلدىن قۇرۇلغان ئالتە ئامبارلىق پۈتۈن قاتلاملىق ئوچۇق كودلۇق AI Agent ئېكولوگىيەسى

ئۆتكەن يىلى ئۆزۈمگە بىر AI Agent ئورۇنلاشتۇرماقچى بولدۇم.

بازاردا AI Agent مەھسۇلاتلىرى ئاز ئەمەس، چوڭ شىركەتلەرمۇ ئارقا-ئارقىدىن كىرىشتى. لېكىن ئايلاندۇرۇپ باقسام، يەنىلا مۇشۇ مەسىلىلەر:

• ئوچۇق كودلۇقلىرى بىخەتەر ئەمەس — OpenClaw (قىسقۇچپاقا) نىڭ ئىقتىدارى ئەڭ تولۇق، جامائەتچىلىكى ئەڭ چوڭ؛ لېكىن بىخەتەرلىك جەھەتتە ئاساسەن قوغدىنىشسىز، تەننەرخ كونترولىمۇ يوق، ئىشلەپچىقىرىش مۇھىتىغا قويۇشقا جۈرئەت قىلالمايمەن
• بىخەتەرلىرى ئوچۇق كودلۇق ئەمەس — سودا مەھسۇلاتلىرى قائىدىگە ئۇيغۇنلۇقنى ياخشى قىلغان، لېكىن يېپىق كودلۇق، بۇلۇتتا ساقلىنىدۇ، سانلىق مەلۇماتنىڭ چېگرادىن چىقىشىنى كونترول قىلغىلى بولمايدۇ، ئايلىق ھەقمۇ ئەرزان ئەمەس
• ئىشلىتىشكە بولىدىغانلىرى جۇڭگو سۇپىلىرىنى قوللىمايدۇ — Feishu، DingTalk، WeCom، WeChat ئاممىۋى ھېساباتى؛ چەت ئەل مەھسۇلاتلىرى ئاساسەن قاپلىمايدۇ

ماڭا لازىم بولغىنى: ئوچۇق كودلۇق مەھسۇلاتنىڭ ئىقتىدار كەڭلىكى + سودا مەھسۇلاتىنىڭ بىخەتەرلىك دەرىجىسى + جۇڭگو سۇپىلىرىنى تولۇق قاپلاش، شۇنىڭ بىلەن بىرگە ئۆزى باشقۇرۇپ ئورۇنلاشتۇرۇش ۋە يەككە binary بىلەن ئىجرا قىلىش. ئىزدەپ تاپالمىغاچقا، ئۆزۈم ياسىدىم. بىر كىشى + Claude بىلەن جۈپ ئىجادىيەت، ئالتە ئامبار، پۈتۈن قاتلاملىق AI Agent. بۇ دەل HexClaw (دەريا قىسقۇچپاقىسى)。

بۇ ماقالىدە تولۇق ئارخىتېكتۇرىنى ئاچىمەن: تېخنىكىلىق قارارلار، ئىجرا تەپسىلاتى ۋە يولۇققان ئورەكلەرنى ئاشكارا سۆزلەيمەن.

باشلاشتىن ئىلگىرى بىر نەچچە ئۇقۇمنى توغرىلايلى (ئاللىبۇرۇن پىششىق بولسىڭىز ئاتلاپ ئۆتسىڭىز بولىدۇ):

LLM = ھەممە كىتابنى ئوقۇغان تالانتلىق ئۇنىۋېرسىتېت ئوقۇغۇچىسى؛ ھەممىنى بىلىدۇ، لېكىن بىلىمىنىڭ ۋاقتى بار، ئاندا-ساندا توقۇيدۇ (خام خىياللىق جاۋاب)RAG = بۇ ئوقۇغۇچىغا پايدىلىنىش خاتىرىسى بېرىپ، قۇرۇق توقۇش ئورنىغا مەنبەگە تاياندۇرۇشMCP = ھەممىباب USB ماسلاشتۇرغۇچ؛ مېڭە بىلەن ھەر خىل قورالنى چېتىپلا ئىشلىتىشكە بولىدۇAgent = كۆپ ئىقتىدارلىق ئىشچى؛ ئۆزى پىلانلايدۇ، قورال چاقىرىدۇ، نەتىجە تاپشۇرىدۇSkills = ئىشچىنىڭ كەسپىي ماھارەت گۇۋاھنامىسى، ئېھتىياج بويىچە يۈكلىنىدۇ Agent گۇرۇپپىسى = بىر گۇرۇپپا ئىشچىدىن تۈزۈلگەن، ئىش تەقسىملىشىپ ھەمكارلىشىدىغان كوللېكتىپ

HexClaw قىلىدىغان ئىش، بۇ ئۇقۇملارنى قۇرۇلۇش ئارقىلىق ئەمەلىيلەشتۈرۈپ، ئىجرا بولىدىغان سىستېمىغا ئايلاندۇرۇش。

مۇھىم سانلار

تولۇق كۆرۈنۈش: ئالتە ئامبار، بەش قاتلاملىق ئارخىتېكتۇرا

                    hexclaw-desktop (Tauri desktop)
                    hexagon-ui (observability)
                          │
                    ┌─────▼─────┐
                    │  hexclaw   │  Application: adapters, gateway, Skill, API
                    └─────┬─────┘
                          │
                    ┌─────▼─────┐
                    │  hexagon  │  AI Agent engine: ReAct, Workflow,
                    │           │  Plugin, A2A, Graph, Compose
                    └──┬─────┬──┘
                       │     │
                 ┌─────▼──┐  │
                 │ai-core │  │  AI foundation: LLM Provider,
                 │        │  │  Embedding, Function Calling
                 └────┬───┘  │
                      │      │
                 ┌────▼──────▼┐
                 │  toolkit   │  Shared foundation (all Go modules depend on it)
                 └────────────┘

ئالتە ئامبارنىڭ تايىنىش يۆنىلىشى تۆۋەندىن يۇقىرىغا قاتتىق بىر يۆنىلىشلىك؛ تەتۈر تايىنىش ۋە قاتلام ئاتلاپ چاقىرىشقا بولمايدۇ. پۈتۈن ئېكولوگىيەنىڭ قايتا ئىشلىتىلىشى، كېڭىيىشى ۋە مۇستەقىل تەرەققىي قىلىشىنىڭ ئاساسى مۇشۇ:

• toolkit / ai-core نى ھەر قانداق Go تۈرى قوللانسا بولىدۇ، HexClaw غا باغلانمىغان
• hexagon ئومۇمىي AI Agent ماتورى سۈپىتىدە hexclaw دىن ئايرىم ئىشلىتىلىپ، پۈتۈنلەي باشقا Agent ئەپلىرىنى قۇرالايدۇ
• hexclaw بولسا AI Agent ئەپىنىڭ ئارقا تەرىپى؛ پەقەت ئەپ قاتلىمىدىكى تەشكىللەشنى قىلىدۇ، يېڭى ئىقتىدارنى شۇ جايدا يېزىش ئەمەس، ماس قاتلامغا چۈشۈرىدۇ

نېمىشقا Go، نېمىشقا ئۆزىمىزنىڭ رامكىسى؟

ئىككى سوئالغا بىللە جاۋاب بېرىمەن.

تىل تاللاش: Agent نىڭ توسالغۇسى I/O — LLM جاۋابىنى، قورال ئىجراسىنى، 13 سۇپىنىڭ Webhook ىنى كۈتۈش. goroutine، Python asyncio دىن بىر دەرىجە ئۈنۈملۈك، GIL مۇ يوق. ئورۇنلاشتۇرۇشتا، hexclaw serve بىر بۇيرۇق بىلەن ئىجرا قىلىنىدۇ، مەۋھۇم مۇھىت بىلەن ئاۋارە بولۇش كېرەك ئەمەس.

رامكا تاللاش: Python تەرەپتە LangChain/LangGraph (ئېكولوگىيەسى ئەڭ چوڭ، لېكىن GIL چەكلىمىسى بار)، CrewAI (باشلاش تېز، لېكىن تەشكىللەش ئاجىزراق) نى باھالىدىم؛ Go تەرەپتە Eino (ByteDance مەھسۇلاتى، لېكىن بىخەتەرلىك مودۇلى كەم) نى كۆردۈم. ئاخىرى ئۆزۈم قۇردۇم، چۈنكى Go ئەسلىي + كارخانا دەرىجىلىك بىخەتەرلىك + تولۇق RAG + ئىشلەپچىقىرىش دەرىجىلىك كۆزىتىش دېگەن بىرلەشمە تەييار نەرسە يوق ئىدى.

Hexagon «ئالتە تەرەپلىك جەڭچى»دىن نام ئالغان؛ ئالتە ئۆلچەمنىڭ تەڭپۇڭ تەرەققىياتىغا ئەھمىيەت بېرىدۇ: ئىشلىتىش قولايلىقى، ئۈنۈم، كېڭەيتىش، تەشكىللەش، كۆزىتىش، بىخەتەرلىك.

              Hexagon AI Agent Framework Architecture
              ========================================

  ┌─ Application Layer ────────────────────────────────────────┐
  │  ChatBot    RAG Agent    Workflow    Multi-Agent    Custom  │
  ├─ Orchestration Layer ──────────────────────────────────────┤
  │  Router   Planner   Scheduler   Executor   Graph   State   │
  ├─ Agent Core Layer ─────────────────────────────────────────┤
  │  Agent   Role   Team   Network   Handoff   Context   Msg   │
  ├─ Capability Layer ─────────────────────────────────────────┤
  │  LLM Provider    RAG Engine    Tool System    Memory    KB │
  │  (ai-core)                     (ai-core)      (ai-core)   │
  ├─ Infrastructure Layer ─────────────────────────────────────┤
  │  Tracer    Logger    Metrics    Config    Security   Plugin │
  ├─ Foundation Layer ─────────────────────────────────────────┤
  │  toolkit (lang | crypto | net | cache | util | collection) │
  └────────────────────────────────────────────────────────────┘

3 قۇر كود بىلەن باشلاش، ئېلان قىلىش شەكلىدىكى سەپلىمە بىلەن ئىلگىرىلەش، گراف تەشكىللەش بىلەن مۇرەككەپ سىنارىيەنى باشقۇرۇش:

response, _ := hexagon.Chat(ctx, "What is Go?")         // 最简入门

agent := hexagon.QuickStart(                              // 带工具
    hexagon.WithTools(calculator),
    hexagon.WithSystemPrompt("你是一个数学助手"),
)

team := hexagon.NewTeam("research-team",                  // 多 Agent 团队
    hexagon.WithAgents(researcher, writer, reviewer),
    hexagon.WithMode(hexagon.TeamModeSequential),
)

Runnable[I,O]: بىر كۆرۈنمە يۈز ھەممىنى بىرلەشتۈرىدۇ

Python LangChain دا Agent، Tool، Chain، Retriever ئوخشىمىغان ئابستراكسىيەلەر؛ بىرلەشتۈرۈش ئۈچۈن ئۇلىغۇچى كود لازىم. Hexagon تېخىمۇ بىۋاسىتە يول تاللايدۇ: بارلىق بۆلەكلەر ئوخشاش گېنېرېك كۆرۈنمە يۈزنى ئەمەلىيلەشتۈرىدۇ، 6 خىل ئىجرا پارادىگمىسى بار (Invoke / Stream / Batch / Collect / Transform / BatchStream).

pipeline := core.Compose(tokenizer, model)    // 自由组合
adapted := core.InvokeToStream(r)              // 自动获得流式能力
fastest := core.Race(future1, future2)         // 竞速取最快

Agent باشقا بىر Agent نىڭ قورالى بولالايدۇ، RAG تۇرۇبا يولى گراف تەشكىللەش تۈگۈنىگە كىرەلەيدۇ؛ چۈنكى ئۇلار ئوخشاش كۆرۈنمە يۈزنى ئىشلىتىدۇ.

ئاساسلىق رامكىلار بىلەن سېلىشتۇرۇش:

يادرولۇق پەرق بىخەتەرلىك ئۆلچىمىدە. Eino دا كۆرسەتمە قىستۇرۇشنى بايقاش، PII نى يوشۇرۇش، RBAC ۋە تەننەرخ كونترول پۈتۈنلەي بوش. دېمەك، Eino بىلەن ئىشلەتكۈچىگە يۈزلەنگەن Agent قۇرسىڭىز، بۇ ئىقتىدارلارنى نۆلدىن ئۆزىڭىز قۇرۇشىڭىز كېرەك. Hexagon ئۇلارنى رامكىنىڭ ئىچكى ئىقتىدارى قىلغان، قاچىلاپلا بار.

بىر جۈملە بىلەن: LangChain نىڭ كۆرۈنمە يۈز پىكرى + LangGraph نىڭ تەشكىللەش ئىقتىدارى + كارخانا دەرىجىلىك بىخەتەرلىك قاتلىمى، Go بىلەن قايتا يېزىلغان. سېزىش قاتلىمى (Agent) → ئىجرا قاتلىمى (Skills + MCP) → بىلىم قاتلىمى (RAG + LLM + Memory) نىڭ ئۈچىمۇ ئىچىگە قوشۇلغان.

ئون خىل Agent + كۆپ Agent ھەمكارلىقى

Agent ئاددىيدىن مۇرەككەپكە تۆت باسقۇچتا تەرەققىي قىلىدۇ؛ Hexagon، 10 خىل Agent ۋە ھەمكارلىق كېلىشىمى بىلەن ھەممىسىنى قاپلايدۇ:

ئىچكى-سىرتقى قەۋەت قىلىش تەبىئىي قوللىنىدۇ: Supervisor نىڭ ئىشچىسى ReActAgent بولالايدۇ، ReActAgent قورالى PlanExecuteAgent نى قوزغىتالايدۇ.

ھەمكارلىق قاتلىمىدا: Team (4 ھالەت) / Handoff (Swarm ئۇسلۇبىدىكى ئالماشتۇرۇش) / Network (Mesh/Hub/Ring/Tree توپولوگىيەسى) / Consensus (بېلەت تاشلاپ قارار قىلىش) / Registry (مۇلازىمەت بايقاش + يۈك تەڭپۇڭلاشتۇرۇش) / A2A (Google نىڭ Agent-to-Agent كېلىشىمى، Go ئېكولوگىيەسىدە ئاز ئۇچرايدۇ). تۆت قاتلاملىق ھالەت باشقۇرۇش + Snapshot/Restore.

گراف تەشكىللەش ماتورى

g, _ := graph.NewGraph[MyState]("support").
    AddNode("classify", classifyIntent).
    AddNode("faq", handleFAQ).
    AddConditionalEdge("classify", routerFn, routeMap).
    SetEntryPoint("classify").Build()

شەرتلىك يوللاش · پاراللېل ئىجرا · تەكشۈرۈش نۇقتىسىنى داۋاملىق ساقلاش · Human-in-the-Loop · ۋاقىت ساياھىتى · تارماق گراف ئىچكى قەۋىتى · Pregel BSP · دەۋرىيلىنىش + توسۇق. يەنە زەنجىرسىمان تەشكىللەش، خىزمەت ئېقىمى ماتورى، بەلگىلىك جەريان (Process، ھالەت ماشىنىسى يېتەكلەيدۇ) بار.

  User ──→ Agent ──→ LLM ──→ Tool ──→ Result
              │
              ├──→ Memory (memory access)
              └──→ RAG (knowledge retrieval)

RAG تۇرۇبا يولى: 7 ئالماشتۇرغىلى بولىدىغان باسقۇچ

ھۆججەت → Loader → Splitter → Embedder → Indexer → Retriever → Reranker → Synthesizer

ۋېكتور ساقلاشنىڭ 8 ئارقا تەرىپى: Qdrant / FAISS / PgVector / Redis / Milvus / Chroma / Pinecone / Weaviate.

بىخەتەرلىك سىستېمىسى + كۆزىتىش

Hook سىستېمىسى Run / Tool / LLM / Retriever / Stream دىن ئىبارەت بەش خىل ھادىسىنى قاپلايدۇ؛ bitmask ئارقىلىق ياخشىلاش قۇرۇق چاقىرىشتىن ساقلايدۇ. hexclaw نىڭ خامچوت كونترول، قورال تەستىقى ۋە ئاپتوماتىك ئەستە ساقلاش ئايرىشى ھەممىسى Hook ئارقىلىق ئەمەلىيلەشكەن، رامكا يادروسىغا كىرىپ ئۆزگەرتىلمىگەن.

ئۈنۈم + تېخىمۇ كۆپ ئىقتىدار

يەنە: OS دەرىجىلىك sandbox · رېئاكسىيەلىك ئېقىم بىر تەرەپ قىلىش ماتورى · 7 خىل ئەستە ساقلاش ئەمەلىيلەشتۈرۈشى · MCP Client+Server · ئەقلىي ھۆججەت خىزمەت ئېقىمى (ADW) · بەلگىلىك جەريان (Process).

ئەپ قاتلىمى تەشكىللەيدۇ، رامكا قاتلىمى ئەمەلىيلەشتۈرىدۇ. hexclaw، Agent پىكىر يۈرگۈزۈشنى يازمايدۇ، Hexagon نىڭكىنى قۇراشتۇرىدۇ؛ بىخەتەرلىك تەكشۈرۈشىنى يازمايدۇ، Guard Chain نى تەشكىللەيدۇ؛ RAG نى يازمايدۇ، RAG Engine نى سەپلەيدۇ.

hexclaw: hexagon ماتور بولسا، hexclaw پۈتۈن ماشىنا

[سۈرەت: HexClaw ئەپىنىڭ ئالتە قاتلاملىق ئارخىتېكتۇرىسى]

                    HexClaw Application Architecture
                    ================================

  ┌─ Platform Adapter ──────────────────────────────────────────────┐
  │  Web  Feishu  Telegram  DingTalk  Discord  Slack  WeCom  WeChat  │
  │  WhatsApp  LINE  Matrix  Email  REST API          (13 total)    │
  ├─ Security Gateway (6-Layer Pipeline) ───────────────────────────┤
  │  Auth → RateLimit → CostCheck → InputSafety → Permission → Audit│
  ├─ Agent Engine ──────────────────────────────────────────────────┤
  │  ReAct Loop        3D Budget Control     Tool Executor + Hooks  │
  │  Session Manager   Context Compaction    Multi-Agent Router     │
  │  Two-Pass Stream   Tool Approval Gate    Auto Memory Extract    │
  ├─ Capability Layer ──────────────────────────────────────────────┤
  │  Skill System       Knowledge (RAG)      LLM Router             │
  │  (Builtin+Mkt+MCP)  (FTS5+Vector+MMR)   (Cost/Quality/Latency) │
  │  Memory (4-Layer)   Semantic Cache (Singleflight+LRU+TTL)      │
  ├─ Infrastructure ────────────────────────────────────────────────┤
  │  OS Sandbox          MCP Client         Cron + Webhook          │
  │  (Seatbelt/NS/Win)  (stdio/SSE/HTTP)   REST API (71 endpoints) │
  │  Canvas (8 components) Voice (STT/TTS) WebSocket live stream    │
  ├─ Storage & Config ──────────────────────────────────────────────┤
  │  SQLite (WAL)   FTS5 full-text search YAML+ENV Audit JSONL .md │
  └─────────────────────────────────────────────────────────────────┘
            Powered by: Hexagon ← ai-core ← toolkit

يادرولۇق سانلىق مەلۇمات ئېقىمى

User message (Feishu/Telegram/Discord/WeChat/...)
  → Platform adapter → Security gateway (6 layers) → Session router
  → Agent engine (ReAct)
      ├─ Fast path: Skill.Match() → milliseconds, zero LLM usage
      └─ Main path: ReAct loop → Sandbox execution → Sync/stream response

ئالتە قاتلاملىق بىخەتەرلىك دەرۋازىسى

Request → [Auth] → [RateLimit] → [CostCheck] → [InputSafety] → [Permission] → [Audit] → Engine

3- ۋە 4-قاتلامدا خاتالىق بولسا بىۋاسىتە رەت قىلىنىدۇ. ئىشلەتكۈچىگە «مۇلازىمەت ۋاقتىنچە ئىشلىمەيدۇ» دېيىش، كونترولدىن چىققان ReAct ھالقىسىنىڭ API قالدۇقىنى نۆلگە چۈشۈرۈۋېتىشىدىن ياخشى.

ئون ئۈچ سۇپا ماسلاشتۇرۇشى

بىرلىككە كەلگەن ئۇچۇر مودېلى + 4 ئۇسۇللۇق Adapter كۆرۈنمە يۈزى؛ ھەر بىر ماسلاشتۇرغۇچ تەخمىنەن 150 قۇر.

دىققەت قىلىشقا ئەرزىيدىغان سۇپا خاس ئەمەلىيلەشتۈرۈشلىرى: - WeCom: AES-256-CBC شىفىرلاش/يېشىش + قوش تەكشۈرۈش قۇلۇپى بار Token cache - WeChat: 5 سېكۇنتلۇق پاسسىپ جاۋاب + ۋاقتى ئېشىپ كەتسە خېرىدار مۇلازىمىتىنىڭ ئاسىنخرون ئىتتىرىشىگە ئاپتوماتىك ئۆتۈش - Discord: Gateway WebSocket يۈرەك سوقۇشى + ئېقىم شەكلىدە ئۇچۇر تەھرىرلەش - Web: Origin ئاق تىزىملىكى پەقەت localhost ۋە tauri://localhost

ReAct ماتورى

ماتور، Hexagon ReActAgent نىڭ ئۈستىگە ئەپ قاتلىمى تەشكىللەشنى قوشىدۇ (يەككە ھۆججەت 47KB):

LoadContext → InjectContext(RAG+Memory) → InjectTools(Skill+MCP, limit 40)
→ ReAct loop: LLM reasoning → ToolApproval → ToolExecutor → BudgetUpdate
→ AutoMemory → SaveHistory → Response

3D ئاتوملۇق خامچوت: ئۈچ atomic.Int64 ئارقىلىق Token، ۋاقىت ۋە تەننەرخ ئايرىم ئىزلىنىدۇ. نېمىشقا تەننەرخكە float64 ئىشلەتمەيمىز؟ Go نىڭ atomic بوغچىسى لەيلىمە سان ئاتوم مەشغۇلاتىنى قوللىمايدۇ، Agent نىڭ قورال چاقىرىشىدا بولسا پاراللېللىق يۇقىرى. ھەل قىلىش چارىسى دوللارنى بىر مىليونغا كۆپەيتىپ پۈتۈن سان ساقلاش (مىكرو دوللار ئېنىقلىقى): $0.00004 بولسا 40 كە ئايلىنىدۇ. پۈتۈن سان ئاتوم مەشغۇلاتى، قۇلۇپ خىراجىتى نۆل. 20+ مودېل باھا جەدۋىلى بار، تارماق Agent خامچوتىنى تەقسىملەش ۋە قايتۇرۇۋېلىشنى قوللايدۇ.

Two-Pass Streaming: ئارىلىق نۆۋەتتە Complete() (tool_calls نى بايقاش)، ئاخىرقى نۆۋەتتە Stream() (خەت يېزىش ئۈنۈمى). كۆرۈنمەيدىغان قەدەملەرگە ئېقىم ئۇلىنىشى قۇرۇشتىن ساقلىنىدۇ. ئېقىم goroutine ى ئايرىم context.Background() بىلەن ئۇچۇر ساقلايدۇ، ئىشلەتكۈچى بەتنى تاقىغاندا سانلىق مەلۇمات يوقاپ كېتىشنىڭ ئالدىنى ئالىدۇ.

Hook Chain: TruncateHook بېشىنىڭ 60% ى + ئاخىرىنىڭ 20% ىنى قالدۇرىدۇ · SanitizeHook پەقەت سىرتقى مەنبەنى تازىلايدۇ · AuditHook مەغلۇپ بولغاندىمۇ ئىجرا بولىدۇ. قورال cache ى SHA256 key ئىشلىتىدۇ، بۇزغۇنچىلىق خاراكتېرلىك قوراللار ئاپتوماتىك ئاتلىنىدۇ.

Skill ئېكولوگىيەسى (ClawHub): 37 Skill + 38 MCP Server. فورماتى Markdown + YAML frontmatter؛ مەنبەسى 18 ئۆز ئىجادىيىتى + 12 جامائەتچىلىكتىن ماسلاشتۇرۇلغان + 7 OpenClaw playbook كۆچۈرۈلمىسى. MCP، 18 تۈرنى قاپلايدۇ (ھۆججەت سىستېمىسى / GitHub / ئىزدەش / توركۆرگۈچ / ساندان / Slack / Docker / K8s / AWS قاتارلىقلار).

Go نىڭ ئۈچ سۇپىلىق ئەسلىي sandbox ى: 2713 قۇر بىلەن Docker نىڭ ئورنىنى ئېلىش

OpenClaw قاتارلىق رىقابەتچىلەرنىڭ كۆپىنچىسى كود ئىجرا قىلىشتا Docker غا تايىنىدۇ. hexclaw، 2713 قۇر ساپ Go بىلەن يادرو دەرىجىلىك ئايرىشنى ئەمەلىيلەشتۈرىدۇ:

macOS Seatbelt (Claude Code / Codex بىلەن ئوخشاش تۆۋەنكى تېخنىكا) — ھەرىكەتچان SBPL سىياسىتى، (deny default) سۈكۈتتە رەت قىلىنىدۇ. Docker قاچىسى سۈكۈتتە كۆپىنچە syscall ئىجازەتلىرىگە ئىگە، بۇنى قىلالمايدۇ.

Windows نىڭ بەش قاتلاملىق چوڭقۇر مۇداپىئەسى — ① Restricted Token (UNTRUSTED_RID 0x0000) → ② ACL ھۆججەت سىستېمىسى ئايرىشى → ③ Job Object (512MB / 10 جەريان) → ④ Low Box Token يادرو دەرىجىلىك تور ئۈزۈش → ⑤ Alternate Desktop (Shatter Attack تىن ساقلىنىش). قوزغىلىش تەخمىنەن 50ms / 5MB؛ Docker Desktop بولسا 500ms-2s.

Linux نىڭ بەش قاتلاملىق ئايرىشى — ① Namespace → ② pivot_root → ③ seccomp → ④ جەرياننى مۇستەھكەملەش → ⑤ ئىككى باسقۇچلۇق re-exec. ماس كەلمەيدىغان سىستېمىدا ئاپتوماتىك تۆۋەنلەيدۇ: CLONE_NEWUSER مەغلۇپ → Landlock → زاپاس seccomp.

ئۈچ سۇپا ئورتاق NetPolicy ماتورى ئىشلىتىدۇ: قارا تىزىملىك ئالدىن → پورت → ھالەت؛ ئايلىنىپ ئۆتكىلى بولمايدۇ.

Sandbox ئەمەلىي ئۆلچەش سېلىشتۇرمىسى (Linux):

بىلىم ئامبىرى · LLM يوللاش · ئەستە ساقلاش

بىلىم ئامبىرى: Recursive Split → FTS5 + ۋېكتور Embedding → ئارىلاش نومۇرلاش (0.7v + 0.3t) → ۋاقىت تۆۋەنلىشى → MMR تەكرارسىزلاشتۇرۇش (3×TopK نامزاتنى قايتا سۈزۈش) → TopK=3. Embedder ئىشلىمىسە ئاپتوماتىك ساپ FTS5 غا تۆۋەنلەيدۇ.

LLM يوللاش: كۆپ Provider نى سىياسەت (cost / quality / latency) بويىچە يوللاش، كاشىلىدا ئاپتوماتىك تۆۋەنلەش. مەنىلىك cache: Singleflight cache بۆسۈلۈشىدىن ساقلايدۇ · TTL ± 10% تەۋرىنىشى بىرلا ۋاقىتتا ئىناۋەتسىزلىنىشتىن ساقلايدۇ · قۇرۇق قىممەت cache ى تېشىپ ئۆتۈشتىن ساقلايدۇ.

تۆت قاتلاملىق ئەستە ساقلاش: سۆھبەت كونتېكىستى → كۈندىلىك خاتىرە → MEMORY.md → مەنىلىك ۋېكتور. ئاپتوماتىك ئايرىش: ئاچقۇچلۇق سۆز بىلەن ئالدىن سۈزۈش → ئاسىنخرون LLM (15s ۋاقىت چېكى) → مەۋجۇت ئەسلىمىنى قوشۇپ تەكراردىن ساقلىنىش. 50 تىن ئاشسا LLM ئاپتوماتىك قىسىدۇ. Markdown فورماتى، ئادەم ئوقۇيالايدۇ، Git بىلەن نەشر باشقۇرغىلى بولىدۇ.

كۆپ Agent يوللاش · مۇستەقىل ھەرىكەت

تۆت تاللاش مېخانىزمى: UI دا بىۋاسىتە تاللاش · @mention گرامماتىكىسى · ھالەتكە ئاپتوماتىك باغلاش · سۇپا يوللاش قائىدىسى (UserID +100 > ChatID +50 > Platform +10)؛ زاپاس ئۇسۇل LLM مەنىلىك تۈرلىشى.

يىغىن ھالىتى: ≥2 Agent قۇرۇلمىلىق تېما ئەتراپىدا كۆپ نۆۋەتلىك يۇمىلاق ئۈستەل مۇنازىرىسى قىلىدۇ؛ رىقابەتچى تەھلىلى، مېڭە بورىنى، مۇتەخەسسىسلەر مۇنازىرىسىگە ماس.

مۇستەقىل ھەرىكەت: Heartbeat تەكشۈرۈشى + Cron ۋاقىتلىق جەدۋىلى + Webhook ھادىسە يېتەكچىلىكى. سۈكۈتتە SQLite WAL؛ تۆت ئورۇنلاشتۇرۇش شەكلى: ئۈستەل يۈزى / Docker / systemd / K8s.

hexclaw-desktop: AI Agent نى Docker Desktop دەك «قوش چېكىپلا ئىشلىتىش»

Tauri قېپى Go Sidecar نى باشقۇرىدۇ

[سۈرەت: HexClaw Desktop نىڭ قاتلاملىق ئارخىتېكتۇرىسى]

                  HexClaw Desktop Architecture
                  ============================

  ┌─ Tauri Shell (Rust) ───────────────────────────────────────┐
  │ Window management  System tray  Hotkey ⌘⇧H  Single instance │
  │ Auto-update  API proxy (CORS bypass) Sidecar lifecycle      │
  ├─ Vue 3 Frontend (WebView) ─────────────────────────────────┤
  │ Overview │ Chat │ Agent │ Knowledge │ Automation │ Logs   │
  │                  Integrations                             │
  │ Pinia Store        Vue Router        Tauri invoke (IPC)    │
  ├─ Tauri Commands (Rust → Go) ───────────────────────────────┤
  │ proxy_api_request    stream_chat    check_engine_health    │
  ├─────────────────────────────────────────────────────────────┤
  │              HTTP / WebSocket ←→ localhost:16060             │
  ├─ hexclaw serve (Go Sidecar) ───────────────────────────────┤
  │ Agent engine · Security gateway · LLM router · RAG · MCP    │
  │ Sandbox                                                   │
  │  ┌─────────────────────────────────────────────────────┐   │
  │  │    Hexagon  ←  ai-core  ←  toolkit                  │   │
  │  └─────────────────────────────────────────────────────┘   │
  └─────────────────────────────────────────────────────────────┘

رامكا تاللاش:

بوغچا چوڭلۇقى 8MB، Electron بولسا 150MB (19x)، ئىچكى ساقلىغۇچ 25MB، Electron بولسا 200MB (8x）。

ئىقتىدار مودۇللىرى

ئەسلىي ئىقتىدار

⌘⇧H پۈتۈن سىستېمىدا چاقىرىش · سىستېما تەخسىسى · ئەسلىي ئۇقتۇرۇش · چاپلاش تاختىسى بىلەن ئالاقە · ھۆججەت سۆرەپ يۈكلەش · 3 باسقۇچلۇق يېتەكچى · Tauri Updater. ئوخشاش كود Desktop ۋە Headless نى قوللايدۇ. قاچىلاش:curl | bash / Homebrew / DMG / MSI / DEB / AppImage。

رىقابەتچىلەردىن زادى قەيەردە كۈچلۈك؟

2025-يىلىنىڭ ئاخىرىدىن بېرى، ھەرقايسى تەرەپلەر AI Agent مەھسۇلاتلىرىنى كۆپ ئېلان قىلدى. لېكىن كۆپىنچىسى بۇلۇتتا، يېپىق كودلۇق، كارخانا خېرىدارلىرىغا يۈزلەنگەن. HexClaw باشقا يولدا: ئوچۇق كود، ئۆزى باشقۇرۇش، ئىجادكار ۋە تېخنىكا گۇرۇپپىلىرىغا يۈزلىنىش. تۆۋەندىكى جەدۋەل تۈر بويىچە سېلىشتۇرىدۇ:

يولۇققان ئورەكلەر ۋە ئارخىتېكتۇرا تاللاشلىرى

1-ئورەك: Docker sandbox — «پاراڭ ياردەمچىسى ئۈچۈن يەنە Docker قاچىلامدىم؟»

دەسلەپ Skill ئىجراسى Docker غا تايىناتتى. ئادەتتىكى MacBook سەپلىمىسىدە مەسىلە يوق، لېكىن macOS تا Docker Desktop قوشۇمچە 2-4GB ئىچكى ساقلىغۇچ يەيتتى؛ ئىشلەتكۈچى ھاۋارايى سۈرۈشتۈرۈش ئۈچۈن Docker قاچىلىشى مۇۋاپىق ئەمەس.

بىر ھەپتە ۋاقىت سەرپ قىلىپ، Go syscall ئارقىلىق ئۈچ سۇپىلىق ئەسلىي sandbox نى قايتا يازدىم: 2713 قۇر، نۆل تايىنىشچانلىق، <10ms قوزغىلىش. ئايرىش كۈچى تولۇق قاچىدەك ئەمەس، لېكىن Skill ئىجرا سىنارىيەسىگە يېتەرلىك.

2-ئورەك: Wails → Tauri — خاتا تاللاشتىن توغرا بۇرۇلۇش

ئۈستەل يۈزى ئۈچۈن دەسلەپ Wails تاللانغان. سەۋەبى يېتەرلىك: Go ئەسلىي، بىرلەشتۈرۈش تەننەرخى نۆل. 60% ئىجاد قىلىنغاندا ئۈچ ئېغىر مەسىلە بايقالدى: كۆپ كۆزنەك يوق (Quick Chat لەيلىمە كۆزنىكىنى قىلغىلى بولمايدۇ)، سىستېما تەخسىسىگە ئۈچىنچى تەرەپ كۈتۈپخانىسى لازىم، ئاپتوماتىك يېڭىلاش يوق.

زىياننى توختىتىپ Tauri v2 گە ئۆتتۈم. Go ئارقا تەرىپى Sidecar غا ئايلاندى، بىر HTTP قاتلىمى كۆپەيدى؛ لېكىن مەۋجۇت 71 API نى دەل قايتا ئىشلەتكىلى بولغاچقا، ئەمەلىي ئىجاد تەننەرخى تېخىمۇ تۆۋەن بولدى.

3-ئورەك: بىخەتەرلىك دەرۋازىسى ئەسلىدە «ئىختىيارىي سەپلىمە» ئىدى

بىرىنچى نەشرىدە بىخەتەرلىك قاتلىمى middleware قىلىنغان؛ سەپلىمە ھۆججىتىدە enabled: false دېيىلسە ئۆچۈرگىلى بولاتتى. بىر code review دا، CostCheck ئۆچسە كونترولدىن چىققان ReAct ھالقىسى پۇل ھېساباتى پارتلىغۇچە LLM نى چەكسىز چاقىرىدىغانلىقى بايقالدى. بۇ نەزەرىيەۋى خەۋپ ئەمەس، ئېنىق ئاپەت ئىدى.

شۇ كۈنى ئۇنى ئايلىنىپ ئۆتكىلى بولمايدىغان 6 قاتلاملىق تۇرۇبا يولىغا قايتا قۇردۇم. ئىجاد مەزگىلىدە چاستوتا چەكلىمىسى كۆپ قوزغىلىدۇ، لېكىن يېرىم كېچىدە API پۇل ھېساباتى كەلگەندىن ياخشى.

تاللاشلار خۇلاسىسى:

كېيىن نېمە قىلىمىز؟

2026-يىلى AI Agent ساھەسى «تېخنىكا دەلىللەش»تىن «قۇرۇلۇش ئارقىلىق ئەمەلىيلەشتۈرۈش»كە كىردى: MCP + A2A قوش كېلىشىم قاتلىمى پىشىپ، بىخەتەرلىك ۋە بەلگىلىك ھەرىكەت «Demo ئىجرا بولسىلا بولدى» دېگەن قاراشنىڭ ئورنىنى ئالدى. HexClaw ھازىر v0.2.x، يادرولۇق ئىقتىدارى مۇقىم، لېكىن «ئىشلەپچىقىرىش دەرىجىسى»گىچە مۇھىم كەمچىلىكلەر بار:

• ئېقىم يېڭىلىشى: ھازىر ساختا ئېقىم (ئارىلىق نۆۋەتلەر ماس قەدەملىك)، Hexagon Agent نىڭ ئەسلىي Stream ئىقتىدارىغا ئۇلاش پىلاندا
• Embedding بىرلەشتۈرۈش: بىلىم ئامبىرىنىڭ Embedder كۆرۈنمە يۈزى بەلگىلەنگەن، LLM Provider غا ئۇلاش لازىم
• سىناق قاپلىشى > 80%: 93 سىناق ھۆججىتى بار، قاپلاش نىسبىتىنى ئۆستۈرۈش كېرەك
• Hub ئېكولوگىيەسىنى كېڭەيتىش: 37 Skill → 100+، 38 MCP Server → 80+؛ كود تەكشۈرۈش / سانلىق مەلۇمات تەھلىلى / تۈر باشقۇرۇشنى تولۇقلاش
• كۆپ سۇپىلىق ئۈستەل يۈزىنى ياخشىلاش: Mac ئالدىنقى، Windows MSI ۋە Linux AppImage غا تېخىمۇ كۆپ سىناق لازىم

ئوچۇق بىر سوئال: بىخەتەرلىكتىن ۋاز كەچمەي Agent نى قانداق تېخىمۇ مۇستەقىل قىلىمىز؟ Tool Approval بىخەتەرلىكنى كاپالەتلەندۈرىدۇ، لېكىن مۇستەقىللىقنى چەكلەيدۇ؛ تارىخىي ھەرىكەتكە ئاساسلانغان ئۆزلىشىشچان تەستىق سىياسىتى ئۈستىدە ئىزدىنىۋاتىمىز. بۇمۇ AI Agent ساھەسىنىڭ 2026-يىلدىكى يادرولۇق زىددىيىتى: «Demo ئىجرا بولۇش»تىن «ئىشلەپچىقىرىشتا ئىشەنچلىك بولۇش»قا ئۆتۈشتە، بىخەتەرلىك بىلەن مۇستەقىللىقنىڭ تەڭپۇڭ نۇقتىسى قەيەردە؟

تېخنىكا توپلىمى

بۇ تۈرنى مەن بىر كىشى + Claude جۈپ ئىجادىيىتى بىلەن قۇردۇم؛ دەسلەپكى مەقسەت ناھايىتى ئاددىي: ئۆزۈمگە بىخەتەر، قولايلىق، قىممەت ئەمەس بىر AI Agent ئىشلەتمەكچى ئىدىم. سىزدە ئوخشاش ئېھتىياج بولسا، GitHub تا hexclaw نى ئىزدەپ Issue / PR يوللاڭ، بىللە سىناپ باقايلى.

ئاخىرقى بىر سوئال: AI Agent ئىشلەتكەندە سىزنى ئەڭ قىينايدىغىنى نېمە: بىخەتەرلىك ئىشەنچى، تەننەرخ كونترول، ياكى سۇپا ماسلاشتۇرۇش؟ باھا رايونىدا سۆزلەيلى؛ بۇ ھەقىقىي ئاغرىق نۇقتىلار HexClaw نىڭ ئالدىنلىقىغا بىۋاسىتە تەسىر قىلىدۇ.

HexClaw ھېشى AI
يەرلىكتە ياكى بۇلۇتتا ئورۇنلاشتۇرۇش · سانلىق مەلۇماتنى ئۆزىڭىز باشقۇرۇش · ئوچۇق كودلۇق ۋە ھەقسىز يۇمشاق دېتال
تور بېكەت: hexclaw.net  |  GitHub: hexagon-codes
Weibo: @HexClaw  |  X: @hexclawapp
ئېلخەت: [email protected]