[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7D7PBZ80E3QD3FEC98SSHD9":3,"skill-same:01M7D7PBZ80E3QD3FEC98SSHD9":75},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":47,"commitSha":48,"skillDirectory":49,"forksCount":14,"repositoryHtmlUrl":50,"repositoryHomepageUrl":6,"ownerHtmlUrl":51,"ownerBlogUrl":52,"ownerDescription":53,"updatedAt":54,"install":55,"resources":68},"01M7D7PBZ80E3QD3FEC98SSHD9","telephony",null,"Give Hermes phone capabilities without core tool changes. Provision and persist a Twilio number, send and receive SMS\u002FMMS, make direct calls, and place AI-driven outbound calls through Bland.ai or Vapi.","GrupoANDevelopment-m\u002Falberto-ai","GrupoANDevelopment-m","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F257455179?v=4","01M7D69X2N2KEVN0SJF6WGM6SH","Antônio  Ndombe","01M7D69X3P5JTT8H8S904N3888",0,"MIT","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fskills\u002Foptional\u002Fproductivity\u002Ftelephony\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: telephony\ndescription: Give Hermes phone capabilities without core tool changes. Provision and persist a Twilio number, send and receive SMS\u002FMMS, make direct calls, and place AI-driven outbound calls through Bland.ai or Vapi.\nversion: 1.0.0\nauthor: Nous Research\nlicense: MIT\nplatforms: [linux, macos, windows]\nmetadata:\n  hermes:\n    tags: [telephony, phone, sms, mms, voice, twilio, bland.ai, vapi, calling, texting]\n    related_skills: [maps, google-workspace, agentmail]\n    category: productivity\n---\n\n# Telephony — Numbers, Calls, and Texts without Core Tool Changes\n\nThis optional skill gives Hermes practical phone capabilities while keeping telephony out of the core tool list.\n\nIt ships with a helper script, `scripts\u002Ftelephony.py`, that can:\n- save provider credentials into `${HERMES_HOME:-~\u002F.hermes}\u002F.env`\n- search for and buy a Twilio phone number\n- remember that owned number for later sessions\n- send SMS \u002F MMS from the owned number\n- poll inbound SMS for that number with no webhook server required\n- make direct Twilio calls using TwiML `\u003CSay>` or `\u003CPlay>`\n- import the owned Twilio number into Vapi\n- place outbound AI calls through Bland.ai or Vapi\n\n## What this solves\n\nThis skill is meant to cover the practical phone tasks users actually want:\n- outbound calls\n- texting\n- owning a reusable agent number\n- checking messages that arrive to that number later\n- preserving that number and related IDs between sessions\n- future-friendly telephony identity for inbound SMS polling and other automations\n\nIt does **not** turn Hermes into a real-time inbound phone gateway. Inbound SMS is handled by polling the Twilio REST API. That is enough for many workflows, including notifications and some one-time-code retrieval, without adding core webhook infrastructure.\n\n## Safety rules — mandatory\n\n1. Always confirm before placing a call or sending a text.\n2. Never dial emergency numbers.\n3. Never use telephony for harassment, spam, impersonation, or anything illegal.\n4. Treat third-party phone numbers as sensitive operational data:\n   - do not save them to Hermes memory\n   - do not include them in skill docs, summaries, or follow-up notes unless the user explicitly wants that\n5. It is fine to persist the **agent-owned Twilio number** because that is part of the user's configuration.\n6. VoIP numbers are **not guaranteed** to work for all third-party 2FA flows. Use with caution and set user expectations clearly.\n\n## Decision tree — which service to use?\n\nUse this logic instead of hardcoded provider routing:\n\n### 1) \"I want Hermes to own a real phone number\"\nUse **Twilio**.\n\nWhy:\n- easiest path to buying and keeping a number\n- best SMS \u002F MMS support\n- simplest inbound SMS polling story\n- cleanest future path to inbound webhooks or call handling\n\nUse cases:\n- receive texts later\n- send deployment alerts \u002F cron notifications\n- maintain a reusable phone identity for the agent\n- experiment with phone-based auth flows later\n\n### 2) \"I only need the easiest outbound AI phone call right now\"\nUse **Bland.ai**.\n\nWhy:\n- quickest setup\n- one API key\n- no need to first buy\u002Fimport a number yourself\n\nTradeoff:\n- less flexible\n- voice quality is decent, but not the best\n\n### 3) \"I want the best conversational AI voice quality\"\nUse **Twilio + Vapi**.\n\nWhy:\n- Twilio gives you the owned number\n- Vapi gives you better conversational AI call quality and more voice\u002Fmodel flexibility\n\nRecommended flow:\n1. Buy\u002Fsave a Twilio number\n2. Import it into Vapi\n3. Save the returned `VAPI_PHONE_NUMBER_ID`\n4. Use `ai-call --provider vapi`\n\n### 4) \"I want to call with a custom prerecorded voice message\"\nUse **Twilio direct call** with a public audio URL.\n\nWhy:\n- easiest way to play a custom MP3\n- pairs well with Hermes `text_to_speech` plus a public file host or tunnel\n\n## Files and persistent state\n\nThe skill persists telephony state in two places:\n\n### `${HERMES_HOME:-~\u002F.hermes}\u002F.env`\nUsed for long-lived provider credentials and owned-number IDs, for example:\n- `TWILIO_ACCOUNT_SID`\n- `TWILIO_AUTH_TOKEN`\n- `TWILIO_PHONE_NUMBER`\n- `TWILIO_PHONE_NUMBER_SID`\n- `BLAND_API_KEY`\n- `VAPI_API_KEY`\n- `VAPI_PHONE_NUMBER_ID`\n- `PHONE_PROVIDER` (AI call provider: bland or vapi)\n\n### `~\u002F.hermes\u002Ftelephony_state.json`\nUsed for skill-only state that should survive across sessions, for example:\n- remembered default Twilio number \u002F SID\n- remembered Vapi phone number ID\n- last inbound message SID\u002Fdate for inbox polling checkpoints\n\nThis means:\n- the next time the skill is loaded, `diagnose` can tell you what number is already configured\n- `twilio-inbox --since-last --mark-seen` can continue from the previous checkpoint\n\n## Locate the helper script\n\nAfter installing this skill, locate the script like this:\n\n```bash\nSCRIPT=\"$(find ~\u002F.hermes\u002Fskills -path '*\u002Ftelephony\u002Fscripts\u002Ftelephony.py' -print -quit)\"\n```\n\nIf `SCRIPT` is empty, the skill is not installed yet.\n\n## Install\n\nThis is an official optional skill, so install it from the Skills Hub:\n\n```bash\nhermes skills search telephony\nhermes skills install official\u002Fproductivity\u002Ftelephony\n```\n\n## Provider setup\n\n### Twilio — owned number, SMS\u002FMMS, direct calls, inbound SMS polling\n\nSign up at:\n- https:\u002F\u002Fwww.twilio.com\u002Ftry-twilio\n\nThen save credentials into Hermes:\n\n```bash\npython3 \"$SCRIPT\" save-twilio ACXXXXXXXXXXXXXXXXXXXXXXXXXXXX your_auth_token_here\n```\n\nSearch for available numbers:\n\n```bash\npython3 \"$SCRIPT\" twilio-search --country US --area-code 702 --limit 5\n```\n\nBuy and remember a number:\n\n```bash\npython3 \"$SCRIPT\" twilio-buy \"+17025551234\" --save-env\n```\n\nList owned numbers:\n\n```bash\npython3 \"$SCRIPT\" twilio-owned\n```\n\nSet one of them as the default later:\n\n```bash\npython3 \"$SCRIPT\" twilio-set-default \"+17025551234\" --save-env\n# or\npython3 \"$SCRIPT\" twilio-set-default PNXXXXXXXXXXXXXXXXXXXXXXXXXXXX --save-env\n```\n\n### Bland.ai — easiest outbound AI calling\n\nSign up at:\n- https:\u002F\u002Fapp.bland.ai\n\nSave config:\n\n```bash\npython3 \"$SCRIPT\" save-bland your_bland_api_key --voice mason\n```\n\n### Vapi — better conversational voice quality\n\nSign up at:\n- https:\u002F\u002Fdashboard.vapi.ai\n\nSave the API key first:\n\n```bash\npython3 \"$SCRIPT\" save-vapi your_vapi_api_key\n```\n\nImport your owned Twilio number into Vapi and persist the returned phone number ID:\n\n```bash\npython3 \"$SCRIPT\" vapi-import-twilio --save-env\n```\n\nIf you already know the Vapi phone number ID, save it directly:\n\n```bash\npython3 \"$SCRIPT\" save-vapi your_vapi_api_key --phone-number-id vapi_phone_number_id_here\n```\n\n## Diagnose current state\n\nAt any time, inspect what the skill already knows:\n\n```bash\npython3 \"$SCRIPT\" diagnose\n```\n\nUse this first when resuming work in a later session.\n\n## Common workflows\n\n### A. Buy an agent number and keep using it later\n\n1. Save Twilio credentials:\n```bash\npython3 \"$SCRIPT\" save-twilio AC... auth_token_here\n```\n\n2. Search for a number:\n```bash\npython3 \"$SCRIPT\" twilio-search --country US --area-code 702 --limit 10\n```\n\n3. Buy it and save it into `${HERMES_HOME:-~\u002F.hermes}\u002F.env` + state:\n```bash\npython3 \"$SCRIPT\" twilio-buy \"+17025551234\" --save-env\n```\n\n4. Next session, run:\n```bash\npython3 \"$SCRIPT\" diagnose\n```\nThis shows the remembered default number and inbox checkpoint state.\n\n### B. Send a text from the agent number\n\n```bash\npython3 \"$SCRIPT\" twilio-send-sms \"+15551230000\" \"Your deployment completed successfully.\"\n```\n\nWith media:\n\n```bash\npython3 \"$SCRIPT\" twilio-send-sms \"+15551230000\" \"Here is the chart.\" --media-url \"https:\u002F\u002Fexample.com\u002Fchart.png\"\n```\n\n### C. Check inbound texts later with no webhook server\n\nPoll the inbox for the default Twilio number:\n\n```bash\npython3 \"$SCRIPT\" twilio-inbox --limit 20\n```\n\nOnly show messages that arrived after the last checkpoint, and advance the checkpoint when you're done reading:\n\n```bash\npython3 \"$SCRIPT\" twilio-inbox --since-last --mark-seen\n```\n\nThis is the main answer to “how do I access messages the number receives next time the skill is loaded?”\n\n### D. Make a direct Twilio call with built-in TTS\n\n```bash\npython3 \"$SCRIPT\" twilio-call \"+15551230000\" --message \"Hello! This is Hermes calling with your status update.\" --voice Polly.Joanna\n```\n\n### E. Call with a prerecorded \u002F custom voice message\n\nThis is the main path for reusing Hermes's existing `text_to_speech` support.\n\nUse this when:\n- you want the call to use Hermes's configured TTS voice rather than Twilio `\u003CSay>`\n- you want a one-way voice delivery (briefing, alert, joke, reminder, status update)\n- you do **not** need a live conversational phone call\n\nGenerate or host audio separately, then:\n\n```bash\npython3 \"$SCRIPT\" twilio-call \"+155****0000\" --audio-url \"https:\u002F\u002Fexample.com\u002Fbriefing.mp3\"\n```\n\nRecommended Hermes TTS -> Twilio Play workflow:\n\n1. Generate the audio with Hermes `text_to_speech`.\n2. Make the resulting MP3 publicly reachable.\n3. Place the Twilio call with `--audio-url`.\n\nExample agent flow:\n- Ask Hermes to create the message audio with `text_to_speech`\n- If needed, expose the file with a temporary static host \u002F tunnel \u002F object storage URL\n- Use `twilio-call --audio-url ...` to deliver it by phone\n\nGood hosting options for the MP3:\n- a temporary public object\u002Fstorage URL\n- a short-lived tunnel to a local static file server\n- any existing HTTPS URL the phone provider can fetch directly\n\nImportant note:\n- Hermes TTS is great for prerecorded outbound messages\n- Bland\u002FVapi are better for **live conversational AI calls** because they handle the real-time telephony audio stack themselves\n- Hermes STT\u002FTTS alone is not being used here as a full duplex phone conversation engine; that would require a much heavier streaming\u002Fwebhook integration than this skill is trying to introduce\n\n### F. Navigate a phone tree \u002F IVR with Twilio direct calling\n\nIf you need to press digits after the call connects, use `--send-digits`.\nTwilio interprets `w` as a short wait.\n\n```bash\npython3 \"$SCRIPT\" twilio-call \"+18005551234\" --message \"Connecting to billing now.\" --send-digits \"ww1w2w3\"\n```\n\nThis is useful for reaching a specific menu branch before handing off to a human or delivering a short status message.\n\n### G. Outbound AI phone call with Bland.ai\n\n```bash\npython3 \"$SCRIPT\" ai-call \"+15551230000\" \"Call the dental office, ask for a cleaning appointment on Tuesday afternoon, and if they do not have Tuesday availability, ask for Wednesday or Thursday instead.\" --provider bland --voice mason --max-duration 3\n```\n\nCheck status:\n\n```bash\npython3 \"$SCRIPT\" ai-status \u003Ccall_id> --provider bland\n```\n\nAsk Bland analysis questions after completion:\n\n```bash\npython3 \"$SCRIPT\" ai-status \u003Ccall_id> --provider bland --analyze \"Was the appointment confirmed?,What date and time?,Any special instructions?\"\n```\n\n### H. Outbound AI phone call with Vapi on your owned number\n\n1. Import your Twilio number into Vapi:\n```bash\npython3 \"$SCRIPT\" vapi-import-twilio --save-env\n```\n\n2. Place the call:\n```bash\npython3 \"$SCRIPT\" ai-call \"+15551230000\" \"You are calling to make a dinner reservation for two at 7:30 PM. If that is unavailable, ask for the nearest time between 6:30 and 8:30 PM.\" --provider vapi --max-duration 4\n```\n\n3. Check result:\n```bash\npython3 \"$SCRIPT\" ai-status \u003Ccall_id> --provider vapi\n```\n\n## Suggested agent procedure\n\nWhen the user asks for a call or text:\n\n1. Determine which path fits the request via the decision tree.\n2. Run `diagnose` if configuration state is unclear.\n3. Gather the full task details.\n4. Confirm with the user before dialing or texting.\n5. Use the correct command.\n6. Poll for results if needed.\n7. Summarize the outcome without persisting third-party numbers to Hermes memory.\n\n## What this skill still does not do\n\n- real-time inbound call answering\n- webhook-based live SMS push into the agent loop\n- guaranteed support for arbitrary third-party 2FA providers\n\nThose would require more infrastructure than a pure optional skill.\n\n## Pitfalls\n\n- Twilio trial accounts and regional rules can restrict who you can call\u002Ftext.\n- Some services reject VoIP numbers for 2FA.\n- `twilio-inbox` polls the REST API; it is not instant push delivery.\n- Vapi outbound calling still depends on having a valid imported number.\n- Bland is easiest, but not always the best-sounding.\n- Do not store arbitrary third-party phone numbers in Hermes memory.\n\n## Verification checklist\n\nAfter setup, you should be able to do all of the following with just this skill:\n\n1. `diagnose` shows provider readiness and remembered state\n2. search and buy a Twilio number\n3. persist that number to `${HERMES_HOME:-~\u002F.hermes}\u002F.env`\n4. send an SMS from the owned number\n5. poll inbound texts for the owned number later\n6. place a direct Twilio call\n7. place an AI call via Bland or Vapi\n\n## References\n\n- Twilio phone numbers: https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fphone-numbers\u002Fapi\n- Twilio messaging: https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fmessaging\u002Fapi\u002Fmessage-resource\n- Twilio voice: https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fvoice\u002Fapi\u002Fcall-resource\n- Vapi docs: https:\u002F\u002Fdocs.vapi.ai\u002F\n- Bland.ai: https:\u002F\u002Fapp.bland.ai\u002F\n","# Telephony — Numbers, Calls, and Texts without Core Tool Changes\n\nThis optional skill gives Hermes practical phone capabilities while keeping telephony out of the core tool list.\n\nIt ships with a helper script, `scripts\u002Ftelephony.py`, that can:\n- save provider credentials into `${HERMES_HOME:-~\u002F.hermes}\u002F.env`\n- search for and buy a Twilio phone number\n- remember that owned number for later sessions\n- send SMS \u002F MMS from the owned number\n- poll inbound SMS for that number with no webhook server required\n- make direct Twilio calls using TwiML `\u003CSay>` or `\u003CPlay>`\n- import the owned Twilio number into Vapi\n- place outbound AI calls through Bland.ai or Vapi\n\n## What this solves\n\nThis skill is meant to cover the practical phone tasks users actually want:\n- outbound calls\n- texting\n- owning a reusable agent number\n- checking messages that arrive to that number later\n- preserving that number and related IDs between sessions\n- future-friendly telephony identity for inbound SMS polling and other automations\n\nIt does **not** turn Hermes into a real-time inbound phone gateway. Inbound SMS is handled by polling the Twilio REST API. That is enough for many workflows, including notifications and some one-time-code retrieval, without adding core webhook infrastructure.\n\n## Safety rules — mandatory\n\n1. Always confirm before placing a call or sending a text.\n2. Never dial emergency numbers.\n3. Never use telephony for harassment, spam, impersonation, or anything illegal.\n4. Treat third-party phone numbers as sensitive operational data:\n   - do not save them to Hermes memory\n   - do not include them in skill docs, summaries, or follow-up notes unless the user explicitly wants that\n5. It is fine to persist the **agent-owned Twilio number** because that is part of the user's configuration.\n6. VoIP numbers are **not guaranteed** to work for all third-party 2FA flows. Use with caution and set user expectations clearly.\n\n## Decision tree — which service to use?\n\nUse this logic instead of hardcoded provider routing:\n\n### 1) \"I want Hermes to own a real phone number\"\nUse **Twilio**.\n\nWhy:\n- easiest path to buying and keeping a number\n- best SMS \u002F MMS support\n- simplest inbound SMS polling story\n- cleanest future path to inbound webhooks or call handling\n\nUse cases:\n- receive texts later\n- send deployment alerts \u002F cron notifications\n- maintain a reusable phone identity for the agent\n- experiment with phone-based auth flows later\n\n### 2) \"I only need the easiest outbound AI phone call right now\"\nUse **Bland.ai**.\n\nWhy:\n- quickest setup\n- one API key\n- no need to first buy\u002Fimport a number yourself\n\nTradeoff:\n- less flexible\n- voice quality is decent, but not the best\n\n### 3) \"I want the best conversational AI voice quality\"\nUse **Twilio + Vapi**.\n\nWhy:\n- Twilio gives you the owned number\n- Vapi gives you better conversational AI call quality and more voice\u002Fmodel flexibility\n\nRecommended flow:\n1. Buy\u002Fsave a Twilio number\n2. Import it into Vapi\n3. Save the returned `VAPI_PHONE_NUMBER_ID`\n4. Use `ai-call --provider vapi`\n\n### 4) \"I want to call with a custom prerecorded voice message\"\nUse **Twilio direct call** with a public audio URL.\n\nWhy:\n- easiest way to play a custom MP3\n- pairs well with Hermes `text_to_speech` plus a public file host or tunnel\n\n## Files and persistent state\n\nThe skill persists telephony state in two places:\n\n### `${HERMES_HOME:-~\u002F.hermes}\u002F.env`\nUsed for long-lived provider credentials and owned-number IDs, for example:\n- `TWILIO_ACCOUNT_SID`\n- `TWILIO_AUTH_TOKEN`\n- `TWILIO_PHONE_NUMBER`\n- `TWILIO_PHONE_NUMBER_SID`\n- `BLAND_API_KEY`\n- `VAPI_API_KEY`\n- `VAPI_PHONE_NUMBER_ID`\n- `PHONE_PROVIDER` (AI call provider: bland or vapi)\n\n### `~\u002F.hermes\u002Ftelephony_state.json`\nUsed for skill-only state that should survive across sessions, for example:\n- remembered default Twilio number \u002F SID\n- remembered Vapi phone number ID\n- last inbound message SID\u002Fdate for inbox polling checkpoints\n\nThis means:\n- the next time the skill is loaded, `diagnose` can tell you what number is already configured\n- `twilio-inbox --since-last --mark-seen` can continue from the previous checkpoint\n\n## Locate the helper script\n\nAfter installing this skill, locate the script like this:\n\n```bash\nSCRIPT=\"$(find ~\u002F.hermes\u002Fskills -path '*\u002Ftelephony\u002Fscripts\u002Ftelephony.py' -print -quit)\"\n```\n\nIf `SCRIPT` is empty, the skill is not installed yet.\n\n## Install\n\nThis is an official optional skill, so install it from the Skills Hub:\n\n```bash\nhermes skills search telephony\nhermes skills install official\u002Fproductivity\u002Ftelephony\n```\n\n## Provider setup\n\n### Twilio — owned number, SMS\u002FMMS, direct calls, inbound SMS polling\n\nSign up at:\n- https:\u002F\u002Fwww.twilio.com\u002Ftry-twilio\n\nThen save credentials into Hermes:\n\n```bash\npython3 \"$SCRIPT\" save-twilio ACXXXXXXXXXXXXXXXXXXXXXXXXXXXX your_auth_token_here\n```\n\nSearch for available numbers:\n\n```bash\npython3 \"$SCRIPT\" twilio-search --country US --area-code 702 --limit 5\n```\n\nBuy and remember a number:\n\n```bash\npython3 \"$SCRIPT\" twilio-buy \"+17025551234\" --save-env\n```\n\nList owned numbers:\n\n```bash\npython3 \"$SCRIPT\" twilio-owned\n```\n\nSet one of them as the default later:\n\n```bash\npython3 \"$SCRIPT\" twilio-set-default \"+17025551234\" --save-env\n# or\npython3 \"$SCRIPT\" twilio-set-default PNXXXXXXXXXXXXXXXXXXXXXXXXXXXX --save-env\n```\n\n### Bland.ai — easiest outbound AI calling\n\nSign up at:\n- https:\u002F\u002Fapp.bland.ai\n\nSave config:\n\n```bash\npython3 \"$SCRIPT\" save-bland your_bland_api_key --voice mason\n```\n\n### Vapi — better conversational voice quality\n\nSign up at:\n- https:\u002F\u002Fdashboard.vapi.ai\n\nSave the API key first:\n\n```bash\npython3 \"$SCRIPT\" save-vapi your_vapi_api_key\n```\n\nImport your owned Twilio number into Vapi and persist the returned phone number ID:\n\n```bash\npython3 \"$SCRIPT\" vapi-import-twilio --save-env\n```\n\nIf you already know the Vapi phone number ID, save it directly:\n\n```bash\npython3 \"$SCRIPT\" save-vapi your_vapi_api_key --phone-number-id vapi_phone_number_id_here\n```\n\n## Diagnose current state\n\nAt any time, inspect what the skill already knows:\n\n```bash\npython3 \"$SCRIPT\" diagnose\n```\n\nUse this first when resuming work in a later session.\n\n## Common workflows\n\n### A. Buy an agent number and keep using it later\n\n1. Save Twilio credentials:\n```bash\npython3 \"$SCRIPT\" save-twilio AC... auth_token_here\n```\n\n2. Search for a number:\n```bash\npython3 \"$SCRIPT\" twilio-search --country US --area-code 702 --limit 10\n```\n\n3. Buy it and save it into `${HERMES_HOME:-~\u002F.hermes}\u002F.env` + state:\n```bash\npython3 \"$SCRIPT\" twilio-buy \"+17025551234\" --save-env\n```\n\n4. Next session, run:\n```bash\npython3 \"$SCRIPT\" diagnose\n```\nThis shows the remembered default number and inbox checkpoint state.\n\n### B. Send a text from the agent number\n\n```bash\npython3 \"$SCRIPT\" twilio-send-sms \"+15551230000\" \"Your deployment completed successfully.\"\n```\n\nWith media:\n\n```bash\npython3 \"$SCRIPT\" twilio-send-sms \"+15551230000\" \"Here is the chart.\" --media-url \"https:\u002F\u002Fexample.com\u002Fchart.png\"\n```\n\n### C. Check inbound texts later with no webhook server\n\nPoll the inbox for the default Twilio number:\n\n```bash\npython3 \"$SCRIPT\" twilio-inbox --limit 20\n```\n\nOnly show messages that arrived after the last checkpoint, and advance the checkpoint when you're done reading:\n\n```bash\npython3 \"$SCRIPT\" twilio-inbox --since-last --mark-seen\n```\n\nThis is the main answer to “how do I access messages the number receives next time the skill is loaded?”\n\n### D. Make a direct Twilio call with built-in TTS\n\n```bash\npython3 \"$SCRIPT\" twilio-call \"+15551230000\" --message \"Hello! This is Hermes calling with your status update.\" --voice Polly.Joanna\n```\n\n### E. Call with a prerecorded \u002F custom voice message\n\nThis is the main path for reusing Hermes's existing `text_to_speech` support.\n\nUse this when:\n- you want the call to use Hermes's configured TTS voice rather than Twilio `\u003CSay>`\n- you want a one-way voice delivery (briefing, alert, joke, reminder, status update)\n- you do **not** need a live conversational phone call\n\nGenerate or host audio separately, then:\n\n```bash\npython3 \"$SCRIPT\" twilio-call \"+155****0000\" --audio-url \"https:\u002F\u002Fexample.com\u002Fbriefing.mp3\"\n```\n\nRecommended Hermes TTS -> Twilio Play workflow:\n\n1. Generate the audio with Hermes `text_to_speech`.\n2. Make the resulting MP3 publicly reachable.\n3. Place the Twilio call with `--audio-url`.\n\nExample agent flow:\n- Ask Hermes to create the message audio with `text_to_speech`\n- If needed, expose the file with a temporary static host \u002F tunnel \u002F object storage URL\n- Use `twilio-call --audio-url ...` to deliver it by phone\n\nGood hosting options for the MP3:\n- a temporary public object\u002Fstorage URL\n- a short-lived tunnel to a local static file server\n- any existing HTTPS URL the phone provider can fetch directly\n\nImportant note:\n- Hermes TTS is great for prerecorded outbound messages\n- Bland\u002FVapi are better for **live conversational AI calls** because they handle the real-time telephony audio stack themselves\n- Hermes STT\u002FTTS alone is not being used here as a full duplex phone conversation engine; that would require a much heavier streaming\u002Fwebhook integration than this skill is trying to introduce\n\n### F. Navigate a phone tree \u002F IVR with Twilio direct calling\n\nIf you need to press digits after the call connects, use `--send-digits`.\nTwilio interprets `w` as a short wait.\n\n```bash\npython3 \"$SCRIPT\" twilio-call \"+18005551234\" --message \"Connecting to billing now.\" --send-digits \"ww1w2w3\"\n```\n\nThis is useful for reaching a specific menu branch before handing off to a human or delivering a short status message.\n\n### G. Outbound AI phone call with Bland.ai\n\n```bash\npython3 \"$SCRIPT\" ai-call \"+15551230000\" \"Call the dental office, ask for a cleaning appointment on Tuesday afternoon, and if they do not have Tuesday availability, ask for Wednesday or Thursday instead.\" --provider bland --voice mason --max-duration 3\n```\n\nCheck status:\n\n```bash\npython3 \"$SCRIPT\" ai-status \u003Ccall_id> --provider bland\n```\n\nAsk Bland analysis questions after completion:\n\n```bash\npython3 \"$SCRIPT\" ai-status \u003Ccall_id> --provider bland --analyze \"Was the appointment confirmed?,What date and time?,Any special instructions?\"\n```\n\n### H. Outbound AI phone call with Vapi on your owned number\n\n1. Import your Twilio number into Vapi:\n```bash\npython3 \"$SCRIPT\" vapi-import-twilio --save-env\n```\n\n2. Place the call:\n```bash\npython3 \"$SCRIPT\" ai-call \"+15551230000\" \"You are calling to make a dinner reservation for two at 7:30 PM. If that is unavailable, ask for the nearest time between 6:30 and 8:30 PM.\" --provider vapi --max-duration 4\n```\n\n3. Check result:\n```bash\npython3 \"$SCRIPT\" ai-status \u003Ccall_id> --provider vapi\n```\n\n## Suggested agent procedure\n\nWhen the user asks for a call or text:\n\n1. Determine which path fits the request via the decision tree.\n2. Run `diagnose` if configuration state is unclear.\n3. Gather the full task details.\n4. Confirm with the user before dialing or texting.\n5. Use the correct command.\n6. Poll for results if needed.\n7. Summarize the outcome without persisting third-party numbers to Hermes memory.\n\n## What this skill still does not do\n\n- real-time inbound call answering\n- webhook-based live SMS push into the agent loop\n- guaranteed support for arbitrary third-party 2FA providers\n\nThose would require more infrastructure than a pure optional skill.\n\n## Pitfalls\n\n- Twilio trial accounts and regional rules can restrict who you can call\u002Ftext.\n- Some services reject VoIP numbers for 2FA.\n- `twilio-inbox` polls the REST API; it is not instant push delivery.\n- Vapi outbound calling still depends on having a valid imported number.\n- Bland is easiest, but not always the best-sounding.\n- Do not store arbitrary third-party phone numbers in Hermes memory.\n\n## Verification checklist\n\nAfter setup, you should be able to do all of the following with just this skill:\n\n1. `diagnose` shows provider readiness and remembered state\n2. search and buy a Twilio number\n3. persist that number to `${HERMES_HOME:-~\u002F.hermes}\u002F.env`\n4. send an SMS from the owned number\n5. poll inbound texts for the owned number later\n6. place a direct Twilio call\n7. place an AI call via Bland or Vapi\n\n## References\n\n- Twilio phone numbers: https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fphone-numbers\u002Fapi\n- Twilio messaging: https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fmessaging\u002Fapi\u002Fmessage-resource\n- Twilio voice: https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fvoice\u002Fapi\u002Fcall-resource\n- Vapi docs: https:\u002F\u002Fdocs.vapi.ai\u002F\n- Bland.ai: https:\u002F\u002Fapp.bland.ai\u002F\n",{"name":5,"author":24,"license":15,"version":25,"metadata":26,"platforms":43,"description":7},"Nous Research","1.0.0",{"hermes":27},{"tags":28,"category":38,"related_skills":39},[5,29,30,31,32,33,34,35,36,37],"phone","sms","mms","voice","twilio","bland.ai","vapi","calling","texting","productivity",[40,41,42],"maps","google-workspace","agentmail",[44,45,46],"linux","macos","windows","main","eac438ea9216a7cb8a570cab803eb01eeafc6793","skills\u002Foptional\u002Fproductivity\u002Ftelephony","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m","https:\u002F\u002Fid-preview--d5bef06d-6c9e-4563-a3d4-a855b9d61610.lovable.app\u002F","Eu sou Antonio B. B. Ndombe \r\nEu sou um Pesquisador e desenvolvedor de sistema autonomia cognitivos, fundador de sistemas ODCs ( organismos digital conscientes)","2026-11-04 06:53:39",{"source":8,"skillName":5,"commands":56,"prompt":66,"zipAvailable":67},[57,60,63],{"tool":58,"command":59},"npx","npx skills add GrupoANDevelopment-m\u002Falberto-ai --skill telephony",{"tool":61,"command":62},"bunx","bunx skills add GrupoANDevelopment-m\u002Falberto-ai --skill telephony",{"tool":64,"command":65},"pnpm","pnpm dlx skills add GrupoANDevelopment-m\u002Falberto-ai --skill telephony","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fskills\u002Foptional\u002Fproductivity\u002Ftelephony\u002FSKILL.md",true,[69],{"path":70,"resourceType":71,"resourceTypeDesc":72,"sizeBytes":73,"sourceHtmlUrl":74},"scripts\u002Ftelephony.py","SCRIPT","脚本",46410,"https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fskills\u002Foptional\u002Fproductivity\u002Ftelephony\u002Fscripts\u002Ftelephony.py",[76,84,91,98,105,112],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7DASC6FSCJP49JZBSK0NY1Z","nemoclaw-user-reference","Describes the NemoClaw integration layer and blueprint architecture and how they orchestrate compatible agent sandboxes. Use when looking up architecture, agent integration, plugin structure, or blueprint design. Trigger keywords - nemoclaw architecture, nemoclaw agent architecture, nemoclaw plugin blueprint structure, nemoclaw vs openshell, which cli, nemoclaw cli, openshell cli, sandbox commands, nemoclaw cli commands, nemoclaw command reference, nemoclaw network policy, sandbox egress control operator approval, nemoclaw troubleshooting, nemoclaw debug sandbox issues.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fupstream\u002Fnemoclaw\u002Fskills\u002Fnemoclaw-user-reference\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7DAS5S79VK33XFGVAM2TFWF","nemoclaw-user-overview","Explains how OpenClaw, OpenShell, and NemoClaw form the ecosystem, NemoClaw's position in the stack, what NemoClaw adds beyond the community sandbox, and when to prefer NemoClaw versus integrating OpenShell and OpenClaw directly. Use when users ask about the relationship between OpenClaw, OpenShell, and NemoClaw, or when to use NemoClaw versus OpenShell. Trigger keywords - nemoclaw ecosystem, openclaw openshell, nemoclaw vs openshell, sandboxed openclaw, how nemoclaw works, nemoclaw sandbox lifecycle blueprint, nemoclaw overview, openclaw always-on assistants, nvidia openshell, nvidia nemotron, nemoclaw release notes, nemoclaw changelog.","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fupstream\u002Fnemoclaw\u002Fskills\u002Fnemoclaw-user-overview\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M7DAS0PQEMET5MNGZ1ABSZVS","nemoclaw-user-monitor-sandbox","Inspects sandbox health, traces agent behavior, and diagnoses problems. Use when monitoring a running sandbox, debugging agent issues, or checking sandbox logs. Trigger keywords - monitor nemoclaw sandbox, debug nemoclaw agent issues.","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fupstream\u002Fnemoclaw\u002Fskills\u002Fnemoclaw-user-monitor-sandbox\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":19},"01M7DARQYGF7E9A69VH6S3CGN9","nemoclaw-user-manage-sandboxes","Explains operational tasks after the quickstart: listing sandboxes, status and health checks, logs, diagnostics, port forwards, multiple sandboxes, credential reset, rebuilds, network presets, upgrades, and uninstall. Trigger keywords - manage nemoclaw sandboxes, nemoclaw status, nemoclaw list, nemoclaw dashboard port, nemoclaw rebuild, nemoclaw upgrade sandboxes, nemoclaw uninstall, sandbox mutability, sandbox runtime configuration, sandbox rebuild, nemoclaw backup, nemoclaw restore, workspace backup, openshell sandbox download upload, nemoclaw messaging channels, nemoclaw telegram, nemoclaw discord, nemoclaw slack, nemoclaw wechat, nemoclaw whatsapp, openshell channel messaging, nemoclaw workspace files, soul.md, user.md, identity.md, agents.md, sandbox persistence.","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fupstream\u002Fnemoclaw\u002Fskills\u002Fnemoclaw-user-manage-sandboxes\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":19},"01M7DARH8BRTG51TRCAB7YWDJ4","nemoclaw-user-manage-policy","Adds, removes, or modifies allowed endpoints in the sandbox policy. Use when customizing network policy, changing egress rules, or configuring sandbox endpoint access. Trigger keywords - customize nemoclaw network policy, sandbox egress policy configuration, nemoclaw integration policy examples, post-install policy setup, openshell approval workflow, policy preset, nemoclaw approve network requests, sandbox egress approval tui.","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fupstream\u002Fnemoclaw\u002Fskills\u002Fnemoclaw-user-manage-policy\u002FSKILL.md",[],[],{"skillNo":113,"name":114,"nameZh":6,"description":115,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":80,"licenseFileUrl":6,"sourceHtmlUrl":116,"categories":117,"keywords":118,"publishedAt":19},"01M7DARAT62M2VR37590VCZ5NS","nemoclaw-user-get-started","Installs NemoClaw, launches a sandbox, and runs the first agent prompt. Use when onboarding, installing, or launching a NemoClaw sandbox for the first time. Trigger keywords - nemoclaw quickstart, install nemoclaw openclaw sandbox, nemohermes quickstart, hermes agent nemoclaw, run hermes openshell sandbox, nemoclaw prerequisites, nemoclaw supported platforms, nemoclaw hardware software, nemoclaw windows wsl2 setup, nemoclaw install windows docker desktop.","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fupstream\u002Fnemoclaw\u002Fskills\u002Fnemoclaw-user-get-started\u002FSKILL.md",[],[]]