{"id":952,"date":"2026-05-12T19:31:49","date_gmt":"2026-05-12T11:31:49","guid":{"rendered":"http:\/\/127.0.0.1:13305\/hub\/ontology\/"},"modified":"2026-08-31T11:32:44","modified_gmt":"2026-08-31T03:32:44","slug":"ontology","status":"publish","type":"post","link":"https:\/\/ai.wuaishare.cn\/hub\/952","title":{"rendered":"ontology"},"content":{"rendered":"\n
\"ontology\"<\/figure>\n\n\n\n

\u4e00\u4e2a\u7c7b\u578b\u5316\u8bcd\u6c47\u8868 + \u7ea6\u675f\u7cfb\u7edf\uff0c\u7528\u4e8e\u5c06\u77e5\u8bc6\u8868\u793a\u4e3a\u53ef\u9a8c\u8bc1\u7684\u56fe\u7ed3\u6784\u3002<\/p>\n

\u6838\u5fc3\u6982\u5ff5<\/h2>\n

\u4e00\u5207\u7686\u4e3a\u5b9e\u4f53<\/strong>\uff0c\u5177\u6709\u7c7b\u578b<\/strong>\u3001\u5c5e\u6027<\/strong>\u4ee5\u53ca\u4e0e\u5176\u4ed6\u5b9e\u4f53\u7684\u5173\u7cfb<\/strong>\u3002\u6bcf\u6b21\u53d8\u66f4\u5728\u63d0\u4ea4\u524d\u90fd\u4f1a\u6839\u636e\u7c7b\u578b\u7ea6\u675f\u8fdb\u884c\u9a8c\u8bc1\u3002<\/p>\n

text<\/span><\/figcaption>
Entity: { id, type, properties, relations, created, updated }\nRelation: { from_id, relation_type, to_id, properties }\n<\/code><\/pre><\/figure>\n
\u4f7f\u7528\u573a\u666f<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\u89e6\u53d1<\/th>\u64cd\u4f5c<\/th><\/tr><\/thead>
“\u8bb0\u4f4f\u90a3\u4e2a…”<\/td>\u521b\u5efa\/\u66f4\u65b0\u5b9e\u4f53<\/td><\/tr>
“\u5173\u4e8e X \u6211\u77e5\u9053\u4e9b\u4ec0\u4e48\uff1f”<\/td>\u67e5\u8be2\u56fe<\/td><\/tr>
“\u5c06 X \u5173\u8054\u5230 Y”<\/td>\u521b\u5efa\u5173\u7cfb<\/td><\/tr>
“\u663e\u793a\u9879\u76ee Z \u7684\u6240\u6709\u4efb\u52a1”<\/td>\u56fe\u904d\u5386<\/td><\/tr>
“\u4ec0\u4e48\u4f9d\u8d56\u4e8e X\uff1f”<\/td>\u4f9d\u8d56\u67e5\u8be2<\/td><\/tr>
\u89c4\u5212\u591a\u6b65\u9aa4\u5de5\u4f5c<\/td>\u5efa\u6a21\u4e3a\u56fe\u8f6c\u6362<\/td><\/tr>
\u6280\u80fd\u9700\u8981\u5171\u4eab\u72b6\u6001<\/td>\u8bfb\u5199\u672c\u4f53\u5bf9\u8c61<\/td><\/tr><\/tbody><\/table>\n
\u6838\u5fc3\u7c7b\u578b<\/h2>\n
yaml<\/span><\/figcaption>
# Agents & People\nPerson: { name, email?, phone?, notes? }\nOrganization: { name, type?, members[] }\n\n# Work\nProject: { name, status, goals[], owner? }\nTask: { title, status, due?, priority?, assignee?, blockers[] }\nGoal: { description, target_date?, metrics[] }\n\n# Time & Place\nEvent: { title, start, end?, location?, attendees[], recurrence? }\nLocation: { name, address?, coordinates? }\n\n# Information\nDocument: { title, path?, url?, summary? }\nMessage: { content, sender, recipients[], thread? }\nThread: { subject, participants[], messages[] }\nNote: { content, tags[], refs[] }\n\n# Resources\nAccount: { service, username, credential_ref? }\nDevice: { name, type, identifiers[] }\nCredential: { service, secret_ref }  # Never store secrets directly\n\n# Meta\nAction: { type, target, timestamp, outcome? }\nPolicy: { scope, rule, enforcement }\n<\/code><\/pre><\/figure>\n
\u5b58\u50a8<\/h2>\n
\u9ed8\u8ba4\u4f4d\u7f6e\uff1amemory\/ontology\/graph.jsonl<\/code><\/p>\n
jsonl<\/span><\/figcaption>
{\"op\":\"create\",\"entity\":{\"id\":\"p_001\",\"type\":\"Person\",\"properties\":{\"name\":\"Alice\"}}}\n{\"op\":\"create\",\"entity\":{\"id\":\"proj_001\",\"type\":\"Project\",\"properties\":{\"name\":\"Website Redesign\",\"status\":\"active\"}}}\n{\"op\":\"relate\",\"from\":\"proj_001\",\"rel\":\"has_owner\",\"to\":\"p_001\"}\n<\/code><\/pre><\/figure>\n
\u901a\u8fc7\u811a\u672c\u6216\u76f4\u63a5\u6587\u4ef6\u64cd\u4f5c\u8fdb\u884c\u67e5\u8be2\u3002\u5bf9\u4e8e\u590d\u6742\u56fe\u7ed3\u6784\uff0c\u53ef\u8fc1\u79fb\u81f3 SQLite\u3002<\/p>\n
\u4ec5\u8ffd\u52a0\u89c4\u5219<\/h3>\n
\u5728\u5904\u7406\u73b0\u6709\u672c\u4f53\u6570\u636e\u6216\u6a21\u5f0f\u65f6\uff0c\u8ffd\u52a0\/\u5408\u5e76<\/strong>\u53d8\u66f4\u800c\u975e\u8986\u76d6\u6587\u4ef6\u3002\u8fd9\u6837\u53ef\u4ee5\u4fdd\u7559\u5386\u53f2\u8bb0\u5f55\uff0c\u907f\u514d\u7834\u574f\u5148\u524d\u5b9a\u4e49\u3002<\/p>\n
\u5de5\u4f5c\u6d41<\/h2>\n
\u521b\u5efa\u5b9e\u4f53<\/h3>\n
bash<\/span><\/figcaption>
python3 scripts\/ontology.py create --type Person --props '{\"name\":\"Alice\",\"email\":\"alice@example.com\"}'\n<\/code><\/pre><\/figure>\n
\u67e5\u8be2<\/h3>\n
bash<\/span><\/figcaption>
python3 scripts\/ontology.py query --type Task --where '{\"status\":\"open\"}'\npython3 scripts\/ontology.py get --id task_001\npython3 scripts\/ontology.py related --id proj_001 --rel has_task\n<\/code><\/pre><\/figure>\n
\u5173\u8054\u5b9e\u4f53<\/h3>\n
bash<\/span><\/figcaption>
python3 scripts\/ontology.py relate --from proj_001 --rel has_task --to task_001\n<\/code><\/pre><\/figure>\n
\u9a8c\u8bc1<\/h3>\n
bash<\/span><\/figcaption>
python3 scripts\/ontology.py validate  # Check all constraints\n<\/code><\/pre><\/figure>\n
\u7ea6\u675f<\/h2>\n
\u5728 memory\/ontology\/schema.yaml<\/code> \u4e2d\u5b9a\u4e49\uff1a<\/p>\n
yaml<\/span><\/figcaption>
types:\n  Task:\n    required: [title, status]\n    status_enum: [open, in_progress, blocked, done]\n  \n  Event:\n    required: [title, start]\n    validate: \"end >= start if end exists\"\n\n  Credential:\n    required: [service, secret_ref]\n    forbidden_properties: [password, secret, token]  # Force indirection\n\nrelations:\n  has_owner:\n    from_types: [Project, Task]\n    to_types: [Person]\n    cardinality: many_to_one\n  \n  blocks:\n    from_types: [Task]\n    to_types: [Task]\n    acyclic: true  # No circular dependencies\n<\/code><\/pre><\/figure>\n
\u6280\u80fd\u5951\u7ea6<\/h2>\n
\u4f7f\u7528\u672c\u4f53\u7684\u6280\u80fd\u5e94\u58f0\u660e\uff1a<\/p>\n
yaml<\/span><\/figcaption>
# In SKILL.md frontmatter or header\nontology:\n  reads: [Task, Project, Person]\n  writes: [Task, Action]\n  preconditions:\n    - \"Task.assignee must exist\"\n  postconditions:\n    - \"Created Task has status=open\"\n<\/code><\/pre><\/figure>\n
\u4f5c\u4e3a\u56fe\u8f6c\u6362\u7684\u89c4\u5212<\/h2>\n
\u5c06\u591a\u6b65\u9aa4\u8ba1\u5212\u5efa\u6a21\u4e3a\u4e00\u7cfb\u5217\u56fe\u64cd\u4f5c\uff1a<\/p>\n
text<\/span><\/figcaption>
Plan: \"Schedule team meeting and create follow-up tasks\"\n\n1. CREATE Event { title: \"Team Sync\", attendees: [p_001, p_002] }\n2. RELATE Event -> has_project -> proj_001\n3. CREATE Task { title: \"Prepare agenda\", assignee: p_001 }\n4. RELATE Task -> for_event -> event_001\n5. CREATE Task { title: \"Send summary\", assignee: p_001, blockers: [task_001] }\n<\/code><\/pre><\/figure>\n
\u6bcf\u4e00\u6b65\u5728\u6267\u884c\u524d\u90fd\u4f1a\u8fdb\u884c\u9a8c\u8bc1\u3002\u7ea6\u675f\u8fdd\u89c4\u65f6\u56de\u6eda\u3002<\/p>\n
\u96c6\u6210\u6a21\u5f0f<\/h2>\n
\u4e0e\u56e0\u679c\u63a8\u7406\u7ed3\u5408<\/h3>\n
\u5c06\u672c\u4f53\u53d8\u66f4\u8bb0\u5f55\u4e3a\u56e0\u679c\u52a8\u4f5c\uff1a<\/p>\n
python<\/span><\/figcaption>
# When creating\/updating entities, also log to causal action log\naction = {\n    \"action\": \"create_entity\",\n    \"domain\": \"ontology\", \n    \"context\": {\"type\": \"Task\", \"project\": \"proj_001\"},\n    \"outcome\": \"created\"\n}\n<\/code><\/pre><\/figure>\n
\u8de8\u6280\u80fd\u901a\u4fe1<\/h3>\n
python<\/span><\/figcaption>
# Email skill creates commitment\ncommitment = ontology.create(\"Commitment\", {\n    \"source_message\": msg_id,\n    \"description\": \"Send report by Friday\",\n    \"due\": \"2026-01-31\"\n})\n\n# Task skill picks it up\ntasks = ontology.query(\"Commitment\", {\"status\": \"pending\"})\nfor c in tasks:\n    ontology.create(\"Task\", {\n        \"title\": c.description,\n        \"due\": c.due,\n        \"source\": c.id\n    })\n<\/code><\/pre><\/figure>\n
\u5feb\u901f\u5f00\u59cb<\/h2>\n
bash<\/span><\/figcaption>
# Initialize ontology storage\nmkdir -p memory\/ontology\ntouch memory\/ontology\/graph.jsonl\n\n# Create schema (optional but recommended)\npython3 scripts\/ontology.py schema-append --data '{\n  \"types\": {\n    \"Task\": { \"required\": [\"title\", \"status\"] },\n    \"Project\": { \"required\": [\"name\"] },\n    \"Person\": { \"required\": [\"name\"] }\n  }\n}'\n\n# Start using\npython3 scripts\/ontology.py create --type Person --props '{\"name\":\"Alice\"}'\npython3 scripts\/ontology.py list --type Person\n<\/code><\/pre><\/figure>\n
\u53c2\u8003\u8d44\u6599<\/h2>\n
    \n
  • references\/schema.md<\/code> \u2014 \u5b8c\u6574\u7c7b\u578b\u5b9a\u4e49\u548c\u7ea6\u675f\u6a21\u5f0f<\/li>\n
  • references\/queries.md<\/code> \u2014 \u67e5\u8be2\u8bed\u8a00\u548c\u904d\u5386\u793a\u4f8b<\/li>\n<\/ul>\n
    \u6307\u4ee4\u8303\u56f4<\/h2>\n
    \u8fd0\u884c\u65f6\u6307\u4ee4\u5728\u672c\u5730\u6587\u4ef6\uff08memory\/ontology\/graph.jsonl<\/code> \u548c memory\/ontology\/schema.yaml<\/code>\uff09\u4e0a\u8fd0\u884c\uff0c\u5e76\u63d0\u4f9b create\/query\/relate\/validate \u7684 CLI \u7528\u6cd5\uff1b\u8fd9\u5728\u8303\u56f4\u5185\u3002\u8be5\u6280\u80fd\u8bfb\u5199\u5de5\u4f5c\u533a\u6587\u4ef6\uff0c\u5e76\u5728\u4f7f\u7528\u65f6\u521b\u5efa memory\/ontology<\/code> \u76ee\u5f55\u3002\u9a8c\u8bc1\u5305\u62ec\u5c5e\u6027\/enum\/forbidden \u68c0\u67e5\u3001\u5173\u7cfb\u7c7b\u578b\/\u57fa\u6570\u9a8c\u8bc1\u3001\u6807\u8bb0\u4e3a acyclic: true<\/code> \u7684\u5173\u7cfb\u7684\u65e0\u73af\u6027\u68c0\u67e5\uff0c\u4ee5\u53ca Event end >= start<\/code> \u68c0\u67e5\uff1b\u5176\u4ed6\u66f4\u9ad8\u7ea7\u522b\u7684\u7ea6\u675f\u53ef\u80fd\u4ecd\u4ec5\u4e3a\u6587\u6863\u6027\u8d28\uff0c\u9664\u975e\u5728\u4ee3\u7801\u4e2d\u5b9e\u73b0\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"
    \u7ed3\u6784\u5316 Agent \u8bb0\u5fc6\u4e0e\u53ef\u7ec4\u5408\u6280\u80fd\u7684\u7c7b\u578b\u5316\u77e5\u8bc6\u56fe\u8c31\u3002\u9002\u7528\u4e8e\u521b\u5efa\/\u67e5\u8be2\u5b9e\u4f53\uff08Person\u3001Project\u3001Task\u3001Event\u3001Document\uff09\u3001\u5173\u8054\u76f8\u5173\u5bf9\u8c61\u3001\u5b9e\u65bd\u7ea6\u675f\u3001\u5c06\u591a\u6b65\u9aa4\u64cd\u4f5c\u89c4\u5212\u4e3a\u56fe\u8f6c\u6362\uff0c\u6216\u6280\u80fd\u95f4\u5171\u4eab\u72b6\u6001\u3002\u89e6\u53d1\u8bcd\u5305\u62ec\uff1a”remember”\u3001”what do I know about”\u3001”link X to Y”\u3001”show dependencies”\u3001\u5b9e\u4f53 CRUD\uff0c\u6216\u8de8\u6280\u80fd\u6570\u636e\u8bbf\u95ee\u3002<\/p>\n","protected":false},"author":1,"featured_media":946,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"ai_share_source_url":"https:\/\/clawhub.ai\/oswalpalash\/ontology","ai_share_source_title":"ontology","ai_share_status":"\u5df2\u53d1\u5e03","ai_share_tool_icon_attachment_id":763,"ai_share_author_label":"@oswalpalash","ai_share_version_label":"v1.0.4","ai_share_package_name":"ontology","ai_share_install_command":"openclaw skills install @oswalpalash\/ontology","ai_share_primary_category":"\u5de5\u4f5c\u6d41\u81ea\u52a8\u5316","ai_share_tool_type":"workflow_skill_pack","ai_share_resource_type":"workflow_skill_pack","ai_share_collection":"ClawHub \u6280\u80fd","ai_share_last_verified_at":"2026-05-12","ai_share_provider_observed_at":"2026-09-03T01:43:04+00:00","ai_share_target_user":"\u77e5\u8bc6\u56fe\u8c31\u6784\u5efa\u8005,Agent \u89c4\u5219\u8bbe\u8ba1\u8005,\u8bed\u4e49\u5efa\u6a21\u7814\u7a76\u8005,\u81ea\u52a8\u5316\u5de5\u4f5c\u6d41\u642d\u5efa\u8005","ai_share_pricing_model":"free","ai_share_deployment_mode":"local","ai_share_delivery_mode":"skill","ai_share_region_availability":"global","ai_share_source_platform":"ClawHub","ai_share_download_url":"https:\/\/wry-manatee-359.convex.site\/api\/v1\/download?slug=ontology&ownerHandle=oswalpalash","ai_share_download_assets_json":"[{\"label\":\"ClawHub \u6280\u80fd\u5305\",\"url\":\"https:\/\/wry-manatee-359.convex.site\/api\/v1\/download?slug=ontology&ownerHandle=oswalpalash\",\"source\":\"clawhub\",\"download\":true}]","ai_share_view_count":7,"ai_share_first_party_view_count":32,"ai_share_open_source":false,"creator_id":"sourceflow-clawhub_source_url-oswalpalash","creator_slug":"oswalpalash","creator_name":"@oswalpalash","creator_type":"unknown","creator_status":"external","creator_website_url":"https:\/\/clawhub.ai\/u\/oswalpalash","creator_github_url":"https:\/\/github.com\/oswalpalash","creator_avatar_url":"https:\/\/github.com\/oswalpalash.png","ai_share_one_sentence_definition":"\u7ed3\u6784\u5316 Agent \u8bb0\u5fc6\u7684\u7c7b\u578b\u5316\u77e5\u8bc6\u56fe\u8c31\u6280\u80fd","ai_share_one_sentence_definition_zh_cn":"\u7ed3\u6784\u5316 Agent \u8bb0\u5fc6\u7684\u7c7b\u578b\u5316\u77e5\u8bc6\u56fe\u8c31\u6280\u80fd","ai_share_one_sentence_definition_raw_output":"\u7ed3\u6784\u5316 Agent \u8bb0\u5fc6\u7684\u7c7b\u578b\u5316\u77e5\u8bc6\u56fe\u8c31\u6280\u80fd","ai_share_one_sentence_definition_source_hash":"0a0420413ed40ac27b6edd430ddaf60d4628964d21eff824f52c0b6f52cb6bbf","ai_share_one_sentence_definition_generated_at":"2026-08-31T03:30:00Z","ai_share_one_sentence_definition_provider":"ManualReviewedLiveSource","ai_share_one_sentence_definition_model":"clawhub-live-source-review","ai_share_one_sentence_definition_status":"approved"},"categories":[2460],"tags":[],"ai_series":[],"ai_topic":[110],"ai_creator":[1050],"ai_collection":[902],"ai_resource_type":[105],"ai_tool_tag":[],"class_list":["post-952","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-workflow_skill_pack","ai_topic-workflow-automation","ai_creator-oswalpalash","ai_collection-clawhub-skills","ai_resource_type-workflow_skill_pack"],"source_url":"","preserve_modified":false,"lang":"zh-cn","translations":{"zh-cn":952,"en":3573},"pll_sync_post":{},"_links":{"self":[{"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/posts\/952","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/comments?post=952"}],"version-history":[{"count":1,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/posts\/952\/revisions"}],"predecessor-version":[{"id":4247,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/posts\/952\/revisions\/4247"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/media\/946"}],"wp:attachment":[{"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/media?parent=952"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/categories?post=952"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/tags?post=952"},{"taxonomy":"ai_series","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/ai_series?post=952"},{"taxonomy":"ai_topic","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/ai_topic?post=952"},{"taxonomy":"ai_creator","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/ai_creator?post=952"},{"taxonomy":"ai_collection","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/ai_collection?post=952"},{"taxonomy":"ai_resource_type","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/ai_resource_type?post=952"},{"taxonomy":"ai_tool_tag","embeddable":true,"href":"https:\/\/ai.wuaishare.cn\/hub\/wp-json\/wp\/v2\/ai_tool_tag?post=952"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}