توثيق رسمي · إرشاد عربي

استيراد إعداداتك من وكلاء آخرين

Import from Other Agents

متوسط3 دقائق قراءةالدرس 214 أسئلة✓ 2026-08-18

قبل أن تقرأ

ما هذه الصفحة، وماذا تحتوي.

MCP: طريقة موحّدة تسمح لـHermes أن يستعمل أدوات برامج أخرى، من دون أن يكتب أحد كودًا خاصًا لكل برنامج. بدلًا من انتظار دعم رسمي لكل خدمة تحبها، تشغّل «خادم MCP» جاهزًا فيصبح Hermes قادرًا على استخدامها فورًا. ستستعمل هنا hermes import-agent claude-code وhermes claw migrate، والقراءة نحو 3 دقائق. انتبه: أي خادم MCP تضيفه يرى بياناتك ويستطيع التصرّف نيابةً عنك. شغّل ما تعرف مصدره، وابدأ بأقل الأدوات.

3أقسام

1أمثلة برمجية

2جداول

5أوامر

355كلمة من المصدر

الوصف الرسمي في سطر

One-command import of a Claude Code (~/.claude) or OpenAI Codex CLI (~/.codex) setup into Hermes — instructions, allowlists, MCP servers, skills, and memories.

ماذا ستستطيع بعدها

نتائج مأخوذة من هذه الصفحة، لا من قالب.

تعرف ما MCP ولماذا قد تحتاجه.
تنفّذ hermes import-agent claude-code وhermes claw migrate وتفهم ما يحدث بعدها.
تقرأ الجدول وتأخذ منه السطر الذي يخصّك فقط.

ما ستقابله من أسماء

كما تظهر تمامًا داخل Hermes.

الأوامر

hermes import-agent claude-code
hermes claw migrate
hermes import-agent
hermes import-agent codex
hermes setup

خريطة الصفحة

الصفحة الرسمية كاملة

بلا اختصار أو حذف.

النص أدناه منقول من المصدر الرسمي بالإنجليزية حتى تبقى الأوامر والأسماء دقيقة كما هي. قبل كل قسم شرح عربي يوضّح ما بداخله.

hermes import-agent imports your existing Claude Code or OpenAI Codex CLI setup into Hermes with one command. It follows the same preview-first pattern as hermes claw migrate: you always see a per-item plan before anything is written, and --dry-run never touches disk.

Shell6 أسطر

hermes import-agent                    # auto-detect ~/.claude or ~/.codex
hermes import-agent claude-code        # import from ~/.claude
hermes import-agent codex              # import from ~/.codex
hermes import-agent claude-code --dry-run          # preview only
hermes import-agent codex --source /path/to/.codex # custom location
hermes import-agent claude-code --overwrite --yes  # replace conflicts, skip prompts

What gets imported

جدول مرجعي. لا تقرأه كله، ابحث عن السطر الذي يخصّك فقط.

Claude Code (`~/.claude`)

Claude Code	Hermes
`CLAUDE.md` (global instructions)	Memory entries in `~/.hermes/memories/MEMORY.md`
`settings.json` → `permissions.allow` (`Bash(...)` rules)	`command_allowlist` in `config.yaml`
`settings.json` → `permissions.deny` (`Bash(...)` rules)	`approvals.deny` in `config.yaml`
`mcpServers` (from `~/.claude.json` and `settings.json`)	`mcp_servers` in `config.yaml`
`skills/<name>/` (dirs with `SKILL.md`)	`~/.hermes/skills/claude-code-imports/<name>/`
`commands/*.md` (slash commands)	Skipped with a note — convert them into skills

Claude's Bash(npm run test:*) prefix rules become npm run test* globs. Non-Bash permission rules (Read(...), WebFetch, ...) gate Claude-specific tools and are reported as unmapped rather than imported.

Codex CLI (`~/.codex`)

Codex CLI	Hermes
`AGENTS.md` (global instructions)	Memory entries in `~/.hermes/memories/MEMORY.md`
`config.toml` → `[mcp_servers.*]`	`mcp_servers` in `config.yaml`
`memories/*.md`	Memory entries in `~/.hermes/memories/MEMORY.md`
`skills/<name>/` (dirs with `SKILL.md`)	`~/.hermes/skills/codex-imports/<name>/`

What is never imported

أوامر تكتبها في الطرفية. افهم ما يفعله الأمر قبل نسخه. الأوامر هنا: hermes setup.

API keys and credentials. Credential files (~/.claude/.credentials.json, ~/.codex/auth.json) are never read, and MCP server environment variables or headers with secret-looking names (*_TOKEN, *_API_KEY, Authorization, ...) are stripped and listed in the report so you can re-add them deliberately. Run hermes setup to configure providers, or add secrets to ~/.hermes/.env.

Behavior notes

أوامر تكتبها في الطرفية. افهم ما يفعله الأمر قبل نسخه. الأوامر هنا: hermes claw migrate.

Preview first, always. The command prints the full plan before applying; in non-interactive sessions it stops at the preview unless you pass --yes.
Merges, not replaces. Memory entries are deduplicated against your existing MEMORY.md; allowlist/denylist patterns merge with what's already in config.yaml.
Conflicts are skipped by default. An MCP server or skill that already exists in Hermes is reported as a conflict; pass --overwrite to replace it.
Malformed files don't abort the run. A broken settings.json or config.toml becomes a per-item error in the report while everything else still imports.
Coming from OpenClaw instead? Use hermes claw migrate.

ما هذه الصفحة، وماذا تحتوي.

نتائج مأخوذة من هذه الصفحة، لا من قالب.

كما تظهر تمامًا داخل Hermes.

انتقل مباشرة إلى ما تحتاجه.

بلا اختصار أو حذف.

Claude Code (~/.claude)

Codex CLI (~/.codex)

4 أسئلة إجاباتها كلها في هذه الصفحة.

صفحات ترتبط بهذه.

Claude Code (`~/.claude`)

Codex CLI (`~/.codex`)